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

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

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

Вы можете просмотреть метрики в разделе Мониторинг | Метрики с портала. Метрики включают число запросов, среднюю задержку, число ошибок, размер данных, используемый протокол RUs, число запросов, превышающих емкость, и доступность (в%). На следующем снимке экрана показана поддержка, которая используется для примера среды с очень небольшими действиями за последние семь дней. Данные можно скачать в формате JSON.

Azure API для метрик FHIR на портале

Включить журналы аудита

  1. Чтобы включить ведение журнала диагностики в Azure API для FHIR, выберите службу API Azure для службы FHIR в портал Azure

  2. Перейдите к параметрам диагностики .

    Добавьте параметры диагностики Azure FHIR.

  3. Выберите + Добавить параметр диагностики

  4. Введите имя параметра

  5. Выберите метод, который вы хотите использовать для доступа к журналам диагностики:

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

    Параметры диагностики Azure FHIR. Выберите AuditLogs и (или) Аллметрикс.

  7. Нажмите кнопку Сохранить.

Примечание

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

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

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

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

Имя поля Тип Примечания
каллеридентити Динамический Контейнер универсальных свойств, содержащий сведения об удостоверении
каллеридентитиссуер Строка Издатель
каллеридентитйобжектид Строка Object_Id
каллерипаддресс Строка IP-адрес вызывающего
CorrelationId Строка Идентификатор корреляции
фхирресаурцетипе Строка Тип ресурса, для которого была выполнена операция
логкатегори Строка Категория журнала (в настоящее время возвращается "AuditLogs" Логкатегори)
Расположение Строка Расположение сервера, который обработал запрос (например, Юго-Центральный регион США)
оператиондуратион Int Время, затраченное на выполнение этого запроса в секундах
OperationName Строка Описывает тип операции (например, обновление, тип поиска).
RequestUri Строка URI запроса
ResultType Строка Доступные значения в настоящее время запущены, успешно или не пройдены
StatusCode Int Код состояния HTTP. (например, 200)
TimeGenerated Дата/время Дата и время события
Свойства Строка Описание свойств Фхирресаурцетипе
SourceSystem Строка Исходная система (в этом случае всегда используется Azure)
TenantId Строка Идентификатор клиента
Тип Строка Тип журнала (всегда Микрософсеалскареаписаудитлог в этом случае)
_ResourceId Строка Сведения о ресурсе

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

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

Выполните этот запрос, чтобы просмотреть 100 последних журналов:

MicrosoftHealthcareApisAuditLogs
| limit 100

Выполните этот запрос, чтобы сгруппировать операции по типу ресурса FHIR:

MicrosoftHealthcareApisAuditLogs 
| summarize count() by FhirResourceType

Выполните этот запрос, чтобы получить все Невыполненные результаты .

MicrosoftHealthcareApisAuditLogs 
| where ResultType == "Failed" 

Заключение

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

FHIR — это зарегистрированная торговая марка организации HL7, которая используется с разрешения HL7.

Дальнейшие действия

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