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

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

Схема, показывающая коллекцию журналов действий, журналов ресурсов и метрик платформы.

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

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

Sources

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

Destinations

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

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

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

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

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

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

$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>"
        }
    }
}

param scope string
param workspaceId string
param settingName string

resource diag 'Microsoft.Insights/diagnosticSettings@2021-05-01-preview' = {
    name: settingName
    scope: scope
    properties: {
      workspaceId: workspaceId
      logs: [
          {
              category: null
              categoryGroup: 'audit'
              enabled: true
          }
      ]
    }
}

using './<template-file-name>.bicep'

param settingName = 'audit3'

param workspaceId = '/subscriptions/<subscription id>/resourcegroups/<resourcegroup name>/providers/microsoft.operationalinsights/workspaces/<workspace name>'

param scope = 'Microsoft.<resource type>/<resourceName>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Application Insights

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

• Назначение не может быть той же рабочей областью #REF!, на которой основан ваш ресурс Application Insights.
• Пользователь Application Insights не может иметь доступ к обеим рабочим областям. Задайте для режима управления доступом #REF! значение Требует разрешений рабочего пространства. Через #REF! RBAC убедитесь, что пользователь имеет доступ только к рабочей области #REF!, который используется ресурсом Application Insights.

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

Troubleshooting

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

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

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

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

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

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

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

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

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