Ativar o Registo de Diagnósticos na API do Azure para FHIR
Neste artigo, irá aprender a ativar o registo de diagnósticos na API do Azure para FHIR e a rever algumas consultas de exemplo para estes registos. O acesso aos registos de diagnóstico é essencial para qualquer serviço de saúde em que a conformidade com os requisitos regulamentares (como a HIPAA) seja obrigatória. A funcionalidade na API do Azure para FHIR que ativa os registos de diagnóstico são as Definições de diagnóstico no portal do Azure.
Ver e Transferir Dados de Métricas do FHIR
Pode ver as métricas em Monitorização | Métricas do portal. As métricas incluem Número de Pedidos, Latência Média, Número de Erros, Tamanho dos Dados, RUs Utilizadas, Número de pedidos que excederam a capacidade e Disponibilidade (em %). A captura de ecrã abaixo mostra as RUs utilizadas para um ambiente de exemplo com poucas atividades nos últimos sete dias. Pode transferir os dados no formato Json.
Ativar registos de auditoria
Para ativar o registo de diagnósticos na API do Azure para FHIR, selecione a API do Azure para o serviço FHIR no portal do Azure
Navegar para Definições de diagnóstico
Selecione Adicionar definição de diagnóstico
Introduza um nome para a definição
Selecione o método que pretende utilizar para aceder aos registos de diagnóstico:
- Arquivar numa conta de armazenamento para auditoria ou inspeção manual. A conta de armazenamento que pretende utilizar tem de ser criada.
- Transmitir em fluxo para o hub de eventos para ingestão por um serviço de terceiros ou uma solução de análise personalizada. Terá de criar um espaço de nomes do hub de eventos e uma política do hub de eventos antes de poder configurar este passo.
- Transmitir em fluxo para a área de trabalho do Log Analytics no Azure Monitor. Terá de criar a área de trabalho do Logs Analytics antes de poder selecionar esta opção.
Selecione AuditLogs e/ou AllMetrics. As métricas incluem o nome do serviço, disponibilidade, tamanho dos dados, latência total, total de pedidos, erros totais e carimbo de data/hora. Pode encontrar mais detalhes sobre as métricas suportadas.
Selecione Guardar
Nota
Os primeiros Registos poderão demorar até 15 minutos a serem apresentados no Log Analytics. Além disso, se a API do Azure para FHIR for movida de um grupo de recursos ou subscrição para outro, atualize a definição assim que a movimentação estiver concluída.
Para obter mais informações sobre como trabalhar com registos de diagnóstico, veja a documentação do Registo de Recursos do Azure
Detalhes do registo de auditoria
Neste momento, a API do Azure para o serviço FHIR devolve os seguintes campos no registo de auditoria:
| Nome do Campo | Tipo | Notas |
|---|---|---|
| CallerIdentity | Dinâmica | Um saco de propriedades genérico que contém informações de identidade |
| CallerIdentityIssuer | String | Emissor |
| CallerIdentityObjectId | String | Object_Id |
| CallerIPAddress | String | O endereço IP do autor da chamada |
| CorrelationId | String | ID de Correlação |
| FhirResourceType | String | O tipo de recurso para o qual a operação foi executada |
| LogCategory | String | A categoria de registo (estamos atualmente a devolver o LogCategory dos "AuditLogs") |
| Localização | String | A localização do servidor que processou o pedido (por exemplo, E.U.A. Centro-Sul) |
| OperationDuration | int | O tempo que demorou a concluir este pedido em segundos |
| OperationName | String | Descreve o tipo de operação (por exemplo, atualizar, tipo de pesquisa) |
| RequestUri | String | O URI do pedido |
| ResultType | String | Os valores disponíveis atualmente são Iniciado, Bem-sucedido ou Falhado |
| StatusCode | int | O código de estado HTTP. (por exemplo, 200) |
| TimeGenerated | DateTime | Data e hora do evento |
| Propriedades | String | Descreve as propriedades do fhirResourceType |
| SourceSystem | String | Sistema de Origem (sempre O Azure neste caso) |
| TenantId | String | ID do inquilino |
| Tipo | String | Tipo de registo (sempre MicrosoftHealthcareApisAuditLog neste caso) |
| _ResourceId | String | Detalhes sobre o recurso |
Consultas de exemplo
Seguem-se algumas consultas básicas do Application Insights que pode utilizar para explorar os seus dados de registo.
Execute esta consulta para ver os 100 registos mais recentes :
MicrosoftHealthcareApisAuditLogs
| limit 100
Execute esta consulta para agrupar operações por Tipo de Recurso FHIR:
MicrosoftHealthcareApisAuditLogs
| summarize count() by FhirResourceType
Execute esta consulta para obter todos os resultados falhados
MicrosoftHealthcareApisAuditLogs
| where ResultType == "Failed"
Conclusão
Ter acesso aos registos de diagnóstico é essencial para monitorizar um serviço e fornecer relatórios de conformidade. A API do Azure para FHIR permite-lhe realizar estas ações através de registos de diagnóstico.
FHIR é a marca registada do HL7 e é utilizada com a permissão do HL7.
Passos seguintes
Neste artigo, aprendeu a ativar os Registos de Auditoria da API do Azure para FHIR. Para obter informações sobre as definições de configuração da API do Azure para FHIR, consulte
FHIR® é uma marca registada do HL7 e é utilizada com a permissão de HL7.