Включение ведения журнала диагностики в Azure API для FHIR
Из этой статьи вы узнаете, как включить ведение журнала диагностики в Azure API для FHIR и просмотреть некоторые примеры запросов для этих журналов. Доступ к журналам диагностики имеет важное значение для любой службы здравоохранения, где необходимо соблюдать нормативные требования (например, HIPAA). Функция Azure API для FHIR, которая включает журналы диагностики, — это параметры диагностики в портал Azure.
Просмотр и скачивание данных метрик FHIR
Метрики можно просмотреть в разделе Мониторинг | Метрики на портале. Метрики включают число запросов, среднюю задержку, число ошибок, размер данных, используемое число ЕЗ, число запросов, превышающих емкость, и доступность (в %). На снимке экрана ниже показаны ЕЗ, используемые для примера среды с небольшим количеством действий за последние семь дней. Вы можете скачать данные в формате Json.
Включение журналов аудита
Чтобы включить ведение журнала диагностики в Azure API для FHIR, выберите службу Azure API для FHIR в портал Azure
Перейдите к параметрам диагностики.
Щелкните команду Добавить параметр диагностики.
Введите имя параметра.
Выберите метод, который вы хотите использовать для доступа к журналам диагностики:
- Архивация в учетную запись хранения для аудита или проверки вручную. Учетная запись хранения, которую вы хотите использовать, должна быть уже создана.
- Потоковая передача в концентратор событий для приема сторонней службой или пользовательским аналитическим решением. Перед настройкой этого шага необходимо создать пространство имен концентратора событий и политику концентратора событий.
- Выполните потоковую передачу в рабочую область Log Analytics в Azure Monitor. Прежде чем выбрать этот параметр, необходимо создать рабочую область Logs Analytics.
Выберите AuditLogs и (или ) AllMetrics. Метрики включают имя службы, доступность, размер данных, общую задержку, общее количество запросов, общее количество ошибок и метку времени. Вы можете найти дополнительные сведения о поддерживаемых метриках.
Нажмите кнопку Сохранить.
Примечание
Отображение первых журналов в Log Analytics может занять до 15 минут. Кроме того, если API Azure для FHIR перемещается из одной группы ресурсов или подписки в другую, обновите параметр после завершения перемещения.
Дополнительные сведения о работе с журналами диагностики см. в документации по журналу ресурсов Azure.
Сведения журнала аудита
В настоящее время служба Azure API для FHIR возвращает следующие поля в журнале аудита:
| Имя поля | Тип | Примечания |
|---|---|---|
| CallerIdentity | Динамический | Универсальный контейнер свойств, содержащий сведения об удостоверениях. |
| CallerIdentityIssuer | Строковый тип | Издатель |
| CallerIdentityObjectId | Строка | Object_Id |
| CallerIPAddress | Строка | IP-адрес вызывающего абонента |
| CorrelationId | Строка | Идентификатор корреляции |
| FhirResourceType | Строка | Тип ресурса, для которого была выполнена операция. |
| LogCategory | Строка | Категория журнала (в настоящее время мы возвращаем LogCategory AuditLogs) |
| Расположение | Строка | Расположение сервера, обрабатывающего запрос (например, центрально-южная часть США) |
| OperationDuration | Int | Время, необходимое для выполнения этого запроса в секундах |
| OperationName | Строка | Описывает тип операции (например, обновление, тип поиска) |
| RequestUri | Строка | URI запроса |
| ResultType | Строка | Доступные значения: Запущено, Успешно или Сбой. |
| StatusCode | Int | Код состояния HTTP. (например, 200) |
| TimeGenerated | Дата и время | Дата и время события |
| Свойства | Строка | Описывает свойства fhirResourceType. |
| SourceSystem | Строковый тип | Исходная система (в этом случае всегда Azure) |
| TenantId | Строка | Tenant ID |
| Тип | Строка | Тип журнала (в данном случае всегда MicrosoftHealthcareApisAuditLog) |
| _ResourceId | Строка | Сведения о ресурсе |
Примеры запросов
Ниже приведены несколько основных запросов Application Insights, которые можно использовать для изучения данных журнала.
Выполните этот запрос, чтобы просмотреть 100 последних журналов:
MicrosoftHealthcareApisAuditLogs
| limit 100
Выполните этот запрос, чтобы сгруппировать операции по типу ресурса FHIR:
MicrosoftHealthcareApisAuditLogs
| summarize count() by FhirResourceType
Выполните этот запрос, чтобы получить все неудачные результаты
MicrosoftHealthcareApisAuditLogs
| where ResultType == "Failed"
Заключение
Доступ к журналам диагностики имеет важное значение для мониторинга службы и предоставления отчетов о соответствии требованиям. Api Azure для FHIR позволяет выполнять эти действия с помощью журналов диагностики.
FHIR — это зарегистрированная торговая марка организации HL7, которая используется с разрешения HL7.
Дальнейшие действия
Из этой статьи вы узнали, как включить журналы аудита для API Azure для FHIR. Сведения о параметрах конфигурации Azure API для FHIR см. в разделе
FHIR® является зарегистрированным товарным знаком HL7 и используется с разрешения HL7.