Włączanie rejestrowania diagnostycznego w usłudze Azure API for FHIR
W tym artykule dowiesz się, jak włączyć rejestrowanie diagnostyczne w usłudze Azure API for FHIR i zapoznać się z przykładowymi zapytaniami dotyczącymi tych dzienników. Dostęp do dzienników diagnostycznych jest niezbędny w przypadku każdej usługi opieki zdrowotnej, w której wymagana jest zgodność z wymaganiami prawnymi (takimi jak HIPAA). Funkcja w usłudze Azure API for FHIR, która włącza dzienniki diagnostyczne, to ustawienia diagnostyczne w Azure Portal.
Wyświetlanie i pobieranie danych metryk FHIR
Metryki można wyświetlić w obszarze Monitorowanie | Metryki z portalu. Metryki obejmują liczbę żądań, średnie opóźnienie, liczbę błędów, rozmiar danych, użyte jednostki żądań (RU), liczbę żądań, które przekroczyły pojemność, oraz dostępność (w %). Poniższy zrzut ekranu przedstawia jednostki RU używane dla przykładowego środowiska z kilkoma działaniami w ciągu ostatnich siedmiu dni. Dane można pobrać w formacie JSON.
Włączanie dzienników inspekcji
Aby włączyć rejestrowanie diagnostyczne w usłudze Azure API for FHIR, wybierz usługę Azure API for FHIR w Azure Portal
Przejdź do ustawień diagnostycznych
Wybierz pozycję + Dodaj ustawienie diagnostyczne
Wprowadź nazwę ustawienia
Wybierz metodę, której chcesz użyć, aby uzyskać dostęp do dzienników diagnostycznych:
- Archiwizowanie na koncie magazynu na potrzeby inspekcji lub ręcznej inspekcji. Konto magazynu, którego chcesz użyć, musi zostać już utworzone.
- Przesyłanie strumieniowe do centrum zdarzeń w celu pozyskiwania danych przez usługę innej firmy lub niestandardowe rozwiązanie analityczne. Przed skonfigurowaniem tego kroku należy utworzyć przestrzeń nazw centrum zdarzeń i zasady centrum zdarzeń.
- Przesyłanie strumieniowe do obszaru roboczego usługi Log Analytics w usłudze Azure Monitor. Zanim będzie można wybrać tę opcję, musisz utworzyć obszar roboczy usługi Logs Analytics.
Wybierz pozycję AuditLogs and/or AllMetrics (Dzienniki inspekcji i/lub Wszystkie metryki). Metryki obejmują nazwę usługi, dostępność, rozmiar danych, łączne opóźnienie, łączną liczbę żądań, łączną liczbę błędów i sygnaturę czasową. Więcej szczegółów na temat obsługiwanych metryk można znaleźć.
Wybierz pozycję Zapisz
Uwaga
Wyświetlenie pierwszych dzienników w usłudze Log Analytics może potrwać do 15 minut. Ponadto jeśli usługa Azure API for FHIR zostanie przeniesiona z jednej grupy zasobów lub subskrypcji do innej, zaktualizuj ustawienie po zakończeniu przenoszenia.
Aby uzyskać więcej informacji na temat pracy z dziennikami diagnostycznymi, zapoznaj się z dokumentacją dziennika zasobów platformy Azure
Szczegóły dziennika inspekcji
Obecnie usługa Azure API for FHIR zwraca następujące pola w dzienniku inspekcji:
| Nazwa pola | Typ | Uwagi |
|---|---|---|
| CallerIdentity | Dynamiczny | Worek właściwości ogólnej zawierający informacje o tożsamości |
| CallerIdentityIssuer | Ciąg | Wystawca |
| CallerIdentityObjectId | Ciąg | Object_id |
| CallerIPAddress | Ciąg | Adres IP wywołującego |
| CorrelationId | Ciąg | Identyfikator korelacji |
| FhirResourceType | Ciąg | Typ zasobu, dla którego wykonano operację |
| LogCategory | Ciąg | Kategoria dziennika (obecnie zwracamy dzienniki "AuditLogs" LogCategory) |
| Lokalizacja | Ciąg | Lokalizacja serwera, który przetworzył żądanie (na przykład Południowo-środkowe stany USA) |
| OperacjaDuration | int | Czas potrzebny na ukończenie tego żądania w sekundach |
| OperationName | Ciąg | Opisuje typ operacji (na przykład update, search-type) |
| Requesturi | Ciąg | Identyfikator URI żądania |
| ResultType | Ciąg | Dostępne wartości są obecnie Uruchomione, Powodzenie lub Niepowodzenie |
| Statuscode | int | Kod stanu HTTP. (na przykład 200) |
| TimeGenerated | DateTime | Data i godzina zdarzenia |
| Właściwości | Ciąg | Opisuje właściwości fhirResourceType |
| SourceSystem | Ciąg | System źródłowy (zawsze platforma Azure w tym przypadku) |
| TenantId | Ciąg | Identyfikator dzierżawy |
| Typ | Ciąg | Typ dziennika (zawsze MicrosoftHealthcareApisAuditLog w tym przypadku) |
| _Resourceid | Ciąg | Szczegółowe informacje o zasobie |
Przykładowe zapytania
Poniżej przedstawiono kilka podstawowych zapytań usługi Application Insights, których można użyć do eksplorowania danych dziennika.
Uruchom to zapytanie, aby wyświetlić 100 najnowszych dzienników:
MicrosoftHealthcareApisAuditLogs
| limit 100
Uruchom to zapytanie, aby grupować operacje według typu zasobu FHIR:
MicrosoftHealthcareApisAuditLogs
| summarize count() by FhirResourceType
Uruchom to zapytanie, aby uzyskać wszystkie nieudane wyniki
MicrosoftHealthcareApisAuditLogs
| where ResultType == "Failed"
Podsumowanie
Posiadanie dostępu do dzienników diagnostycznych jest niezbędne do monitorowania usługi i dostarczania raportów zgodności. Interfejs API platformy Azure dla standardu FHIR umożliwia wykonywanie tych akcji za pomocą dzienników diagnostycznych.
FHIR to zastrzeżony znak towarowy firmy HL7 i jest używany za jej pozwoleniem.
Następne kroki
W tym artykule przedstawiono sposób włączania dzienników inspekcji dla usługi Azure API for FHIR. Aby uzyskać informacje o ustawieniach konfiguracji usługi Azure API for FHIR, zobacz
FHIR® jest zastrzeżonym znakiem towarowym HL7 i jest używany z pozwoleniem HL7.