Przejdź do głównej zawartości
Wersja: 2026 R1

Metryki i ślady OpenTelemetry

Portal i serwis WEBCON udostępniają dane telemetryczne w standardzie OpenTelemetry – metryki i ślady (spany), a Portal także logi. Dane można przesyłać do narzędzi zgodnych ze standardem, np. Prometheus, Grafana, Grafana Tempo, Jaeger czy Azure Application Insights, i na ich podstawie budować raporty oraz alerty.

Poniższe zestawienie obejmuje metryki i spany specyficzne dla WEBCON w wersji 2026 R1. Standardowe instrumentacje (ASP.NET Core, HttpClient, SqlClient, klient WCF, metryki procesu i środowiska uruchomieniowego .NET) generują dane zgodnie z konwencjami semantycznymi OpenTelemetry i nie są tu opisywane.

Konfiguracja​

Od wersji 2026 R1 telemetria jest konfigurowana w pliku appsettings.json, osobno w katalogu instalacyjnym Portalu i serwisu, w sekcji OpenTelemetry. Plik otlpsettings.json z wcześniejszych wersji nie jest już używany.

"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": {} }
}
WęzełZnaczenie
MetricsWłącza zbieranie metryk. Po włączeniu działają wszystkie dostępne instrumentacje – nie można ich włączać osobno. Węzeł Prometheus udostępnia metryki pod adresem Endpoint (domyślnie /metrics).
TracingWłącza zbieranie śladów. SqlTracing > ShowDbStatements decyduje, czy treść zapytań SQL jest zapisywana w śladach. Ślady zawierają wtedy także connection string bazy danych, z którego przed zapisaniem usuwane jest hasło.
LogsWłącza eksport logów Portalu przez protokół OTLP. Serwis nie eksportuje logów.
ExportersLista eksporterów OTLP danego rodzaju danych, np. "Otlp": { "Enabled": true, "Endpoint": "", "Headers": "", "Protocol": "http" }.

Aby eksporter działał, węzeł eksportera i jego węzeł nadrzędny (Metrics, Tracing lub Logs) muszą mieć wartość "Enabled": true.

Limit zdarzeń w spanie

Domyślne limity OpenTelemetry mogą okazać się zbyt niskie dla śladów serwisu. Zwiększ wartość zmiennej środowiskowej OTEL_SPAN_EVENT_COUNT_LIMIT na serwerze serwisu, np. do 10240. Opis limitów: OpenTelemetry Environment Variable Specification – Span Limits.

Połączenie z Azure Application Insights konfiguruje się poza sekcją OpenTelemetry, w węźle ApplicationInsights > ConnectionString. Ustawienie samego connection stringa powoduje wysyłanie śladów, metryk i logów do Application Insights niezależnie od ustawień sekcji OpenTelemetry.

Serwis działa jako kilka procesów, z których każdy udostępnia metryki pod osobnym adresem:

Proces serwisuAdres metryk
WebCon.WorkFlow.BootstrapperBrak domyślnego portu – można go określić w węźle Kestrel pliku appsettings.production.json.
Webcon.WorkFlow.Module.ServiceModuleRunnerPort 48450, zmieniany w pliku modulesettings.modulesOrchestration.Production.json (węzeł serviceModuleRunnerPort).
Webcon.WorkFlow.Servicehttp://localhost:9464, zmieniany w pliku modulesettings.service.Production.json w katalogu OldService. Nowy adres musi być zarejestrowany dla konta, na którym działa serwis.
informacja

Przykłady konfiguracji Jaeger, Prometheus, Grafana, Honeycomb i usług chmurowych zawiera artykuł OpenTelemetry w WEBCON 2026 R1.

Metryki​

Kolektory, np. Prometheus, zamieniają łączniki w nazwach metryk na podkreślenia i w zależności od typu metryki dodają przyrostki, np. _total, _bucket, _sum lub _count.

MetrykaOpis
webcon-workflow-portal-openLiczba otwarć strony głównej Portalu w przeglądarce (każde nowe okno przeglądarki).
webcon-workflow-form-openLiczba otwarć elementu obiegu w przeglądarce.
webcon-workflow-form-elements-cacheLiczba modeli elementów przechowywanych w pamięci podręcznej. Model jest dodawany przy otwarciu formularza i usuwany po przejściu ścieżką.
webcon-workflow-form-path-transitionsLiczba wszystkich rozpoczętych przejść ścieżką, łącznie z zakończonymi błędem.
webcon-workflow-form-success-path-transitionsLiczba przejść ścieżką zakończonych powodzeniem.
webcon-workflow-form-path-transitions-in-progressLiczba przejść ścieżką wykonywanych w danej chwili. Poprawne przejście trwa zwykle kilkaset milisekund, więc wzrost wartości wskazuje na obciążenie systemu.
webcon-workflow-form-path-transition-timesRozkład (histogram) czasów wykonania przejść ścieżką.
webcon-workflow-portal-ticket-store-cacheLiczba obiektów w pamięci podręcznej ticketów uwierzytelniania użytkowników.
webcon-workflow-portal-token-store-cacheLiczba obiektów w pamięci podręcznej tokenów.
webcon-workflow-ocr-finereader-license-remaining-pagesLiczba stron, które można jeszcze przetworzyć w ramach licencji FineReader.
webcon-workflow-solr-elements-queueLiczba pozycji dodanych do kolejki indeksowania elementów (SolrElementIndexer).
webcon-workflow-solr-attachments-queueLiczba pozycji dodanych do kolejki indeksowania załączników (SolrAttachmentIndexer).
webcon-workflow-solr-activities-queueLiczba pozycji dodanych do kolejki indeksowania aktywności (SolrActivityIndexer).
webcon-workflow-solr-utilities-queueLiczba pozycji dodanych do kolejki indeksowania pomocniczego (SolrUtilityIndexer).
webcon-workflow-solr-elements-processedLiczba pozycji usuniętych z kolejki indeksowania elementów po przetworzeniu.
webcon-workflow-solr-attachments-processedLiczba pozycji usuniętych z kolejki indeksowania załączników po przetworzeniu.
webcon-workflow-solr-activities-processedLiczba pozycji usuniętych z kolejki indeksowania aktywności po przetworzeniu.
webcon-workflow-solr-utilities-processedLiczba pozycji usuniętych z kolejki indeksowania pomocniczego po przetworzeniu.
uda-endpoint-automationLiczba wywołań punktów końcowych User Defined API (UDA) uruchamiających automatyzacje.
uda-endpoint-data-sourceLiczba wywołań punktów końcowych UDA dla źródeł danych.
uda-endpoint-element-dataLiczba wywołań punktów końcowych UDA zwracających dane elementu.
uda-endpoint-element-transitionLiczba wywołań punktów końcowych UDA wykonujących przejście ścieżką, zapis lub rejestrację elementu.

Ślady (spany)​

Od wersji 2026 R1 wszystkie ślady Portalu i serwisu zawierają atrybut db.id – identyfikator bazy danych zawartości. Atrybuty spanów opisuje tabela Opis atrybutów śladów.

Obsługa żądań w Portalu​

SpanOpisAtrybuty
Create controllerUtworzenie kontrolera obsługującego żądanie.ControllerName
Controller endpoint actionWykonanie metody kontrolera obsługującej żądanie.–
Bind modelPowiązanie danych żądania z modelem.–
Deserialize commands modelOdczytanie modelu poleceń przesłanego w żądaniu (także na etapie autoryzacji).–
Input JSON Formatter - ReadAsyncKonwersja parametru wejściowego z formatu JSON na obiekt.–
Output JSON Formatter - WriteAsyncKonwersja wyniku do formatu JSON.–
DetermineProviderCultureResultUstalenie języka użytkownika i kontekstu jego użycia.–
Filters contextWykonanie filtrów żądania (span nadrzędny dla poszczególnych etapów).–
Authorization filtersEtap autoryzacji żądania.–
RequireApplicationFilterSprawdzenie dostępu do aplikacji na etapie autoryzacji.–
Resource filtersEtap zasobów.–
Resource filters OnResourceExecutingEtap zasobów przed obsługą żądania.–
Resource filters OnResourceExecutedEtap zasobów po obsłudze żądania.–
Action filtersEtap akcji.–
Action filters OnActionExecutingEtap akcji przed obsługą żądania.–
Action filters OnActionExecutedEtap akcji po obsłudze żądania.–
RequireReportViewFilterSprawdzenie uprawnień do widoku raportu.–
Exception filtersEtap obsługi wyjątków.–
Result filtersEtap wyniku.–
Result filters OnResultExecutingEtap wyniku przed zwróceniem odpowiedzi.–
Result filters OnResultExecutedEtap wyniku po zwróceniu odpowiedzi.–
Action result executionWygenerowanie wyniku zwracanego w odpowiedzi na żądanie.–
HeartBeatPojedynczy sygnał aktywności (heartbeat) Portalu.–

Formularz i model elementu​

SpanOpisAtrybuty
GetElementFormAsyncUtworzenie modelu nowego lub istniejącego elementu (opcjonalnie na podstawie pamięci podręcznej).–
LoadExistingElementFormAsyncUtworzenie pełnego, aktualnego modelu formularza elementu.–
LoadJsModelAsyncUtworzenie modelu JS elementu.–
Nazwa etapu budowania modelu JSEtap budowania modelu JS elementu (lista etapów poniżej).–
GetElementInfoAsyncPobranie szczegółowych informacji o elemencie.–
GetDesktopAsyncPobranie informacji o elemencie wraz z jego statusem.–
Apply business rules and set default valuesWykonanie reguł biznesowych i ustawienie wartości domyślnych.–
UpdateFormFieldsAsyncAktualizacja wartości pól formularza.–
FillEntityDataAsyncPobranie danych dla pola wyboru.Field ID, Field name, Data source ID
Get form field report dataWczytanie danych raportu SQL wyświetlanego w polu formularza.ReportId
Nazwa polecenia listy pozycjiPrzekazanie polecenia do listy pozycji (lista poleceń poniżej).–
MoveElementToNextStepAsyncWykonanie przejścia ścieżką dla elementu (bez zapisu).Path id, Element id
Move to next stepCzas wykonania przejścia ścieżką lub zapisu elementu.Path Id
FormsController.ExecuteBusinessRuleWykonanie reguły biznesowej wywołanej z formularza.–
FormsController.GenerateBarcodeWygenerowanie kodu kreskowego 1D formularza.–
FormsController.GenerateBarcode2DWygenerowanie kodu kreskowego 2D formularza.–
FormsController.GenerateDocWygenerowanie dokumentu DOC na podstawie szablonu formularza.–
FormsController.GenerateHtmlAsyncWygenerowanie dokumentu HTML na podstawie szablonu formularza.–
FormsController.GeneratePdfAsyncWygenerowanie dokumentu PDF na podstawie szablonu formularza.–
FormsController.GetMobileChartPobranie modelu wykresu.–
FormsController.GetSqlGridPobranie modelu pola Tabela danych.–
FormsController.GetSqlRowPobranie modelu pola Wiersz danych.–
FormsController.GetWidgetDataPobranie modelu widżetu.–
FormsController.GetVacationsChartDataPobranie danych wykresu urlopowego.–

Polecenia listy pozycji: CloneSubelementsRow, InitializeSubelements, ImportSubelementsFromExcel, AddSubelementsRow, ChangeCellValue, PickerResolve, RemoveSelectedSubelementsRows, RecalculateRow, RecalculateSubelements, RestoreValue.

Etapy budowania modelu JS: InsertControlsForOcrVerificationStep, InsertOcrModeButtonStep, SetIsOcrVerificationViewStep, CheckCheckoutStep, DeskInsertPathsStep, ExecuteOnLoadActionsStep, InsertAttachmentsStep, InsertClientInfoStep, InsertClientJsForLiteStep, InsertClientJsForMobileStep, InsertControlsStep, InsertDeskScreenshotDataStep, InsertGeneralFormDataStep, InsertInitialDataStep, InsertLicenseInfoStep, InsertMenuActionsStep, InsertPathsStep, InsertToModelStep, MutateMobileModelStep, RecoverMultilinePrimaryStep, SetIsCompactModelStep.

Lista pozycji​

SpanOpisAtrybuty
Update client valueAktualizacja listy pozycji.–
Commands deserializationOdczytanie poleceń aktualizacji listy pozycji.–
Run commandsWykonanie poleceń aktualizacji listy pozycji.–
NewRowAsyncUtworzenie nowego wiersza listy pozycji.Form field, Form field id, Row id
CreateSubelementsReadViewModelAsyncUtworzenie modelu listy pozycji w trybie odczytu.–
CreateSubelementsWriteViewModelAsyncUtworzenie modelu listy pozycji w trybie edycji.–
RecalculateAsyncPrzeliczenie wartości listy pozycji.–
RecalculateRowAsyncPrzeliczenie wiersza listy pozycji.Row Id
CheckSaveRestrictionsSprawdzenie ograniczeń zapisu listy pozycji.–
ValidateAsyncWalidacja listy pozycji.–
ResolveAsyncPrzetworzenie listy pozycji.–
RecalculateRestrictionsAsyncPrzeliczenie ograniczeń listy pozycji.–
ApplySpecificRestrictionsAsyncZastosowanie ograniczeń listy pozycji.–
SaveAsyncZapis listy pozycji.–
SaveHistoryZapis historii listy pozycji.–
LoadDataWczytanie danych listy pozycji.–

Raporty​

SpanOpisAtrybuty
Get report dataWczytanie danych raportu SQL.ReportId
Prepare report viewPrzygotowanie widoku raportu SQL.–
SweController.GetViewDataPobranie danych widoku raportu dla bieżącego użytkownika.–
Data repository - Get report engineEtap wczytywania raportu SQL – przygotowanie mechanizmu raportu.–
Data repository - Apply visibility restrictionsEtap wczytywania raportu SQL – zastosowanie ograniczeń widoczności.–
Data repository - Create columnsEtap wczytywania raportu SQL – utworzenie kolumn.–
Data repository - Get search columnsEtap wczytywania raportu SQL – utworzenie kolumn wyszukiwania.–
Data repository - Get dataEtap wczytywania raportu SQL – pobranie danych.–
Data repository - Create summaryEtap wczytywania raportu SQL – utworzenie podsumowania.–
Get Summaries RowWykonanie zapytania zwracającego wiersz podsumowania raportu.–

Reguły, akcje i znaczniki​

SpanOpisAtrybuty
EvaluateRuleAsyncWykonanie reguły biznesowej.Rule id, Rule name
Evaluate business ruleObliczenie węzła reguły biznesowej.Id
Ux rule executionWykonanie kodu JavaScript reguły formularza.Rule id, Rule name
Execute actionWykonanie akcji.Id, Name
Execute attachment actionWykonanie akcji uruchamianej przy dodaniu załącznika.Id, Name
Replace tagsZastąpienie znaczników wartościami.Mode
Replace attachment tagsZastąpienie znaczników w kontekście załącznika.FileName

Załączniki​

SpanOpisAtrybuty
Upload file to OneDrivePrzesłanie pliku do OneDrive.File name, Environment Application ID, Environment Tenant ID
Update permissions for OneDrive fileAktualizacja uprawnień do pliku w OneDrive.File name, Environment Application ID, Environment Tenant ID
OneDrive - Add permissionsNadanie uprawnień do pliku w OneDrive.Read, Write
Text extractionWyodrębnienie tekstu z załącznika na potrzeby indeksu SOLR.FileName, FileSize

Źródła danych i zapytania SQL​

SpanOpisAtrybuty
Nazwa zapytania SQLZapytanie SQL wykonywane przez system. Nazwa spanu zależy od zapytania.Query, db.id
Load data from datasourceWczytanie danych ze źródła danych.Data source id, Data source type
Establish ldap connectionNawiązanie połączenia z katalogiem LDAP.Host name, Port, Use ssl, Trust server certificate
Perform LDAP searchWyszukiwanie w katalogu LDAP.DN, Filter, Count limit

Pamięć podręczna i transakcje​

SpanOpisAtrybuty
Load cacheWczytanie pamięci podręcznej.DbId, Cache groups, Cache version, SnapshotIsolationSqlException
Refresh cacheOdświeżenie pamięci podręcznej.DbId, Cache groups, Cache version, Business objects to load, SnapshotIsolationSqlException
Mark cache to refreshOznaczenie pamięci podręcznej konfiguracji do odświeżenia.Cache groups, Reason
Mark data cache to refreshOznaczenie pamięci podręcznej danych do odświeżenia.Data cache groups
CacheStore LoadAllPobranie pełnej konfiguracji z bazy danych.DbId, Cache groups
SetUpCachePobranie i inicjalizacja pamięci podręcznej serwisu.–
Refresh config db cacheOdświeżenie pamięci podręcznej bazy konfiguracyjnej.Cache groups, Cache version
Transaction: nazwa zakresuZakres transakcji bazodanowej.Element id
Nazwa zakresu wewnętrznegoWykonanie nazwanego zakresu wewnętrznego.–

Użytkownicy i uwierzytelnianie​

SpanOpisAtrybuty
Converting NetBIOS name to principal nameKonwersja nazwy NetBIOS na nazwę UPN.–
Active Directory bindOperacja bind w Active Directory podczas synchronizacji użytkowników.Domain
Active Directory requestWyszukiwanie w Active Directory podczas synchronizacji użytkowników.Url
Clear substitutions cacheWyczyszczenie pamięci podręcznej zastępstw.–
TokenStore - StoreZapisanie tokenu w pamięci podręcznej.–
TokenStore - TryFindWyszukanie tokenu w pamięci podręcznej.–
TicketStore - StoreZapisanie ticketu uwierzytelniania w pamięci podręcznej.–
TicketStore - RenewOdnowienie ticketu uwierzytelniania.–
TicketStore - RetrievePobranie ticketu uwierzytelniania.–
TicketStore - RemoveUsunięcie ticketu uwierzytelniania.–

Serwis​

SpanOpisAtrybuty
Service startUruchomienie serwisu.–
Service stopZatrzymanie serwisu.–
Emergency service stopAwaryjne zatrzymanie serwisu.–
Service reloadWczytanie konfiguracji serwisu.–
RoleKeeper startInicjalizacja modułów serwisu.–
RoleKeeper CheckRolesCykliczne sprawdzenie modułów serwisu.–
Update heartbeatSygnał aktywności (heartbeat) serwisu.–
Check healthSprawdzenie stanu serwisu.–
Service activity: nazwa działaniaWykonanie pojedynczej aktywności serwisu.Connection string
Thread processingZakres przetwarzania dowolnego wątku kolejki serwisu.Role, ThreadId, ThreadGuid
Thread actionPrzetwarzanie pojedynczej pozycji kolejki bazy danych zawartości w wątku serwisu.Role, ThreadId, ThreadGuid
LabelPrintImplementationWydruk etykiety.Printer name
PowerShell ActionWykonanie akcji Uruchom skrypt PowerShell.–

Indeksowanie SOLR​

SpanOpisAtrybuty
QueryWithPerformanceLogAsyncWykonanie zapytania do SOLR.–
SOLR - Batch elements indexEtap zbiorczego indeksowania elementów w SOLR.–
SOLR - Batch element indexEtap indeksowania pojedynczego elementu w SOLR.WFD_ID
SOLR - Batch element index stepKrok indeksowania pojedynczego elementu w SOLR.StepName

Opis atrybutów śladów​

AtrybutZnaczenie
db.idIdentyfikator bazy danych zawartości, dodawany automatycznie na podstawie kontekstu żądania (Portal) lub zadania (serwis). W nielicznych przypadkach może wskazywać inną bazę niż ta, w której wykonano operację.
DbIdIdentyfikator bazy danych, której dotyczy operacja na pamięci podręcznej.
QueryTreść zapytania SQL.
Connection stringConnection string bazy danych, z której korzysta działanie serwisu. Hasło jest usuwane z connection stringa przed zapisaniem w śladzie.
Cache groups, Data cache groupsGrupy pamięci podręcznej objęte operacją.
Cache versionWersja pamięci podręcznej.
Business objects to loadObiekty biznesowe wczytywane podczas odświeżania.
ReasonPowód oznaczenia pamięci podręcznej do odświeżenia.
SnapshotIsolationSqlExceptionInformacja o błędzie izolacji migawki (snapshot isolation) podczas wczytywania danych.
ControllerNameNazwa kontrolera obsługującego żądanie.
ReportIdIdentyfikator raportu.
Path id, Path IdIdentyfikator ścieżki.
Element id, WFD_IDIdentyfikator elementu obiegu.
Form fieldNazwa wyświetlana pola formularza.
Form field id, Field IDIdentyfikator pola formularza.
Field nameNazwa pola formularza.
Row id, Row IdIdentyfikator wiersza listy pozycji.
IdIdentyfikator akcji (spany akcji) lub węzła reguły biznesowej (span Evaluate business rule).
NameNazwa akcji.
Rule idIdentyfikator reguły.
Rule nameNazwa reguły.
ModeTryb zastępowania znaczników.
File name, FileNameNazwa pliku załącznika.
FileSizeRozmiar pliku załącznika.
Environment Application IDIdentyfikator aplikacji (Application ID) połączenia z OneDrive.
Environment Tenant IDIdentyfikator dzierżawy (Tenant ID) połączenia z OneDrive.
ReadOkreśla, czy nadano uprawnienie do odczytu.
WriteOkreśla, czy nadano uprawnienie do zapisu.
Data source ID, Data source idIdentyfikator źródła danych.
Data source typeTyp źródła danych.
Host nameNazwa hosta serwera LDAP.
PortPort serwera LDAP.
Use sslOkreśla, czy połączenie używa SSL.
Trust server certificateOkreśla, czy certyfikat serwera jest zaufany bez weryfikacji.
DNNazwa wyróżniająca (DN), od której rozpoczyna się wyszukiwanie.
FilterFiltr wyszukiwania LDAP.
Count limitMaksymalna liczba zwracanych wyników.
DomainDomena Active Directory.
UrlAdres zapytania do Active Directory.
RoleRola (moduł) serwisu.
ThreadIdIdentyfikator wątku serwisu.
ThreadGuidIdentyfikator GUID wątku serwisu.
StepNameNazwa kroku indeksowania elementu.
Printer nameNazwa drukarki etykiet.
informacja

W wersji 2026 R2 nazwy metryk, spanów i atrybutów zostały zmienione zgodnie z konwencją OpenTelemetry. Zestawienie starych i nowych nazw zawiera artykuł Zmiany w nazewnictwie elementów OpenTelemetry od wersji 2026 R2.