Параметры диагностики в Azure Monitor

Параметры диагностики в Azure Monitor можно использовать для сбора журналов ресурсов и отправки метрик платформы и журнала действий в различные назначения. Создайте отдельный параметр диагностики для каждого ресурса, из которого требуется собирать данные. Каждый параметр определяет данные из ресурса для сбора и назначения для отправки этих данных. В этой статье описываются сведения о параметрах диагностики, включая их создание и направления, доступные для отправки данных.

В следующем видео показано, как выполнить маршрутизацию журналов платформы ресурсов с параметрами диагностики. Следующие изменения были внесены в параметры диагностики с момента записи видео, но эти разделы рассматриваются в этой статье.

• Партнеры Azure Monitor
• Группы категорий

Sources

Параметры диагностики могут собирать данные из источников в следующей таблице. Дополнительные сведения о данных, собираемых каждым источником, и об их формате в каждом назначении смотрите в связанной статье.

Destinations

Параметры диагностики отправляют данные в пункты назначения, указанные в следующей таблице. Чтобы обеспечить безопасность передаваемых данных, все конечные точки назначения настроены для поддержки TLS 1.2.

Один параметр диагностики может определять не более одного из каждого назначения. Если вы хотите отправить данные в несколько определенных типов назначения (например, две рабочие области Log Analytics), создайте несколько параметров. Каждый ресурс может иметь до пяти параметров диагностики.

Все пункты назначения, которые использует параметр диагностики, должны существовать перед созданием этого параметра. Назначение не должно находиться в той же подписке, что и ресурс, который отправляет журналы, если пользователь, который настраивает параметр, имеет соответствующий доступ на основе ролей Azure (RBAC) к обеим подпискам. Используйте Azure Lighthouse для включения назначений в другой клиент Microsoft Entra.

Методы создания диагностической среды

Вы можете создать параметр диагностики с помощью любого из следующих методов.

Сведения о создании параметра диагностики для журнала действий с помощью портала Azure см. в разделе "Экспорт журнала действий". Сведения о создании параметра диагностики для группы управления см. в разделе "Параметры диагностики группы управления".

$KV = Get-AzKeyVault -ResourceGroupName <resource group name> -VaultName <key vault name>
$Law = Get-AzOperationalInsightsWorkspace -ResourceGroupName <resource group name> -Name <workspace name>  # LAW name is case sensitive

$metric = New-AzDiagnosticSettingMetricSettingsObject -Enabled $true -Category AllMetrics
$log = New-AzDiagnosticSettingLogSettingsObject -Enabled $true -CategoryGroup allLogs  # use audit for only audit logs
New-AzDiagnosticSetting -Name 'KeyVault-Diagnostics' -ResourceId $KV.ResourceId -WorkspaceId $Law.ResourceId -Log $log -Metric $metric -Verbose

az monitor diagnostic-settings create  \
--name KeyVault-Diagnostics \
--resource /subscriptions/<subscription ID>/resourceGroups/<resource group name>/providers/Microsoft.KeyVault/vaults/mykeyvault \
--logs    '[{"category": "AuditEvent","enabled": true}]' \
--metrics '[{"category": "AllMetrics","enabled": true}]' \
--storage-account /subscriptions/<subscription ID>/resourceGroups/<resource group name>/providers/Microsoft.Storage/storageAccounts/<storage account name> \
--workspace /subscriptions/<subscription ID>/resourcegroups/<resource group name>/providers/microsoft.operationalinsights/workspaces/<log analytics workspace name> \
--event-hub-rule /subscriptions/<subscription ID>/resourceGroups/<resource group name>/providers/Microsoft.EventHub/namespaces/<event hub namespace>/authorizationrules/RootManageSharedAccessKey \
--event-hub <event hub name> \
--export-to-resource-specific true

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "scope": {
        "type": "string"
    },
    "workspaceId": {
        "type": "string"
    },
    "settingName": {
        "type": "string"
    }
},
  "resources": [
    {
      "type": "Microsoft.Insights/diagnosticSettings",
      "apiVersion": "2021-05-01-preview",
      "scope": "[parameters('scope')]",
      "name": "[parameters('settingName')]",
      "properties": {
       "workspaceId": "[parameters('workspaceId')]",
      "logs": [
             {
            "category": null,
            "categoryGroup": "audit",
            "enabled": true
          }
        ]
      }
    }
  ]
  }

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "settingName": {
        "value": "audit3"
    },
    "workspaceId": {
      "value": "/subscriptions/<subscription id>/resourcegroups/<resourcegroup name>/providers/microsoft.operationalinsights/workspaces/<workspace name>"
    },
    "scope": {
      "value": "Microsoft.<resource type>/<resourceName>"
    }
  }
}

Группы категорий

Группы категорий можно использовать для сбора журналов ресурсов на основе предопределенных групп вместо выбора отдельных категорий журналов. Корпорация Майкрософт определяет группы для мониторинга распространенных вариантов использования. Если категории в группе обновляются, коллекция журналов изменяется автоматически.

Не все службы Azure используют группы категорий. Если группы категорий недоступны для определенного ресурса, параметр не будет доступен при создании параметра диагностики.

Если вы используете группы категорий в параметре диагностики, вы не можете выбрать отдельные типы категорий. Сейчас существует две группы категорий:

• allLogs: все имеющиеся категории для ресурса.
• audit: все журналы ресурсов, которые записывают взаимодействие клиента с данными или параметрами службы. Вам не нужно выбирать эту группу категорий, если вы выберете группу категорий allLogs.

Ограничения метрик

Не все метрики можно отправлять в рабочую область Log Analytics с параметрами диагностики. См. столбец "Экспортируемый" в списке поддерживаемых метрик.

Параметры диагностики в настоящее время не поддерживают многомерные метрики. Метрики с измерениями экспортируются в виде одномерных плоских метрик и агрегируются по значениям измерений. Например, метрика IOReadBytes в блокчейне может быть исследована и отображена на уровне узла. При экспорте метрики с параметрами диагностики отображаются все байты чтения для всех узлов.

Чтобы обойти ограничения для конкретных метрик, их можно извлечь вручную с помощью REST API метрик. Затем их можно импортировать в рабочую область Log Analytics с помощью API приема журналов.

Управление затратами

Может потребоваться плата за данные, собираемые параметрами диагностики. Стоимость зависит от выбранного назначения и объема собранных данных. Дополнительные сведения см. в разделе о ценах на Azure Monitor.

Соберите только категории, необходимые для каждой службы. Вы также можете не собирать метрики платформы из ресурсов Azure, так как эти данные уже собираются в метриках. Настройте диагностические данные для сбора метрик только в том случае, если вам нужны данные метрик в рабочей области для более сложного анализа с помощью запросов журналов.

Параметры диагностики не позволяют детализировать фильтрацию в выбранной категории. Данные можно фильтровать для поддерживаемых таблиц в рабочей области Log Analytics с помощью преобразований. Дополнительные сведения см. в разделе "Преобразования" в Azure Monitor.

Время доставки данных до места назначения

После создания параметра диагностики данные должны начинать поступать на выбранные цели в течение 90 минут. При отправке данных в рабочую область Log Analytics таблица создается автоматически, если она еще не существует. Таблица создается только в том случае, если места назначения принимают первые записи журнала.

Если вы не получаете информации в течение 24 часов, может возникнуть одна из следующих проблем:

• Журналы не создаются.
• Что-то неправильно в базовом механизме маршрутизации.

Попробуйте отключить конфигурацию, а затем повторно выполнить ее. Если проблема продолжается, обратитесь в службу поддержки Azure через портал Azure.

Application Insights

Рассмотрим следующие сведения о параметрах диагностики для приложений Application Insights:

• Пункт назначения не может быть той же рабочей областью Log Analytics, на которой основан ресурс Application Insights.
• Пользователь Application Insights не может иметь доступ к обеим рабочим областям. Установите для Log Analytics режим управления доступом на 'Требуются разрешения рабочей области'. С помощью Azure RBAC убедитесь, что пользователь имеет доступ только к той рабочей области Log Analytics, которая связана с ресурсом Application Insights.

Эти действия необходимы, так как Application Insights обращается к данным между ресурсами, чтобы обеспечить полные комплексные операции транзакций и точные карты приложений. К этим ресурсам относятся рабочие области Log Analytics. Так как журналы диагностики используют одинаковые имена таблиц, повторяющиеся данные могут отображаться, если у пользователя есть доступ к нескольким ресурсам, содержащим одни и те же данные.

Troubleshooting

Категория метрик не поддерживается

При использовании шаблона Resource Manager, REST API, Azure CLI или Azure PowerShell вы можете получить сообщение об ошибке, подобное "Категория метрики 'xxxx' не поддерживается". Категории метрик, отличные от AllMetrics, не поддерживаются, за исключением ограниченного количества служб Azure. Удалите все имена категорий метрик, кроме AllMetrics, и повторите развертывание.

Параметр исчезает из-за символов, отличных от ASCII, в идентификаторе ресурса

Параметры диагностики не поддерживают идентификаторы ресурсов с символами, отличными от ASCII (например, Preproduccón). Так как вы не можете переименовать ресурсы в Azure, необходимо создать новый ресурс без символов, отличных от ASCII. Если персонажи находятся в группе ресурсов, ресурсы можно переместить в новую группу.

Ресурс неактивен

Если ресурс неактивен и экспортирует метрики нулевого значения, механизм экспорта параметров диагностики отключается постепенно, чтобы избежать ненужных затрат на экспорт и хранение нулевого значения. Это может привести к задержке в экспорте следующего ненулевого значения. Это поведение применяется только к экспортируемым метрикам и не влияет на оповещения на основе метрик или автомасштабирование.

Если ресурс неактивен в течение одного часа, механизм экспорта отключается до 15 минут. Эта ситуация означает, что может возникнуть задержка до 15 минут для экспорта следующего ненулевого значения. Ресурс достигает максимального времени задержки в два часа после семи дней бездействия. После того как ресурс начнет экспортировать ненулевое значение, механизм экспорта возвращается к исходной задержке экспорта в течение трех минут.

Связанный контент

• Переход с хранения параметров диагностики на управление жизненным циклом служба хранилища Azure
• Источники данных Azure Monitor и методы сбора данных