OpenTelemetry metrics and traces
WEBCON Portal and Service provide telemetry data in the OpenTelemetry standard – metrics and traces (spans), and Portal also provides logs. The data can be sent to any compatible tool, e.g. Prometheus, Grafana, Grafana Tempo, Jaeger or Azure Application Insights, and used to build reports and alerts.
The lists below cover the metrics and spans specific to WEBCON in version 2026 R1. Standard instrumentations (ASP.NET Core, HttpClient, SqlClient, WCF client, .NET process and runtime metrics) produce data according to the OpenTelemetry semantic conventions and are not described here.
Configuration
Starting with version 2026 R1, telemetry is configured in the appsettings.json file, separately in the Portal and Service installation folders, in the OpenTelemetry section. The otlpsettings.json file from earlier versions is no longer used.
"OpenTelemetry": {
"Metrics": {
"Enabled": false,
"Prometheus": { "Enabled": true, "Endpoint": "/metrics", "CacheDuration": 100 },
"Exporters": {}
},
"Tracing": {
"Enabled": false,
"ShowExceptions": true,
"HttpTracing": true,
"SqlTracing": { "Enabled": true, "ShowDbStatements": true },
"Exporters": {}
},
"Logs": { "Enabled": false, "Exporters": {} }
}
| Node | Meaning |
|---|
Metrics | Enables metric collection. When enabled, all available instrumentations run – they cannot be enabled separately. The Prometheus node exposes the metrics at the Endpoint address (/metrics by default). |
Tracing | Enables trace collection. SqlTracing > ShowDbStatements decides whether the text of SQL queries is recorded in traces. Traces then also contain the database connection string, with the password removed before recording. |
Logs | Enables the export of Portal logs over OTLP. The Service does not export logs. |
Exporters | The list of OTLP exporters for the given data type, e.g. "Otlp": { "Enabled": true, "Endpoint": "", "Headers": "", "Protocol": "http" }. |
For an exporter to work, both the exporter node and its parent node (Metrics, Tracing or Logs) must be set to "Enabled": true.
The connection to Azure Application Insights is configured outside the OpenTelemetry section, in the ApplicationInsights > ConnectionString node. Setting the connection string alone sends traces, metrics and logs to Application Insights regardless of the OpenTelemetry section settings.
The Service runs as several processes, and each of them exposes metrics at a separate address:
| Service process | Metrics address |
|---|
WebCon.WorkFlow.Bootstrapper | No default port – it can be set in the Kestrel node of the appsettings.production.json file. |
Webcon.WorkFlow.Module.ServiceModuleRunner | Port 48450, changed in the modulesettings.modulesOrchestration.Production.json file (serviceModuleRunnerPort node). |
Webcon.WorkFlow.Service | http://localhost:9464, changed in the modulesettings.service.Production.json file in the OldService folder. The new address must be registered for the account the Service runs under. |
Metrics
Collectors such as Prometheus replace hyphens in metric names with underscores and, depending on the metric type, add suffixes such as _total, _bucket, _sum or _count.
| Metric | Description |
|---|
webcon-workflow-portal-open | Number of times the Portal home page was opened in a browser (each new browser window). |
webcon-workflow-form-open | Number of times a workflow instance was opened in a browser. |
webcon-workflow-form-elements-cache | Number of workflow instance models held in the cache. A model is added when the form is opened and removed after a path transition. |
webcon-workflow-form-path-transitions | Number of all started path transitions, including failed ones. |
webcon-workflow-form-success-path-transitions | Number of successfully completed path transitions. |
webcon-workflow-form-path-transitions-in-progress | Number of path transitions in progress. A correct transition usually takes a few hundred milliseconds, so a rising value indicates system load. |
webcon-workflow-form-path-transition-times | Distribution (histogram) of path transition execution times. |
webcon-workflow-portal-ticket-store-cache | Number of objects in the user authentication ticket cache. |
webcon-workflow-portal-token-store-cache | Number of objects in the token cache. |
webcon-workflow-ocr-finereader-license-remaining-pages | Number of pages that can still be processed under the FineReader license. |
webcon-workflow-solr-elements-queue | Number of items added to the workflow instance indexing queue (SolrElementIndexer). |
webcon-workflow-solr-attachments-queue | Number of items added to the attachment indexing queue (SolrAttachmentIndexer). |
webcon-workflow-solr-activities-queue | Number of items added to the activity indexing queue (SolrActivityIndexer). |
webcon-workflow-solr-utilities-queue | Number of items added to the utility indexing queue (SolrUtilityIndexer). |
webcon-workflow-solr-elements-processed | Number of items removed from the workflow instance indexing queue after processing. |
webcon-workflow-solr-attachments-processed | Number of items removed from the attachment indexing queue after processing. |
webcon-workflow-solr-activities-processed | Number of items removed from the activity indexing queue after processing. |
webcon-workflow-solr-utilities-processed | Number of items removed from the utility indexing queue after processing. |
uda-endpoint-automation | Number of calls to User Defined API (UDA) endpoints that run automations. |
uda-endpoint-data-source | Number of calls to UDA data source endpoints. |
uda-endpoint-element-data | Number of calls to UDA endpoints that return workflow instance data. |
uda-endpoint-element-transition | Number of calls to UDA endpoints that move a workflow instance along a path, save it or start it. |
Traces (spans)
Starting with version 2026 R1, all Portal and Service traces include the db.id attribute – the content database ID. Span attributes are described in the Span attributes table.
Portal request handling
| Span | Description | Attributes |
|---|
| Create controller | Creating the controller that handles the request. | ControllerName |
| Controller endpoint action | Running the controller method that handles the request. | – |
| Bind model | Binding request data to the model. | – |
| Deserialize commands model | Reading the command model sent in the request (also at the authorization stage). | – |
| Input JSON Formatter - ReadAsync | Converting an input parameter from JSON to an object. | – |
| Output JSON Formatter - WriteAsync | Converting the result to JSON. | – |
| DetermineProviderCultureResult | Determining the user's language and its usage context. | – |
| Filters context | Running request filters (parent span for the individual stages). | – |
| Authorization filters | Request authorization stage. | – |
| RequireApplicationFilter | Checking access to the application at the authorization stage. | – |
| Resource filters | Resource stage. | – |
| Resource filters OnResourceExecuting | Resource stage before the request is handled. | – |
| Resource filters OnResourceExecuted | Resource stage after the request is handled. | – |
| Action filters | Action stage. | – |
| Action filters OnActionExecuting | Action stage before the request is handled. | – |
| Action filters OnActionExecuted | Action stage after the request is handled. | – |
| RequireReportViewFilter | Checking permissions to the report view. | – |
| Exception filters | Exception handling stage. | – |
| Result filters | Result stage. | – |
| Result filters OnResultExecuting | Result stage before the response is returned. | – |
| Result filters OnResultExecuted | Result stage after the response is returned. | – |
| Action result execution | Generating the result returned in response to the request. | – |
| HeartBeat | A single Portal heartbeat. | – |
| Span | Description | Attributes |
|---|
| GetElementFormAsync | Creating the model of a new or existing workflow instance (optionally based on the cache). | – |
| LoadExistingElementFormAsync | Creating a complete, up-to-date model of the workflow instance form. | – |
| LoadJsModelAsync | Creating the JS model of the workflow instance. | – |
| JS model build stage name | A stage of building the JS model of the workflow instance (stages listed below). | – |
| GetElementInfoAsync | Retrieving detailed information about the workflow instance. | – |
| GetDesktopAsync | Retrieving information about the workflow instance together with its status. | – |
| Apply business rules and set default values | Running business rules and setting default values. | – |
| UpdateFormFieldsAsync | Updating form field values. | – |
| FillEntityDataAsync | Retrieving data for a choice field. | Field ID, Field name, Data source ID |
| Get form field report data | Loading the data of an SQL report displayed in a form field. | ReportId |
| Item list command name | Passing a command to an item list (commands listed below). | – |
| MoveElementToNextStepAsync | Moving the workflow instance along a path (without saving). | Path id, Element id |
| Move to next step | Execution time of a path transition or a workflow instance save. | Path Id |
| FormsController.ExecuteBusinessRule | Running a business rule invoked from the form. | – |
| FormsController.GenerateBarcode | Generating the 1D barcode of the form. | – |
| FormsController.GenerateBarcode2D | Generating the 2D barcode of the form. | – |
| FormsController.GenerateDoc | Generating a DOC document from the form template. | – |
| FormsController.GenerateHtmlAsync | Generating an HTML document from the form template. | – |
| FormsController.GeneratePdfAsync | Generating a PDF document from the form template. | – |
| FormsController.GetMobileChart | Retrieving the chart model. | – |
| FormsController.GetSqlGrid | Retrieving the model of a Data grid form field. | – |
| FormsController.GetSqlRow | Retrieving the model of a Data row form field. | – |
| FormsController.GetWidgetData | Retrieving the widget model. | – |
| FormsController.GetVacationsChartData | Retrieving the leave chart data. | – |
Item list commands: CloneSubelementsRow, InitializeSubelements, ImportSubelementsFromExcel, AddSubelementsRow, ChangeCellValue, PickerResolve, RemoveSelectedSubelementsRows, RecalculateRow, RecalculateSubelements, RestoreValue.
JS model build stages: InsertControlsForOcrVerificationStep, InsertOcrModeButtonStep, SetIsOcrVerificationViewStep, CheckCheckoutStep, DeskInsertPathsStep, ExecuteOnLoadActionsStep, InsertAttachmentsStep, InsertClientInfoStep, InsertClientJsForLiteStep, InsertClientJsForMobileStep, InsertControlsStep, InsertDeskScreenshotDataStep, InsertGeneralFormDataStep, InsertInitialDataStep, InsertLicenseInfoStep, InsertMenuActionsStep, InsertPathsStep, InsertToModelStep, MutateMobileModelStep, RecoverMultilinePrimaryStep, SetIsCompactModelStep.
Item list
| Span | Description | Attributes |
|---|
| Update client value | Updating the item list. | – |
| Commands deserialization | Reading the item list update commands. | – |
| Run commands | Running the item list update commands. | – |
| NewRowAsync | Creating a new item list row. | Form field, Form field id, Row id |
| CreateSubelementsReadViewModelAsync | Creating the item list model in read mode. | – |
| CreateSubelementsWriteViewModelAsync | Creating the item list model in edit mode. | – |
| RecalculateAsync | Recalculating the item list values. | – |
| RecalculateRowAsync | Recalculating an item list row. | Row Id |
| CheckSaveRestrictions | Checking the item list save restrictions. | – |
| ValidateAsync | Validating the item list. | – |
| ResolveAsync | Processing the item list. | – |
| RecalculateRestrictionsAsync | Recalculating the item list restrictions. | – |
| ApplySpecificRestrictionsAsync | Applying the item list restrictions. | – |
| SaveAsync | Saving the item list. | – |
| SaveHistory | Saving the item list history. | – |
| LoadData | Loading the item list data. | – |
Reports
| Span | Description | Attributes |
|---|
| Get report data | Loading SQL report data. | ReportId |
| Prepare report view | Preparing the SQL report view. | – |
| SweController.GetViewData | Retrieving report view data for the current user. | – |
| Data repository - Get report engine | SQL report loading stage – preparing the report engine. | – |
| Data repository - Apply visibility restrictions | SQL report loading stage – applying visibility restrictions. | – |
| Data repository - Create columns | SQL report loading stage – creating columns. | – |
| Data repository - Get search columns | SQL report loading stage – creating search columns. | – |
| Data repository - Get data | SQL report loading stage – retrieving data. | – |
| Data repository - Create summary | SQL report loading stage – creating the summary. | – |
| Get Summaries Row | Running the query that returns the report summary row. | – |
| Span | Description | Attributes |
|---|
| EvaluateRuleAsync | Running a business rule. | Rule id, Rule name |
| Evaluate business rule | Evaluating a business rule node. | Id |
| Ux rule execution | Running the JavaScript code of a form rule. | Rule id, Rule name |
| Execute action | Running an action. | Id, Name |
| Execute attachment action | Running an action triggered when an attachment is added. | Id, Name |
| Replace tags | Replacing tags with values. | Mode |
| Replace attachment tags | Replacing tags in the attachment context. | FileName |
Attachments
| Span | Description | Attributes |
|---|
| Upload file to OneDrive | Uploading a file to OneDrive. | File name, Environment Application ID, Environment Tenant ID |
| Update permissions for OneDrive file | Updating permissions to a OneDrive file. | File name, Environment Application ID, Environment Tenant ID |
| OneDrive - Add permissions | Granting permissions to a OneDrive file. | Read, Write |
| Text extraction | Extracting text from an attachment for the SOLR index. | FileName, FileSize |
Data sources and SQL queries
| Span | Description | Attributes |
|---|
| SQL query name | An SQL query run by the system. The span name depends on the query. | Query, db.id |
| Load data from datasource | Loading data from a data source. | Data source id, Data source type |
| Establish ldap connection | Connecting to an LDAP directory. | Host name, Port, Use ssl, Trust server certificate |
| Perform LDAP search | Searching an LDAP directory. | DN, Filter, Count limit |
Cache and transactions
| Span | Description | Attributes |
|---|
| Load cache | Loading the cache. | DbId, Cache groups, Cache version, SnapshotIsolationSqlException |
| Refresh cache | Refreshing the cache. | DbId, Cache groups, Cache version, Business objects to load, SnapshotIsolationSqlException |
| Mark cache to refresh | Marking the configuration cache for refresh. | Cache groups, Reason |
| Mark data cache to refresh | Marking the data cache for refresh. | Data cache groups |
| CacheStore LoadAll | Retrieving the complete configuration from the database. | DbId, Cache groups |
| SetUpCache | Retrieving and initializing the Service cache. | – |
| Refresh config db cache | Refreshing the configuration database cache. | Cache groups, Cache version |
| Transaction: scope name | Database transaction scope. | Element id |
| Internal scope name | Running a named internal scope. | – |
Users and authentication
| Span | Description | Attributes |
|---|
| Converting NetBIOS name to principal name | Converting a NetBIOS name to a UPN. | – |
| Active Directory bind | Active Directory bind operation during user synchronization. | Domain |
| Active Directory request | Active Directory search during user synchronization. | Url |
| Clear substitutions cache | Clearing the substitutions cache. | – |
| TokenStore - Store | Storing a token in the cache. | – |
| TokenStore - TryFind | Looking up a token in the cache. | – |
| TicketStore - Store | Storing an authentication ticket in the cache. | – |
| TicketStore - Renew | Renewing an authentication ticket. | – |
| TicketStore - Retrieve | Retrieving an authentication ticket. | – |
| TicketStore - Remove | Removing an authentication ticket. | – |
Service
| Span | Description | Attributes |
|---|
| Service start | Starting the Service. | – |
| Service stop | Stopping the Service. | – |
| Emergency service stop | Emergency stop of the Service. | – |
| Service reload | Loading the Service configuration. | – |
| RoleKeeper start | Initializing the Service modules. | – |
| RoleKeeper CheckRoles | Periodic check of the Service modules. | – |
| Update heartbeat | Service heartbeat. | – |
| Check health | Checking the Service status. | – |
| Service activity: activity name | Running a single Service activity. | Connection string |
| Thread processing | Processing scope of any Service queue thread. | Role, ThreadId, ThreadGuid |
| Thread action | Processing a single content database queue item in a Service thread. | Role, ThreadId, ThreadGuid |
| LabelPrintImplementation | Printing a label. | Printer name |
| PowerShell Action | Running the Run a PowerShell script action. | – |
SOLR indexing
| Span | Description | Attributes |
|---|
| QueryWithPerformanceLogAsync | Running a SOLR query. | – |
| SOLR - Batch elements index | Stage of bulk indexing of workflow instances in SOLR. | – |
| SOLR - Batch element index | Stage of indexing a single workflow instance in SOLR. | WFD_ID |
| SOLR - Batch element index step | A step of indexing a single workflow instance in SOLR. | StepName |
Span attributes
| Attribute | Meaning |
|---|
db.id | Content database ID, added automatically from the request context (Portal) or task context (Service). In rare cases it may point to a database other than the one where the operation ran. |
| DbId | ID of the database the cache operation concerns. |
| Query | Text of the SQL query. |
| Connection string | Connection string of the database used by the Service activity. The password is removed from the connection string before it is recorded in the trace. |
| Cache groups, Data cache groups | Cache groups covered by the operation. |
| Cache version | Cache version. |
| Business objects to load | Business objects loaded during the refresh. |
| Reason | Reason the cache was marked for refresh. |
| SnapshotIsolationSqlException | Information about a snapshot isolation error while loading data. |
| ControllerName | Name of the controller handling the request. |
| ReportId | Report ID. |
| Path id, Path Id | Path ID. |
| Element id, WFD_ID | Workflow instance ID. |
| Form field | Form field display name. |
| Form field id, Field ID | Form field ID. |
| Field name | Form field name. |
| Row id, Row Id | Item list row ID. |
| Id | Action ID (action spans) or business rule node ID (the Evaluate business rule span). |
| Name | Action name. |
| Rule id | Rule ID. |
| Rule name | Rule name. |
| Mode | Tag replacement mode. |
| File name, FileName | Attachment file name. |
| FileSize | Attachment file size. |
| Environment Application ID | Application ID of the OneDrive connection. |
| Environment Tenant ID | Tenant ID of the OneDrive connection. |
| Read | Whether read permission was granted. |
| Write | Whether write permission was granted. |
| Data source ID, Data source id | Data source ID. |
| Data source type | Data source type. |
| Host name | LDAP server host name. |
| Port | LDAP server port. |
| Use ssl | Whether the connection uses SSL. |
| Trust server certificate | Whether the server certificate is trusted without validation. |
| DN | Distinguished name (DN) where the search starts. |
| Filter | LDAP search filter. |
| Count limit | Maximum number of returned results. |
| Domain | Active Directory domain. |
| Url | Address of the Active Directory query. |
| Role | Service role (module). |
| ThreadId | Service thread ID. |
| ThreadGuid | Service thread GUID. |
| StepName | Name of the workflow instance indexing step. |
| Printer name | Label printer name. |