Руководство по устранению неполадок агента Azure Monitor на сервере Windows с поддержкой Arc

  • Статья

Общие сведения об агенте Azure Monitor

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

Терминология

name Сокращение Описание
Агент Azure Monitor AMA Новый агент Azure Monitor
Правила сбора данных DCR Правила для настройки сбора данных агентом, т. е. правила, касающихся собираемых данных, назначения, в которое они отправляются, и многого другого
Служба настройки Azure Monitor AMCS Региональная служба, размещенная в Azure, которая управляет сбором данных для этого агента и других компонентов Azure Monitor. Агент вызывает эту службу для получения правил DCR.
Конечная точка журналов -- Конечная точка для отправки данных в рабочие области Log Analytics.
Конечная точка метрик -- Конечная точка для отправки данных в базы данных метрик Azure Monitor
Служба метаданных экземпляров и гибридная среда IMDS и HIMDS Службы, размещенные в Azure, которые предоставляют сведения о работающих сейчас виртуальных машинах, масштабируемых наборах (через IMDS) и серверах с поддержкой Arc (через HIMDS) соответственно.
Рабочая область Log Analytics LAW Назначение в Azure Monitor, в которое вы можете отправлять журналы, собранные агентом
Пользовательские метрики -- Назначение в Azure Monitor, в которое вы можете отправлять гостевые метрики, собранные агентом

Основные действия по устранению неполадок (установка, агент не запущен, проблемы с конфигурацией)

Выполните следующие действия, чтобы устранить неполадки с последней версией агента Azure Monitor, работающей на сервере Windows с поддержкой Arc:

  1. Внимательно изучите предварительные требования, приведенные здесь.

  2. Убедитесь, что расширение успешно установлено и подготовлено, что предусматривает установку двоичных файлов агента на вашем компьютере:

    1. Откройте портал Azure > выберите сервер > с поддержкой Arc. Откройте параметры: расширения в области слева > "AzureMonitorWindowsAgent" должно отобразиться с состоянием "Успешно"
    2. В противном случае проверьте, может ли агент Arc (агент подключенного компьютера) подключиться к Azure и запущена ли служба расширений. 
      azcmagent show
      Вы должны увидеть приведенный ниже результат.
      Resource Name                           : <server name>
[...]
Dependent Service Status
  Agent Service (himds)                 : running
  GC Service (gcarcservice)             : running
  Extension Service (extensionservice)  : running
      Если вместо этого вы видите состояние Agent Status: Disconnected или какое-либо другое, отправьте запрос, указав в качестве сводки "Агент Arc или служба расширений не работает", а в качестве типа проблемы — "Требуется помощь с агентом Azure Monitor для Windows".
    3. Подождите 10–15 минут, так как расширение может находиться в состоянии перехода. Если расширение по-прежнему не отображается, удалите и установите расширение еще раз и повторите проверку, чтобы убедиться в том, что расширение отображается.
    4. Если это не помогло, проверьте, отображаются ли сообщения об ошибках в журналах расширений, расположенных в папке C:\ProgramData\GuestConfig\extension_logs\Microsoft.Azure.Monitor.AzureMonitorWindowsAgent на вашем компьютере.
    5. Если ни один из указанных выше способов не поможет, создайте запрос. Для этого введите в поле Сводка фразу "AMA extension fails to install or provision" (Расширение AMA не удается установить или подготовить), а в поле Тип проблемы — "I need help with Azure Monitor Windows Agent" (Мне нужна помощь с агентом Azure Monitor для Windows).

  3. Проверьте, работает ли агент:

    1. Проверьте, генерирует ли агент журналы пульса в рабочую область Log Analytics, используя приведенный ниже запрос. Пропустите этот шаг, если единственным назначением в DCR являются "Пользовательские метрики":
      Heartbeat | where Category == "Azure Monitor Agent" and Computer == "<computer-name>" | take 10
    2. В противном случае откройте диспетчер задач и проверьте, запущен ли процесс MonAgentCore.exe. Если это так, подождите 5 минут, чтобы отобразился пульс.
    3. Если этого не произошло, проверьте, отображаются ли сообщения об ошибках в основных журналах агента, расположенных в папке C:\Resources\Directory\AMADataStore\Configuration на вашем компьютере.
    4. Если ни один из указанных выше способов не поможет, создайте запрос. Для этого введите в поле Сводка фразу "AMA extension provisioned but not running" (Расширение AMA подготовлено, но не работает), а в поле Тип проблемы — "I need help with Azure Monitor Windows Agent" (Мне нужна помощь с агентом Azure Monitor для Windows).

  4. Убедитесь, что DCR заданы и связаны с сервером с поддержкой Arc:

    1. При использовании рабочей области Log Analytics в качестве назначения убедитесь, что DCR существует в том же физическом регионе, что и рабочая область Log Analytics.
    2. На сервере с поддержкой Arc проверьте наличие файла C:\Resources\Directory\AMADataStore\mcs\mcsconfig.latest.xml. Если этот файл не существует, возможно, сервер с поддержкой Arc не связан с DCR.
    3. Откройте портал Azure > выберите правило > сбора данных Открыть конфигурацию: ресурсы в области слева > Должен отобразиться сервер с поддержкой Arc.
    4. Если он не указан, нажмите кнопку "Добавить" и выберите нужный сервер с поддержкой Arc в средстве выбора ресурсов. Повторите эти действия для всех правил DCR.
    5. Если ни один из указанных выше способов не поможет, создайте запрос. Для этого введите в поле Сводка фразу "DCR not found or associated" (Правило DCR не найдено или не привязано), а в поле Тип проблемы — "I need help configuring data collection from a VM" (Мне нужна помощь в настройке сбора данных с виртуальной машины).

  5. Убедитесь, что агенту удалось скачать связанные правила DCR из службы AMCS:

    1. Проверьте, отображается ли последнее скачанное правило DCR в этом расположении: C:\Resources\Directory\AMADataStore\mcs\configchunks.
    2. Если это не так, создайте запрос. Для этого введите в поле Сводка фразу "AMA unable to download DCR config" (AMA не удается скачать конфигурацию DCR), а в поле Тип проблемы — "I need help with Azure Monitor Windows Agent" (Мне нужна помощь с агентом Azure Monitor для Windows).

Проблемы со сбором данных счетчиков производительности

  1. Убедитесь, что в файле JSON правила сбора данных есть раздел performanceCounters. Если он отсутствует, исправьте DCR. Узнайте, как создать DCR или ознакомьтесь с примером DCR.
  2. Убедитесь, что файл C:\Resources\Directory\AMADataStore\mcs\mcsconfig.lkg.xml существует. Если его нет, создайте запрос. Для этого введите в поле Сводка фразу "AMA didn't run long enough to mark" (AMA недостаточно долго работал, чтобы пометить его), а в поле Тип проблемы — "I need help with Azure Monitor Windows Agent" (Мне нужна помощь с агентом Azure Monitor для Windows).
  3. Откройте файл и проверьте, содержит ли он узлы CounterSet, как показано в следующем примере:
    <CounterSet storeType="Local" duration="PT1M" 
    eventName="c9302257006473204344_16355538690556228697" 
    sampleRateInSeconds="15" format="Factored">
    <Counter>\Processor(_Total)\% Processor Time</Counter>
    <Counter>\Memory\Committed Bytes</Counter>
    <Counter>\LogicalDisk(_Total)\Free Megabytes</Counter>
    <Counter>\PhysicalDisk(_Total)\Avg. Disk Queue Length</Counter>
</CounterSet>
    Если узлов CounterSet нет, значит правило сбора данных не было правильно обработано. Создайте запрос. Для этого введите в поле Сводка фразу "AMA unable to parse DCR config" (AMA не может обработать конфигурацию DCR), а в поле Тип проблемы — "I need help with Azure Monitor Windows Agent" (Мне нужна помощь с агентом Azure Monitor для Windows).

Проблемы с использованием пользовательских метрик в качестве назначения

  1. Внимательно изучите предварительные требования, приведенные здесь.

  2. Убедитесь, что связанные DCR правильно созданы, чтобы собирать данные счетчиков производительности и передавать их в метрики Azure Monitor. В DCR должен присутствовать такой раздел:

    "destinations": {  
"azureMonitorMetrics": {  
    "name":"myAmMetricsDest" 
    } 
}

  3. Выполните следующую команду PowerShell:

    Get-WmiObject Win32_Process -Filter "name = 'MetricsExtension.Native.exe'" | select Name,ExecutablePath,CommandLine | Format-List

    Убедитесь, что в выходных данных параметр CommandLine содержит аргумент -TokenSource MSI.

  4. Убедитесь в наличии файла C:\Resources\Directory\AMADataStore\mcs\AuthToken-MSI.json.

  5. Убедитесь в наличии файла C:\Resources\Directory\AMADataStore\mcs\CUSTOMMETRIC_<subscription>_<region>_MonitoringAccount_Configuration.json.

  6. Соберите журналы, выполнив команду C:\Packages\Plugins\Microsoft.Azure.Monitor.AzureMonitorWindowsAgent\<version-number>\Monitoring\Agent\table2csv.exe C:\Resources\Directory\AMADataStore\Tables\MaMetricsExtensionEtw.tsf.

    1. В результате будет создан файл MaMetricsExtensionEtw.csv.
    2. Откройте его, найдите любые ошибки уровня 2 и попробуйте их устранить.

  7. Если ни один из указанных выше способов не поможет, создайте запрос. Для этого введите в поле Сводка фразу "AMA unable to collect custom metrics" (AMA не может собирать пользовательские метрики), а в поле Тип проблемы — "I need help with Azure Monitor Windows Agent" (Мне нужна помощь с агентом Azure Monitor для Windows).

Проблемы со сбором журналов событий Windows

  1. Убедитесь, что в файле JSON правила сбора данных есть раздел windowsEventLogs. Если он отсутствует, исправьте DCR. Узнайте, как создать DCR или ознакомьтесь с примером DCR.
  2. Убедитесь, что файл C:\Resources\Directory\AMADataStore\mcs\mcsconfig.lkg.xml существует. Если его нет, создайте запрос. Для этого введите в поле Сводка фразу "AMA didn't run long enough to mark" (AMA недостаточно долго работал, чтобы пометить его), а в поле Тип проблемы — "I need help with Azure Monitor Windows Agent" (Мне нужна помощь с агентом Azure Monitor для Windows).
  3. Откройте файл и проверьте, содержит ли он узлы Subscription, как показано в следующем примере:
    <Subscription eventName="c9302257006473204344_14882095577508259570" 
query="System!*[System[(Level = 1 or Level = 2 or Level = 3)]]">
    <Column name="ProviderGuid" type="mt:wstr" defaultAssignment="00000000-0000-0000-0000-000000000000">
      <Value>/Event/System/Provider/@Guid</Value>
    </Column>
    ...

    </Column>
</Subscription>
    Если узлов Subscription нет, значит правило сбора данных не было правильно обработано. Создайте запрос. Для этого введите в поле Сводка фразу "AMA unable to parse DCR config" (AMA не может обработать конфигурацию DCR), а в поле Тип проблемы — "I need help with Azure Monitor Windows Agent" (Мне нужна помощь с агентом Azure Monitor для Windows).

Создание запроса

  1. Откройте правило сбора данных и в меню слева выберите Новый запрос на поддержку. Вы также можете открыть панель Справка и поддержка и выбрать Создать запрос на поддержку.
  2. Выберите
    • Тип проблемы: технический.
    • Подписка. Выберите подписку, в которой находятся компьютеры.
    • Тип службы: правила сбора данных и агент Azure Monitor.
    • Связана ли ваша проблема с ресурсом?: Да. Выберите компьютер с помощью средства выбора ресурсов.
  3. Введите Сводка и Тип проблемы , как указано в шагах по устранению неполадок. Точная информация позволяет быстрее решить проблему.
  4. Нажмите кнопку Далее и просмотрите рекомендуемые решения, чтобы узнать, помогут ли они.
  5. Если они не помогли, нажмите кнопку Далее и заполните следующий набор сведений.
  6. Нажмите кнопку Далее, просмотрите окончательные сведения и нажмите кнопку Создать.