Skip to main content
Version: 2026 R1

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": {} }
}
NodeMeaning
MetricsEnables 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).
TracingEnables 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.
LogsEnables the export of Portal logs over OTLP. The Service does not export logs.
ExportersThe 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.

Span event limit

The default OpenTelemetry limits may be too low for Service traces. Increase the OTEL_SPAN_EVENT_COUNT_LIMIT environment variable on the Service server, e.g. to 10240. For a description of the limits, see OpenTelemetry Environment Variable Specification – Span Limits.

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 processMetrics address
WebCon.WorkFlow.BootstrapperNo default port – it can be set in the Kestrel node of the appsettings.production.json file.
Webcon.WorkFlow.Module.ServiceModuleRunnerPort 48450, changed in the modulesettings.modulesOrchestration.Production.json file (serviceModuleRunnerPort node).
Webcon.WorkFlow.Servicehttp://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.
info

For configuration examples of Jaeger, Prometheus, Grafana, Honeycomb and cloud services, see the article OpenTelemetry in WEBCON 2026 R1.

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.

MetricDescription
webcon-workflow-portal-openNumber of times the Portal home page was opened in a browser (each new browser window).
webcon-workflow-form-openNumber of times a workflow instance was opened in a browser.
webcon-workflow-form-elements-cacheNumber 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-transitionsNumber of all started path transitions, including failed ones.
webcon-workflow-form-success-path-transitionsNumber of successfully completed path transitions.
webcon-workflow-form-path-transitions-in-progressNumber 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-timesDistribution (histogram) of path transition execution times.
webcon-workflow-portal-ticket-store-cacheNumber of objects in the user authentication ticket cache.
webcon-workflow-portal-token-store-cacheNumber of objects in the token cache.
webcon-workflow-ocr-finereader-license-remaining-pagesNumber of pages that can still be processed under the FineReader license.
webcon-workflow-solr-elements-queueNumber of items added to the workflow instance indexing queue (SolrElementIndexer).
webcon-workflow-solr-attachments-queueNumber of items added to the attachment indexing queue (SolrAttachmentIndexer).
webcon-workflow-solr-activities-queueNumber of items added to the activity indexing queue (SolrActivityIndexer).
webcon-workflow-solr-utilities-queueNumber of items added to the utility indexing queue (SolrUtilityIndexer).
webcon-workflow-solr-elements-processedNumber of items removed from the workflow instance indexing queue after processing.
webcon-workflow-solr-attachments-processedNumber of items removed from the attachment indexing queue after processing.
webcon-workflow-solr-activities-processedNumber of items removed from the activity indexing queue after processing.
webcon-workflow-solr-utilities-processedNumber of items removed from the utility indexing queue after processing.
uda-endpoint-automationNumber of calls to User Defined API (UDA) endpoints that run automations.
uda-endpoint-data-sourceNumber of calls to UDA data source endpoints.
uda-endpoint-element-dataNumber of calls to UDA endpoints that return workflow instance data.
uda-endpoint-element-transitionNumber 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​

SpanDescriptionAttributes
Create controllerCreating the controller that handles the request.ControllerName
Controller endpoint actionRunning the controller method that handles the request.–
Bind modelBinding request data to the model.–
Deserialize commands modelReading the command model sent in the request (also at the authorization stage).–
Input JSON Formatter - ReadAsyncConverting an input parameter from JSON to an object.–
Output JSON Formatter - WriteAsyncConverting the result to JSON.–
DetermineProviderCultureResultDetermining the user's language and its usage context.–
Filters contextRunning request filters (parent span for the individual stages).–
Authorization filtersRequest authorization stage.–
RequireApplicationFilterChecking access to the application at the authorization stage.–
Resource filtersResource stage.–
Resource filters OnResourceExecutingResource stage before the request is handled.–
Resource filters OnResourceExecutedResource stage after the request is handled.–
Action filtersAction stage.–
Action filters OnActionExecutingAction stage before the request is handled.–
Action filters OnActionExecutedAction stage after the request is handled.–
RequireReportViewFilterChecking permissions to the report view.–
Exception filtersException handling stage.–
Result filtersResult stage.–
Result filters OnResultExecutingResult stage before the response is returned.–
Result filters OnResultExecutedResult stage after the response is returned.–
Action result executionGenerating the result returned in response to the request.–
HeartBeatA single Portal heartbeat.–

Form and workflow instance model​

SpanDescriptionAttributes
GetElementFormAsyncCreating the model of a new or existing workflow instance (optionally based on the cache).–
LoadExistingElementFormAsyncCreating a complete, up-to-date model of the workflow instance form.–
LoadJsModelAsyncCreating the JS model of the workflow instance.–
JS model build stage nameA stage of building the JS model of the workflow instance (stages listed below).–
GetElementInfoAsyncRetrieving detailed information about the workflow instance.–
GetDesktopAsyncRetrieving information about the workflow instance together with its status.–
Apply business rules and set default valuesRunning business rules and setting default values.–
UpdateFormFieldsAsyncUpdating form field values.–
FillEntityDataAsyncRetrieving data for a choice field.Field ID, Field name, Data source ID
Get form field report dataLoading the data of an SQL report displayed in a form field.ReportId
Item list command namePassing a command to an item list (commands listed below).–
MoveElementToNextStepAsyncMoving the workflow instance along a path (without saving).Path id, Element id
Move to next stepExecution time of a path transition or a workflow instance save.Path Id
FormsController.ExecuteBusinessRuleRunning a business rule invoked from the form.–
FormsController.GenerateBarcodeGenerating the 1D barcode of the form.–
FormsController.GenerateBarcode2DGenerating the 2D barcode of the form.–
FormsController.GenerateDocGenerating a DOC document from the form template.–
FormsController.GenerateHtmlAsyncGenerating an HTML document from the form template.–
FormsController.GeneratePdfAsyncGenerating a PDF document from the form template.–
FormsController.GetMobileChartRetrieving the chart model.–
FormsController.GetSqlGridRetrieving the model of a Data grid form field.–
FormsController.GetSqlRowRetrieving the model of a Data row form field.–
FormsController.GetWidgetDataRetrieving the widget model.–
FormsController.GetVacationsChartDataRetrieving 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​

SpanDescriptionAttributes
Update client valueUpdating the item list.–
Commands deserializationReading the item list update commands.–
Run commandsRunning the item list update commands.–
NewRowAsyncCreating a new item list row.Form field, Form field id, Row id
CreateSubelementsReadViewModelAsyncCreating the item list model in read mode.–
CreateSubelementsWriteViewModelAsyncCreating the item list model in edit mode.–
RecalculateAsyncRecalculating the item list values.–
RecalculateRowAsyncRecalculating an item list row.Row Id
CheckSaveRestrictionsChecking the item list save restrictions.–
ValidateAsyncValidating the item list.–
ResolveAsyncProcessing the item list.–
RecalculateRestrictionsAsyncRecalculating the item list restrictions.–
ApplySpecificRestrictionsAsyncApplying the item list restrictions.–
SaveAsyncSaving the item list.–
SaveHistorySaving the item list history.–
LoadDataLoading the item list data.–

Reports​

SpanDescriptionAttributes
Get report dataLoading SQL report data.ReportId
Prepare report viewPreparing the SQL report view.–
SweController.GetViewDataRetrieving report view data for the current user.–
Data repository - Get report engineSQL report loading stage – preparing the report engine.–
Data repository - Apply visibility restrictionsSQL report loading stage – applying visibility restrictions.–
Data repository - Create columnsSQL report loading stage – creating columns.–
Data repository - Get search columnsSQL report loading stage – creating search columns.–
Data repository - Get dataSQL report loading stage – retrieving data.–
Data repository - Create summarySQL report loading stage – creating the summary.–
Get Summaries RowRunning the query that returns the report summary row.–

Rules, actions and tags​

SpanDescriptionAttributes
EvaluateRuleAsyncRunning a business rule.Rule id, Rule name
Evaluate business ruleEvaluating a business rule node.Id
Ux rule executionRunning the JavaScript code of a form rule.Rule id, Rule name
Execute actionRunning an action.Id, Name
Execute attachment actionRunning an action triggered when an attachment is added.Id, Name
Replace tagsReplacing tags with values.Mode
Replace attachment tagsReplacing tags in the attachment context.FileName

Attachments​

SpanDescriptionAttributes
Upload file to OneDriveUploading a file to OneDrive.File name, Environment Application ID, Environment Tenant ID
Update permissions for OneDrive fileUpdating permissions to a OneDrive file.File name, Environment Application ID, Environment Tenant ID
OneDrive - Add permissionsGranting permissions to a OneDrive file.Read, Write
Text extractionExtracting text from an attachment for the SOLR index.FileName, FileSize

Data sources and SQL queries​

SpanDescriptionAttributes
SQL query nameAn SQL query run by the system. The span name depends on the query.Query, db.id
Load data from datasourceLoading data from a data source.Data source id, Data source type
Establish ldap connectionConnecting to an LDAP directory.Host name, Port, Use ssl, Trust server certificate
Perform LDAP searchSearching an LDAP directory.DN, Filter, Count limit

Cache and transactions​

SpanDescriptionAttributes
Load cacheLoading the cache.DbId, Cache groups, Cache version, SnapshotIsolationSqlException
Refresh cacheRefreshing the cache.DbId, Cache groups, Cache version, Business objects to load, SnapshotIsolationSqlException
Mark cache to refreshMarking the configuration cache for refresh.Cache groups, Reason
Mark data cache to refreshMarking the data cache for refresh.Data cache groups
CacheStore LoadAllRetrieving the complete configuration from the database.DbId, Cache groups
SetUpCacheRetrieving and initializing the Service cache.–
Refresh config db cacheRefreshing the configuration database cache.Cache groups, Cache version
Transaction: scope nameDatabase transaction scope.Element id
Internal scope nameRunning a named internal scope.–

Users and authentication​

SpanDescriptionAttributes
Converting NetBIOS name to principal nameConverting a NetBIOS name to a UPN.–
Active Directory bindActive Directory bind operation during user synchronization.Domain
Active Directory requestActive Directory search during user synchronization.Url
Clear substitutions cacheClearing the substitutions cache.–
TokenStore - StoreStoring a token in the cache.–
TokenStore - TryFindLooking up a token in the cache.–
TicketStore - StoreStoring an authentication ticket in the cache.–
TicketStore - RenewRenewing an authentication ticket.–
TicketStore - RetrieveRetrieving an authentication ticket.–
TicketStore - RemoveRemoving an authentication ticket.–

Service​

SpanDescriptionAttributes
Service startStarting the Service.–
Service stopStopping the Service.–
Emergency service stopEmergency stop of the Service.–
Service reloadLoading the Service configuration.–
RoleKeeper startInitializing the Service modules.–
RoleKeeper CheckRolesPeriodic check of the Service modules.–
Update heartbeatService heartbeat.–
Check healthChecking the Service status.–
Service activity: activity nameRunning a single Service activity.Connection string
Thread processingProcessing scope of any Service queue thread.Role, ThreadId, ThreadGuid
Thread actionProcessing a single content database queue item in a Service thread.Role, ThreadId, ThreadGuid
LabelPrintImplementationPrinting a label.Printer name
PowerShell ActionRunning the Run a PowerShell script action.–

SOLR indexing​

SpanDescriptionAttributes
QueryWithPerformanceLogAsyncRunning a SOLR query.–
SOLR - Batch elements indexStage of bulk indexing of workflow instances in SOLR.–
SOLR - Batch element indexStage of indexing a single workflow instance in SOLR.WFD_ID
SOLR - Batch element index stepA step of indexing a single workflow instance in SOLR.StepName

Span attributes​

AttributeMeaning
db.idContent 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.
DbIdID of the database the cache operation concerns.
QueryText of the SQL query.
Connection stringConnection 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 groupsCache groups covered by the operation.
Cache versionCache version.
Business objects to loadBusiness objects loaded during the refresh.
ReasonReason the cache was marked for refresh.
SnapshotIsolationSqlExceptionInformation about a snapshot isolation error while loading data.
ControllerNameName of the controller handling the request.
ReportIdReport ID.
Path id, Path IdPath ID.
Element id, WFD_IDWorkflow instance ID.
Form fieldForm field display name.
Form field id, Field IDForm field ID.
Field nameForm field name.
Row id, Row IdItem list row ID.
IdAction ID (action spans) or business rule node ID (the Evaluate business rule span).
NameAction name.
Rule idRule ID.
Rule nameRule name.
ModeTag replacement mode.
File name, FileNameAttachment file name.
FileSizeAttachment file size.
Environment Application IDApplication ID of the OneDrive connection.
Environment Tenant IDTenant ID of the OneDrive connection.
ReadWhether read permission was granted.
WriteWhether write permission was granted.
Data source ID, Data source idData source ID.
Data source typeData source type.
Host nameLDAP server host name.
PortLDAP server port.
Use sslWhether the connection uses SSL.
Trust server certificateWhether the server certificate is trusted without validation.
DNDistinguished name (DN) where the search starts.
FilterLDAP search filter.
Count limitMaximum number of returned results.
DomainActive Directory domain.
UrlAddress of the Active Directory query.
RoleService role (module).
ThreadIdService thread ID.
ThreadGuidService thread GUID.
StepNameName of the workflow instance indexing step.
Printer nameLabel printer name.
info

In version 2026 R2, the names of metrics, spans and attributes were changed to follow the OpenTelemetry convention. For a mapping of old and new names, see the article Changes in the naming of OpenTelemetry elements from version 2026 R2.