community.general.elastic callback – Создание распределённых трасс для каждой задачи Ansible в Elastic APM

Примечание

Этот плагин обратного вызова входит в коллекцию community.general (версия 12.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.general. Для использования этого плагина обратного вызова необходимы дополнительные требования. Подробнее см. в разделе Требования.

Чтобы использовать его в плейбуке, укажите: community.general.elastic.

Добавлено в community.general 3.8.0

Плагин обратного вызова
Краткое описание
Требования
Параметры
Примеры

Плагин обратного вызова

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

Краткое описание

Этот плагин создаёт распределённые трассы для каждой задачи Ansible в Elastic APM.
Плагин можно настроить с помощью переменных среды.
См. https://www.elastic.co/guide/en/apm/agent/python/current/configuration.html.

Требования

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

elastic-apm (библиотека Python)

Параметры

Параметр	Комментарии
apm_api_key строка	Использовать ключ API APM. Конфигурация: Переменная среды: `ELASTIC_APM_API_KEY`
apm_secret_token строка	Использовать токен сервера APM. Конфигурация: Переменная среды: `ELASTIC_APM_SECRET_TOKEN`
apm_server_url строка	Использовать сервер APM и его переменные среды. Конфигурация: Переменная среды: `ELASTIC_APM_SERVER_URL`
apm_service_name строка	Атрибут ресурса с именем службы. По умолчанию: `"ansible"` Конфигурация: Переменная среды: `ELASTIC_APM_SERVICE_NAME`
apm_verify_server_cert логический	Проверяет сертификат SSL при подключении по HTTPS. Варианты: `false` `true` ← (по умолчанию) Конфигурация: Переменная среды: `ELASTIC_APM_VERIFY_SERVER_CERT`
hide_task_arguments логический	Скрывать аргументы задачи. Варианты: `false` ← (по умолчанию) `true` Конфигурация: Переменная среды: `ANSIBLE_OPENTELEMETRY_HIDE_TASK_ARGUMENTS`
traceparent строка	Заголовок traceparent контекста трассировки W3C. Конфигурация: Переменная среды: `TRACEPARENT`

Примеры

examples: |-
  Enable the plugin in ansible.cfg:
    [defaults]
    callbacks_enabled = community.general.elastic

  Set the environment variable:
    export ELASTIC_APM_SERVER_URL=<your APM server URL)>
    export ELASTIC_APM_SERVICE_NAME=your_service_name
    export ELASTIC_APM_API_KEY=your_APM_API_KEY

Авторы

Victor Martinez (@v1v)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/elastic_callback.html