Diagnostische logboekregistratie inschakelen in Azure API for FHIR
In dit artikel leert u hoe u diagnostische logboekregistratie inschakelt in Azure API for FHIR en enkele voorbeeldquery's voor deze logboeken kunt bekijken. Toegang tot diagnostische logboeken is essentieel voor elke gezondheidszorgservice waarbij naleving van wettelijke vereisten (zoals HIPAA) een must is. De functie in Azure API for FHIR waarmee diagnostische logboeken worden ingeschakeld, zijn de diagnostische instellingen in de Azure Portal.
Metrische FHIR-gegevens weergeven en downloaden
U kunt de metrische gegevens bekijken onder Bewaking | Metrische gegevens uit de portal. De metrische gegevens omvatten Aantal aanvragen, Gemiddelde latentie, Aantal fouten, Gegevensgrootte, Gebruikte RU‘s, Aantal aanvragen dat de capaciteit heeft overschreden en Beschikbaarheid (in %). In de onderstaande schermopname ziet u ru's die zijn gebruikt voor een voorbeeldomgeving met weinig activiteiten in de afgelopen zeven dagen. U kunt de gegevens downloaden in JSON-indeling.
Auditlogboeken inschakelen
Als u diagnostische logboekregistratie wilt inschakelen in Azure API for FHIR, selecteert u uw Azure API for FHIR-service in de Azure Portal
Ga naar Diagnostische instellingen
Selecteer + Diagnostische instelling toevoegen.
Voer een naam in voor de instelling
Selecteer de methode die u wilt gebruiken voor toegang tot uw diagnostische logboeken:
- Archiveren naar een opslagaccount voor controle of handmatige inspectie. Het opslagaccount dat u wilt gebruiken, moet al zijn gemaakt.
- Stream naar Event Hub voor opname door een externe service of aangepaste analyseoplossing. U moet een Event Hub-naamruimte en Event Hub-beleid maken voordat u deze stap kunt configureren.
- Stream naar de Log Analytics-werkruimte in Azure Monitor. U moet uw Logs Analytics-werkruimte maken voordat u deze optie kunt selecteren.
Selecteer AuditLogs en/of AllMetrics. De metrische gegevens omvatten servicenaam, beschikbaarheid, gegevensgrootte, totale latentie, totale aanvragen, totale fouten en tijdstempel. U vindt meer informatie over ondersteunde metrische gegevens.
Selecteer Opslaan
Notitie
Het kan tot 15 minuten duren voordat de eerste logboeken worden weergegeven in Log Analytics. Als Azure API for FHIR van de ene resourcegroep of het ene abonnement naar de andere wordt verplaatst, werkt u de instelling bij zodra de verplaatsing is voltooid.
Raadpleeg de documentatie voor Azure-resourcelogboeken voor meer informatie over het werken met diagnostische logboeken
Details van auditlogboek
Op dit moment retourneert de Azure API for FHIR-service de volgende velden in het auditlogboek:
| Veldnaam | Type | Opmerkingen |
|---|---|---|
| CallerIdentity | Dynamisch | Een algemene eigenschappenverzameling met identiteitsgegevens |
| CallerIdentityIssuer | Tekenreeks | Verlener |
| CallerIdentityObjectId | Tekenreeks | Object_Id |
| CallerIPAddress | Tekenreeks | Het IP-adres van de beller |
| CorrelationId | Tekenreeks | Correlatie-id |
| FhirResourceType | Tekenreeks | Het resourcetype waarvoor de bewerking is uitgevoerd |
| LogCategory | Tekenreeks | De logboekcategorie (we retourneren momenteel 'AuditLogs' LogCategory) |
| Locatie | Tekenreeks | De locatie van de server die de aanvraag heeft verwerkt (bijvoorbeeld VS - zuid-centraal) |
| OperationDuration | Int | De tijd die nodig was om deze aanvraag in seconden te voltooien |
| OperationName | Tekenreeks | Beschrijft het type bewerking (bijvoorbeeld bijwerken, zoektype) |
| RequestUri | Tekenreeks | De aanvraag-URI |
| ResultType | Tekenreeks | De beschikbare waarden zijn Gestart, Geslaagd of Mislukt |
| Statuscode | Int | De HTTP-statuscode. (bijvoorbeeld 200) |
| TimeGenerated | DateTime | Datum en tijd van de gebeurtenis |
| Eigenschappen | Tekenreeks | Beschrijft de eigenschappen van het fhirResourceType |
| SourceSystem | Tekenreeks | Bronsysteem (in dit geval altijd Azure) |
| TenantId | Tekenreeks | Tenant-id |
| Type | Tekenreeks | Type logboek (in dit geval altijd MicrosoftHealthcareApisAuditLog) |
| _Resourceid | Tekenreeks | Details over de resource |
Voorbeeldquery's
Hier volgen enkele eenvoudige Application Insights-query's die u kunt gebruiken om uw logboekgegevens te verkennen.
Voer deze query uit om de 100 meest recente logboeken te bekijken:
MicrosoftHealthcareApisAuditLogs
| limit 100
Voer deze query uit om bewerkingen te groeperen op FHIR-resourcetype:
MicrosoftHealthcareApisAuditLogs
| summarize count() by FhirResourceType
Voer deze query uit om alle mislukte resultaten op te halen
MicrosoftHealthcareApisAuditLogs
| where ResultType == "Failed"
Conclusie
Toegang tot diagnostische logboeken is essentieel voor het bewaken van een service en het leveren van nalevingsrapporten. Met Azure API for FHIR kunt u deze acties uitvoeren via diagnostische logboeken.
FHIR is het gedeponeerde handelsmerk van HL7 en wordt gebruikt met de toestemming van HL7.
Volgende stappen
In dit artikel hebt u geleerd hoe u auditlogboeken inschakelt voor Azure API for FHIR. Zie voor informatie over configuratie-instellingen voor Azure API for FHIR
FHIR® is een gedeponeerd handelsmerk van HL7 en wordt gebruikt met toestemming van HL7.