Habilitar o Log de Diagnósticos na API do Azure para FHIR
Neste artigo, você aprenderá a habilitar o log de diagnóstico na API do Azure para FHIR e poderá examinar algumas consultas de exemplo para esses logs. O acesso aos logs de diagnóstico é essencial para qualquer serviço de saúde em que a conformidade com os requisitos regulatórios (como HIPAA) seja obrigatória. O recurso na API do Azure para FHIR que habilita os logs de diagnóstico são as Configurações de diagnóstico no portal do Azure.
Exibir e baixar dados de métricas do FHIR
Você pode exibir as métricas em Monitoramento | Métricas do portal. As métricas incluem o número de solicitações, a latência média, o número de erros, o tamanho dos dados, os RUs usados, o número de solicitações que excederam a capacidade e a disponibilidade (em %). A captura de tela abaixo mostra as RUs usadas para um ambiente de exemplo com poucas atividades nos últimos sete dias. Você pode baixar os dados no formato Json.
Habilitar logs de auditoria
Para habilitar o log de diagnóstico na API do Azure para FHIR, selecione o serviço da API do Azure para FHIR no portal do Azure
Navegue até Configurações de diagnóstico
Selecione + Adicionar configuração de diagnóstico
Insira um nome para a configuração
Selecione o método que você deseja usar para acessar seus logs de diagnóstico:
- Arquive em uma conta de armazenamento para auditoria ou inspeção manual. A conta de armazenamento que você deseja usar já precisa ser criada.
- Transmita para o hub de eventos para ingestão por um serviço de terceiros ou uma solução analítica personalizada. Você precisará criar um namespace do hub de eventos e uma política de hub de eventos antes de configurar essa etapa.
- Transmita para o workspace do Log Analytics no Azure Monitor. Você precisará criar seu Workspace do Logs Analytics antes de selecionar essa opção.
Selecione AuditLogs e/ou AllMetrics. As métricas incluem nome do serviço, disponibilidade, tamanho dos dados, latência total, total de solicitações, total de erros e carimbo de data/hora. Você pode encontrar mais detalhes sobre as métricas com suporte.
Selecione Salvar
Observação
Pode levar até 15 minutos para que os primeiros logs sejam exibidos no Log Analytics. Além disso, se a API do Azure para FHIR for movida de um grupo de recursos ou assinatura para outra, atualize a configuração depois que a movimentação for concluída.
Para obter mais informações sobre como trabalhar com logs de diagnóstico, consulte a documentação do Log de Recursos do Azure
Detalhes do log de auditoria
Neste momento, o serviço da API do Azure para FHIR retorna os seguintes campos no log de auditoria:
| Nome do campo | Type | Observações |
|---|---|---|
| CallerIdentity | Dinâmico | Um recipiente 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 chamador |
| 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 log (estamos retornando 'AuditLogs' LogCategory) |
| Local | String | O local do servidor que processou a solicitação (por exemplo, Centro-Sul dos EUA) |
| OperationDuration | int | O tempo necessário para concluir essa solicitação em segundos |
| OperationName | String | Descreve o tipo de operação (por exemplo, atualização, tipo de pesquisa) |
| RequestUri | String | O URI de solicitação |
| ResultType | String | Os valores disponíveis atualmente são Iniciado, Bem-sucedido ou Com Falha |
| StatusCode | int | O código de status do 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 nesse caso) |
| TenantId | String | ID do locatário |
| Type | String | Tipo de log (sempre MicrosoftHealthcareApisAuditLog neste caso) |
| _ResourceId | String | Detalhes sobre o recurso |
Consultas de exemplo
Aqui estão algumas consultas básicas do Application Insights que você pode usar para explorar seus dados de log.
Execute esta consulta para ver os 100 logs 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 com falha
MicrosoftHealthcareApisAuditLogs
| where ResultType == "Failed"
Conclusão
Ter acesso aos logs de diagnóstico é essencial para monitorar um serviço e fornecer relatórios de conformidade. A API do Azure para FHIR permite que você execute essas ações por meio de logs de diagnóstico.
FHIR é uma marca registrada da HL7, usada com permissão da HL7.
Próximas etapas
Neste artigo, você aprendeu a habilitar logs de auditoria para a 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 registrada da HL7 e é usado com a permissão da HL7.