datadog

Роль Ansible для агента Datadog

Роль Ansible для агента Datadog устанавливает и настраивает агента Datadog и интеграции.

Роль Ansible и коллекция Ansible

Роль Ansible для агента Datadog доступна через 2 канала:

Как часть коллекции Datadog, доступной под именем datadog.dd на Ansible Galaxy (рекомендуется).
Как отдельная роль, доступная под именем datadog.datadog на Ansible Galaxy (устаревшая).

Версия 4 роли и версия 5 коллекции устанавливают агента Datadog v7 по умолчанию.

Установка

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

Требования

Требуется Ansible версии 2.6 или выше.
Поддерживает большинство дистрибутивов Linux на базе Debian и RHEL, а также macOS и Windows.
При использовании Ansible 2.10 и выше для управления Windows хостами требуется установить коллекцию ansible.windows:
```
ansible-galaxy collection install ansible.windows
```
При использовании Ansible 2.10 и выше для управления хостами openSUSE/SLES требуется установить коллекцию community.general:
```
ansible-galaxy collection install community.general
```

Установка

Установите [роль Datadog][1] с Ansible Galaxy на ваш Ansible сервер:

ansible-galaxy install datadog.datadog

Чтобы развернуть агента Datadog на хостах, добавьте роль Datadog и ваш API ключ в ваш плейбук:

- hosts: servers
  roles:
    - { role: datadog.datadog, become: yes }
  vars:
    datadog_api_key: "<YOUR_DD_API_KEY>"

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

Переменные роли

Эти переменные обеспечивают дополнительную конфигурацию во время установки агента Datadog. Их следует указывать в разделе vars вашего плейбука.

Переменная	Описание
`datadog_api_key`	Ваш API ключ Datadog. Эта переменная обязательна начиная с версии 4.21.
`datadog_site`	Сайт для отправки данных агента Datadog. По умолчанию `datadoghq.com`, можно установить на `datadoghq.eu` для отправки данных на сайт ЕС. Доступно только для версии агента >= 6.6.0.
`datadog_agent_flavor`	Переопределяет стандартный Debian / RedHat пакет для установок IoT на RPI. По умолчанию "datadog-agent" - используйте "datadog-iot-agent" для RPI.
`datadog_agent_version`	Зафиксированная версия агента для установки (необязательно, но рекомендуется), например: `7.16.0`. Если используется `datadog_agent_version`, устанавливать `datadog_agent_major_version` не требуется.
`datadog_agent_major_version`	Основная версия агента для установки. Возможные значения: 5, 6 или 7 (по умолчанию). Если установлено `datadog_agent_version`, применяется это значение, иначе будет установлена последняя версия.
`datadog_checks`	YAML-формат конфигурации для проверок агента.
`datadog_disable_untracked_checks`	Установите `true`, чтобы удалить все проверки, отсутствующие в `datadog_checks` и `datadog_additional_checks`.
`datadog_additional_checks`	Список дополнительных проверок, которые не удаляются, если установлено `datadog_disable_untracked_checks`.
`datadog_disable_default_checks`	Установите `true`, чтобы удалить все стандартные проверки.
`datadog_config`	Установите конфигурацию для агента Datadog. Роль записывает конфигурацию в правильное место в зависимости от операционной системы.
`datadog_config_ex`	(Необязательно) Дополнительные INI секции для файла `/etc/dd-agent/datadog.conf` (только для версии 5 агента).
`datadog_apt_repo`	Переопределите стандартное репозиторий `apt` Datadog. Убедитесь, что используется опция `signed-by`, если метаданные репозитория подписаны ключами Datadog: `deb [signed-by=/usr/share/keyrings/datadog-archive-keyring.gpg] https://yourrepo`.
`datadog_apt_cache_valid_time`	Переопределите стандартное время истечения кэша apt (по умолчанию 1 час).
`datadog_yum_gpgcheck`	Переопределяет стандартное значение `repo_gpgcheck` (пустое). Если пустое, значение динамически устанавливается в `yes`, когда не используется пользовательский `datadog_yum_repo`.

...и другие переменные.

Интеграции

Чтобы настроить интеграцию Datadog (проверку), добавьте запись в раздел datadog_checks. Первый уровень ключей - это имя проверки, а значение - это YAML-данные для записи в конфигурационный файл.

Для установки или удаления интеграции обратитесь к параграфу datadog_integration.

...и так далее по содержимому.