Zarządzanie błędami

Konsola zarządzania błędami (EMC)

Zakładka Error Monitor w aplikacji DQS zapewnia dedykowany interfejs do monitorowania i rozwiązywania błędów występujących podczas przetwarzania skanów. Daje pełny wgląd w awarie wsadowe, błędy strategii i problemy platformy — wszystko w jednym miejscu.

Układ

Konsola zarządzania błędami (EMC) wykorzystuje układ 3-strefowy:

• Sidebar filtrów (po lewej) — Filtrowanie błędów według typu błędu, klasy źródłowej, komunikatu błędu, zakresu czasu (Od/Do) oraz adresu IP. Sekcja Breakdowns grupuje błędy według typu, źródła lub innych kryteriów, pokazując liczbę obok każdej kategorii w celu szybkiej selekcji.
• Tabela dziennika błędów (pośrodku) — Sortowalna tabela zawierająca wszystkie błędy z kolumnami podsumowującymi. Wyświetla łączną liczbę błędów w trzech przedziałach czasowych: Ostatnie 24 godziny, Ostatnie 7 dni i Wkrótce wygasające. Kliknij dowolny wiersz, aby wyświetlić pełne szczegóły.
• Panel akcji (po prawej) — Odśwież dziennik, utwórz eksport CSV do pobrania, usuń wybrane wpisy i skonfiguruj okres retencji.

Tabela dziennika błędów

Każdy wiersz błędu w tabeli zawiera następujące kolumny:

Kolumna	Opis
Error ID	Unikalny identyfikator wpisu w dzienniku błędów
Type	Kategoria błędu (np. DML_FAILED, QUERY_FAILED, FIELD_INSERT_FAILED, BATCH_EXECUTE_FAILED)
Message	Krótki opis błędu (skrócony — kliknij wiersz, aby zobaczyć pełny komunikat)
Source	Klasa Apex, która wygenerowała błąd (np. DQS_ExportFileService, DQS_DynamicQueryBuilder01)
Event Time	Znacznik czasu wystąpienia błędu

Na górze tabeli wyświetlane są liczniki agregowane — Total Errors, Last 24 Hours, Last 7 Days i Expiring Soon — dające ogólny przegląd kondycji systemu.

Modalne okno szczegółów wiersza

Kliknij dowolny wiersz błędu, aby otworzyć modalne okno szczegółów z pełnym kontekstem:

• Error ID i Type (wyróżnione na czerwono dla szybkiej identyfikacji)
• Source — źródłowa klasa Apex
• uniqueIdentifier_01 — powiązany rekord lub identyfikator wsadu
• Insert Type — czy operacja była insertem, aktualizacją lub innym typem DML
• Event Time i First Event Time — znaczniki czasu wystąpienia błędu
• Message — pełny komunikat błędu zawierający typ wyjątku Salesforce (np. System.AsyncException, System.DmlException)
• Stack Trace — kompletny ślad stosu Apex do debugowania

Źródła błędów

Źródło	Przykłady
Przetwarzanie wsadowe	Przekroczenie limitów gubernatorskich, timeout zapytania
Strategia wymiaru	Nieprawidłowy dostęp do pola, null pointer w logice strategii
Platform Events	Błąd publikacji zdarzenia
Harmonogramowanie	Problemy z wyrażeniem CRON, błędy uprawnień

Integracja Platform Events

DQS wykorzystuje zdarzenia platformy DQS_Processing_Error__e do wyświetlania błędów w czasie rzeczywistym. Gdy podczas przetwarzania wsadowego wystąpi błąd:

1. Błąd jest przechwytywany i rejestrowany
2. Publikowane jest zdarzenie platformy
3. EMC odbiera zdarzenie i wyświetla je

Zastępuje to ciche bloki catch widocznym raportowaniem błędów.

Retencja błędów

Logi błędów są automatycznie usuwane zgodnie ze skonfigurowanym okresem retencji. Domyślna retencja wynosi 7 dni.

Aby zmienić okres retencji, użyj sekcji Retention Configuration w panelu akcji po prawej stronie konsoli. Wprowadź żądaną liczbę dni w polu Error Log Retention (days) i kliknij Save. Logi błędów starsze niż określony okres będą automatycznie usuwane. Zmiany są wdrażane za pośrednictwem Metadata API i mogą chwilę potrwać.

Najlepsze praktyki

• Regularnie sprawdzaj EMC po skonfigurowaniu nowych definicji skanów
• Przeglądaj błędy po zmianie konfiguracji zdolności
• Wykorzystuj wzorce błędów do identyfikacji systematycznych problemów (np. uprawnienia dostępu do pól)
• Używaj licznika Expiring Soon, aby przeglądać błędy przed ich automatycznym usunięciem
• Eksportuj logi błędów do CSV przed ich wygaśnięciem, jeśli potrzebujesz zachować je do dłuższej analizy
• Skontaktuj się z pomocą techniczną, jeśli błędy platformy powtarzają się w wielu skanach