IKuznetsov: Новая страница: «[https://github.com/influxdata/telegraf Telegraf] — это управляемый плагинами серверный агент для сбора, обр...»

2025-12-25T14:54:50Z

Новая страница: «[https://github.com/influxdata/telegraf Telegraf] — это управляемый плагинами серверный агент для сбора, обр...»

Новая страница

[https://github.com/influxdata/telegraf Telegraf] — это управляемый плагинами серверный агент для сбора, обработки, агрегирования и записи метрик. '''Telegraf''' поставляется с плагином вывода Ключ-АСТРОМ, который позволяет легко отправлять метрики '''Telegraf''' в Ключ-АСТРОМ.

== Включение приема данных Telegraf ==
Функция сбора метрик '''Telegraf''' доступна в ЕдиномАгенте версии 1.201 и выше. Самый простой вариант настройки — установить Telegraf и ЕдиныйАгент на одном хосте. В этом случае вам нужно будет только включить плагин вывода Ключ-АСТРОМ в конфигурации '''Telegraf''' (версия Telegraf 1.16 и выше) и включить сбор метрик '''Telegraf''' на уровне среды или хоста в конфигурации Ключ-АСТРОМ. Обратите внимание, что конфигурация на уровне хоста переопределяет конфигурацию на уровне среды.

== Включение плагин вывода Ключ-АСТРОМ в конфигурации Telegraf ==

=== Telegraf и ЕдиныйАгент установлены на одном хосте ===

# Отредактируйте [https://docs.influxdata.com/telegraf/v1/configuration/ файл конфигурации Telegraf] <code>telegraf.conf</code>.
# Прокомментируйте строку <code><nowiki>[[outputs.astromkey]]</nowiki></code>.
# <code>Необязательно</code> Прокомментируйте строку <code>prefix = "telegraf."</code> и установите префикс, чтобы легко находить метрики, полученные '''Telegraf'''. Префикс также будет виден в ключе метрики Ключ-АСТРОМ.
# Сохраните файл.

{| class="wikitable"
|# # Send telegraf metrics to a astromkey environment

outputs.astromkey

<nowiki>#</nowiki> ## For usage with the astromkey OneAgent you can omit any configuration,

<nowiki>#</nowiki> ## the only requirement is that the OneAgent is running on the same host.

<nowiki>#</nowiki> ## Only setup environment url and token if you want to monitor a Host without the OneAgent present.

<nowiki>#</nowiki> ##

<nowiki>#</nowiki> ## Your astromkey environment URL.

<nowiki>#</nowiki> ## For astromkey OneAgent you can leave this empty or set it to "<nowiki>http://127.0.0.1:14499/metrics/ingest</nowiki>" (default)

<nowiki>#</nowiki> ## For astromkey SaaS environments the URL scheme is "<nowiki>https://{your-environment-id}.live.astromkey.com/api/v2/metrics/ingest</nowiki>"

<nowiki>#</nowiki> ## For astromkey Managed environments the URL scheme is "<nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/metrics/ingest</nowiki>"

<nowiki>#</nowiki> url = ""

<nowiki>#</nowiki>

<nowiki>#</nowiki> ## Your astromkey API token.

<nowiki>#</nowiki> ## Create an API token within your astromkey environment, by navigating to Settings > Integration > astromkey API

<nowiki>#</nowiki> ## The API token needs data ingest scope permission. When using OneAgent, no API token is required.

<nowiki>#</nowiki> api_token = ""

<nowiki>#</nowiki>

<nowiki>#</nowiki> ## Optional prefix for metric names (e.g.: "telegraf.")

prefix = "telegraf."

<nowiki>#</nowiki>

<nowiki>#</nowiki> ## Optional TLS Config

<nowiki>#</nowiki> # tls_ca = "/etc/telegraf/ca.pem"

<nowiki>#</nowiki> # tls_cert = "/etc/telegraf/cert.pem"

<nowiki>#</nowiki> # tls_key = "/etc/telegraf/key.pem"

<nowiki>#</nowiki>

<nowiki>#</nowiki> ## Optional flag for ignoring tls certificate check

<nowiki>#</nowiki> # insecure_skip_verify = false

<nowiki>#</nowiki>

<nowiki>#</nowiki>

<nowiki>#</nowiki> ## Connection timeout, defaults to "5s" if not set.

<nowiki>#</nowiki> timeout = "5s"
|}

=== Если на хосте отсутствует ЕдиныйАгент ===
Если вам не удается установить ЕдиныйАгент на хост, контролируемый '''Telegraf''', вы можете настроить плагин вывода Ключ-АСТРОМ для прямой отправки метрик в вашу среду Ключ-АСТРОМ через [[API Кластера v2|Metrics API v2]].

==== Предварительные требования ====

* [[Токены доступа|API-токен]] с областью действия «'''Ввод метрик'''» .
* Идентификатор вашей среды .

# Отредактируйте [https://docs.influxdata.com/telegraf/v1/configuration/ файл конфигурации Telegraf] <code>telegraf.conf</code>.
# Прокомментируйте строку <code># <nowiki>[[outputs.astromkey]]</nowiki></code>.
# <code>Необязательно</code> Прокомментируйте строку <code># prefix = "telegraf."</code> и установите префикс, чтобы легко находить метрики, полученные '''Telegraf'''. Префикс также будет виден в ключе метрики Ключ-АСТРОМ.
# Прокомментируйте строку <code># api_token = ""</code> и добавьте свой API-токен, например <code>api_token = "abcdefjhij1234567890"</code>.
# Прокомментируйте строку <code># url = ""</code> и добавьте конечную точку API метрик Ключ-АСТРОМ. Например,
#* Ключ-АСТРОМ SaaS <code>url = "<nowiki>https://{your-environment-id}.live.astromkey.com/api/v2/metrics/ingest</nowiki>"</code>
#* Ключ-АСТРОМ Managed <code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/metrics/ingest</nowiki></code>
# Сохраните файл.

{| class="wikitable"
|# # Send telegraf metrics to a astromkey environment

outputs.astromkey

<nowiki>#</nowiki> ## For usage with the astromkey OneAgent you can omit any configuration,

<nowiki>#</nowiki> ## the only requirement is that the OneAgent is running on the same host.

<nowiki>#</nowiki> ## Only setup environment url and token if you want to monitor a Host without the OneAgent present.

<nowiki>#</nowiki> ##

<nowiki>#</nowiki> ## Your astromkey environment URL.

<nowiki>#</nowiki> ## For astromkey OneAgent you can leave this empty or set it to "<nowiki>http://127.0.0.1:14499/metrics/ingest</nowiki>" (default)

<nowiki>#</nowiki> ## For astromkey SaaS environments the URL scheme is "<nowiki>https://{your-environment-id}.live.astromkey.com/api/v2/metrics/ingest</nowiki>"

<nowiki>#</nowiki> ## For astromkey Managed environments the URL scheme is "<nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/metrics/ingest</nowiki>"

<nowiki>#</nowiki> url = "<nowiki>https://abd12345.live.astromkey.com/api/v2/metrics/ingest</nowiki>"

<nowiki>#</nowiki>

<nowiki>#</nowiki> ## Your astromkey API token.

<nowiki>#</nowiki> ## Create an API token within your astromkey environment, by navigating to Settings > Integration > astromkey API

<nowiki>#</nowiki> ## The API token needs data ingest scope permission. When using OneAgent, no API token is required.

<nowiki>#</nowiki> api_token = "abcdefjhij1234567890"

<nowiki>#</nowiki>

<nowiki>#</nowiki> ## Optional prefix for metric names (e.g.: "telegraf.")

prefix = "telegraf."

<nowiki>#</nowiki>

<nowiki>#</nowiki> ## Optional TLS Config

<nowiki>#</nowiki> # tls_ca = "/etc/telegraf/ca.pem"

<nowiki>#</nowiki> # tls_cert = "/etc/telegraf/cert.pem"

<nowiki>#</nowiki> # tls_key = "/etc/telegraf/key.pem"

<nowiki>#</nowiki>

<nowiki>#</nowiki> ## Optional flag for ignoring tls certificate check

<nowiki>#</nowiki> # insecure_skip_verify = false

<nowiki>#</nowiki>

<nowiki>#</nowiki>

<nowiki>#</nowiki> ## Connection timeout, defaults to "5s" if not set.

<nowiki>#</nowiki> timeout = "5s"
|}

== Включение на уровне среды ==

# Перейдите в '''Настройки''' и выберите '''Предпочтения''' > '''Контроллер выполнения расширений'''.
# Включите параметр '''Контроллер выполнения расширений''' .
# Включите '''локальный API для сбора HTTP-метрик, логов и событий'''.

== Включить для одного хоста ==

# Перейдите в раздел '''Хосты'''.
# Найдите и выберите свой хост, чтобы отобразить страницу обзора хоста.
# В правом верхнем углу страницы обзора хоста выберите «'''Дополнительно'''» '''( … )''' > '''Настройки'''.
# В настройках хоста выберите '''Контроллер выполнения расширений'''.
# Включите параметр '''Контроллер выполнения расширений'''.

== Включить для группы хостов ==

# Перейдите в раздел '''Статус развертывания''', а затем выберите ЕдиныйАгенты.
# На странице развертывания ЕдиногоАгента отключите параметр '''Показывать новые развертывания ЕдиногоАгента'''.
# Отфильтруйте таблицу <code>Host group</code> и выберите группу хостов, которую хотите настроить. Свойство '''Группа хостов''' не отображается, если выбранный хост не принадлежит ни к одной группе хостов. Здесь отображается страница развертывания ЕдиногоАгента, отфильтрованная по выбранной группе хостов. Для каждого хоста в списке есть ссылка '''Группа хостов''': <code><group name></code>, где <code><group name></code>— это имя группы хостов, которую вы хотите настроить.
# Выберите имя группы хостов в любой строке. Поскольку вы отфильтровали данные по группе хостов, все отображаемые хосты будут отнесены к одной и той же группе.
# В настройках группы хостов выберите '''Контроллер выполнения расширений'''.
# Включите параметр '''Контроллер выполнения расширений'''.

== Информация о топологии ==
При установке ЕдиногоАгента и '''Telegraf''' на одном хосте идентификатор хоста и контекст имени хоста автоматически добавляются к каждой метрике в качестве измерений. Узнайте, как [[Расширение данных|обогатить ваши метрики другими измерениями, специфичными для Ключ-АСТРОМ]], и применить детали причинно-следственной связи ИИ к вашим загруженным данным.

== Формат метрик ==
Предоставляемые данные должны соответствовать протоколу сбора метрик.

== Коммуникационный порт ==
Плагин вывода '''Telegraf''' Ключ-АСТРОМ отправляет метрики на конечную точку API метрик ЕдиногоАгента.

Порт приема метрик по умолчанию — <code>14499</code>. При необходимости вы можете использовать команду [[ЕдиныйАгент настройка через интерфейс командной строки|oneagentctl]] для проверки или изменения порта. Изменение порта приема метрик требует перезапуска OneAgent. Добавьте <code>--restart-service</code> к команде для автоматического перезапуска ЕдиногоАгента.

=== Проверьте вход данных ===
Параметр <code>--get-extensions-ingest-port</code> по умолчанию отображает текущий локальный порт приема данных <code>14499</code>.

* Linux , AIX : <code>./oneagentctl --get-extensions-ingest-port</code>
* Windows : <code>.\oneagentctl.exe --get-extensions-ingest-port</code>

=== Укажите пользовательский порт для приема данных ===
Используйте параметр <code>--set-extensions-ingest-port=<arg></code> для установки пользовательского локального порта приема данных.

* Linux , AIX : <code>./oneagentctl --set-extensions-ingest-port=14499 --restart-service</code>
* Windows : <code>.\oneagentctl.exe --set-extensions-ingest-port=14499 --restart-service</code>

=== Настройка прокси ===
Настройте прокси-сервер вашего хоста таким образом, чтобы по умолчанию разрешать трафик с локального хоста, направляемый на порт приема метрик <code>14499</code>.

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

# Отредактируйте [https://docs.influxdata.com/telegraf/v1/configuration/ файл конфигурации Telegraf] <code>telegraf.conf</code>.
# Установите свойство <code>url</code> в значение <code>url = "<nowiki>http://127.0.0.1</nowiki>:<your-custom-port>/metrics/ingest"</code>.
# Сохраните файл.

Обратите внимание, что изменение порта для получаемых метрик '''Telegraf''' также влияет на интеграцию ЕдиногоАгента REST API и скриптов.

Отправка метрик Telegraf в Ключ-АСТРОМ - История изменений

IKuznetsov: Новая страница: «[https://github.com/influxdata/telegraf Telegraf]﻿ — это управляемый плагинами серверный агент для сбора, обр...»

IKuznetsov: Новая страница: «[https://github.com/influxdata/telegraf Telegraf] — это управляемый плагинами серверный агент для сбора, обр...»