Включение ведения журнала диагностики в AZURE API для FHIR

Статья
2025-04-07

Это важно

Поддержка Azure API для FHIR будет прекращена 30 сентября 2026 г. Следуйте стратегиям миграции, чтобы перейти на сервис Azure Health Data Services FHIR® к указанному сроку. Из-за прекращения использования AZURE API для FHIR новые развертывания клиентов не будут разрешены с 1 апреля 2025 г. Служба Azure Health Data Services FHIR — это развивающаяся версия Azure API для FHIR, которая позволяет клиентам управлять службами FHIR, DICOM и MedTech с интеграцией с другими службами Azure.

В этой статье вы узнаете, как включить ведение журнала диагностики в AZURE API для FHIR® и просмотреть примеры запросов для этих журналов. Доступ к журналам диагностики является важным для любой службы здравоохранения, где соответствие нормативным требованиям (например, HIPAA) является обязательным. Функция в Azure API для FHIR, которая включает журналы диагностики, — это параметры диагностики на портале Azure.

Просмотр и скачивание данных метрик FHIR

Метрики можно просмотреть в разделе "Мониторинг" | Метрики на портале. Метрики включают количество запросов, средняя задержка, количество ошибок, размер данных, единицы запросов (ЕЗ), количество запросов, превышение емкости и доступность (в %). Метрики общего запроса предоставляют количество запросов, поступающих к службе FHIR. Это означает, что такие запросы, как пакеты FHIR, считаются одним запросом для ведения журнала.

На следующем снимке экрана показаны ЕЗ, используемые для примера среды с несколькими действиями за последние семь дней. Данные можно скачать в формате JSON.

Включение журналов аудита

Чтобы включить ведение журнала диагностики в Azure API для FHIR, выберите службу Azure API для FHIR на портале Azure.
Перейдите к параметрам диагностики
Выбор и добавление параметра диагностики
Введите имя параметра
Выберите метод, который вы хотите использовать для доступа к журналам диагностики:
1. Архивируйте учетную запись хранения для аудита или ручной проверки. Учетная запись хранения, которую вы хотите использовать, уже должна быть создана.
2. Потоковая передача в концентратор событий для приема сторонними службами или пользовательским аналитическим решением. Перед настройкой этого шага необходимо создать пространство имен концентратора событий и политику концентратора событий.
3. Потоковая передача в рабочую область Log Analytics в Azure Monitor. Прежде чем выбрать этот параметр, необходимо создать рабочую область Logs Analytics.
Выберите AuditLogs и(или ) AllMetrics. Метрики включают имя службы, доступность, размер данных, общую задержку, общий запрос, общий объем ошибок и метку времени. Дополнительные сведения о поддерживаемых метриках.
Выберите Сохранить

Примечание.

Для отображения первых журналов в Log Analytics может потребоваться до 15 минут. Кроме того, если AZURE API для FHIR перемещается из одной группы ресурсов или подписки в другую, обновите параметр после завершения перемещения.

Дополнительные сведения о работе с журналами диагностики см. в документации по журналу ресурсов Azure.

Сведения журнала аудита

В настоящее время служба Azure API для FHIR возвращает следующие поля в журнале аудита.

Имя поля	Тип	Примечания.
CallerIdentity	Динамический	Универсальный контейнер свойств, содержащий сведения об удостоверениях
CallerIdentityIssuer	Струна	Эмитент
ИдентификаторОбъектаЛичностиВызова (CallerIdentityObjectId)	Струна	Object_Id
IP-адрес вызывающего абонента	Струна	IP-адрес вызывающего объекта
CorrelationId	Струна	Идентификатор корреляции
Тип ресурса FHIR	Струна	Тип ресурса, для которого была выполнена операция
LogCategory	Струна	Категория журнала (в настоящее время возвращается ‘AuditLogs’ LogCategory)
Местоположение	Струна	Расположение сервера, обрабатывающего запрос (например, южная часть США)
Время выполнения	int	Время выполнения этого запроса в секундах. Примечание. Это значение всегда равно 0 из-за известной проблемы.
Наименование операции	Струна	Описывает тип операции (например, обновление, тип поиска)
RequestUri (URI запроса)	Струна	URI запроса...
ТипРезультата	Струна	Доступные значения в настоящее время: Запущен, Успешно выполнен или Не выполнен
Код статуса	int	Код состояния HTTP. (например, 200)
Время генерации	дата и время	Дата и время события
Свойства	Струна	Описание свойств типа ресурса FHIR
SourceSystem	Струна	Исходная система (всегда Azure в этом случае)
Идентификатор арендатора (TenantId)	Струна	Идентификатор арендатора
Тип	Струна	Тип журнала (всегда MicrosoftHealthcareApisAuditLog в этом случае)
_ИдентификаторРесурса	Струна	Сведения о ресурсе

Примеры запросов

Ниже приведены несколько базовых запросов Application Insights, которые можно использовать для изучения данных журнала.

Выполните следующий запрос, чтобы просмотреть последние 100 журналов.

MicrosoftHealthcareApisAuditLogs
| limit 100

Выполните следующий запрос для группирования операций по типу ресурса FHIR.

MicrosoftHealthcareApisAuditLogs 
| summarize count() by FhirResourceType

Выполните следующий запрос, чтобы получить все неудачные результаты.

MicrosoftHealthcareApisAuditLogs 
| where ResultType == "Failed"

Заключение

Доступ к журналам диагностики необходим для мониторинга службы и предоставления отчетов о соответствии. Azure API для FHIR позволяет выполнять эти действия с помощью журналов диагностики.