IKuznetsov в 04:36, 8 октября 2025

2025-10-08T04:36:18Z

← Предыдущая версия		Версия от 04:36, 8 октября 2025
Строка 40:		Строка 40:
	exporters:		exporters:

	otlphttp/~~dynatrace~~:		otlphttp/astromkey:

	endpoint: ${env:DT_ENDPOINT}		endpoint: ${env:DT_ENDPOINT}
Строка 58:		Строка 58:
	processors: []		processors: []

	exporters: [otlphttp/~~dynatrace~~]		exporters: [otlphttp/astromkey]
	\|}		\|}

Строка 102:		Строка 102:
	Для этой цели мы устанавливаем следующие две переменные среды и ссылаемся на них в значениях конфигурации для <code>endpoint</code> и <code>Authorization</code>.		Для этой цели мы устанавливаем следующие две переменные среды и ссылаемся на них в значениях конфигурации для <code>endpoint</code> и <code>Authorization</code>.

	* <code>DT_ENDPOINT</code> содержит базовый [[Экспорт с помощью OTLP\|URL-адрес конечной точки API Ключ-АСТРОМ]] (например, <code><nowiki>https://{your-environment-id}.live.~~dynatrace~~.com/api/v2/otlp</nowiki></code>)		* <code>DT_ENDPOINT</code> содержит базовый [[Экспорт с помощью OTLP\|URL-адрес конечной точки API Ключ-АСТРОМ]] (например, <code><nowiki>https://{your-environment-id}.live.astromkey.com/api/v2/otlp</nowiki></code>)
	* <code>DT_API_TOKEN</code> содержит токен API		* <code>DT_API_TOKEN</code> содержит токен API

	=== Сервисные контейнеры ===		=== Сервисные контейнеры ===
	В <code>service</code> в конечном итоге мы собираем наши объекты приемника и экспортера в контейнер трассировок, который будет непрерывно отслеживать настроенные файлы и загружать их записи в Ключ-АСТРОМ с помощью OTLP.		В <code>service</code> в конечном итоге мы собираем наши объекты приемника и экспортера в контейнер трассировок, который будет непрерывно отслеживать настроенные файлы и загружать их записи в Ключ-АСТРОМ с помощью OTLP.

IKuznetsov: Новая страница: «В следующем примере конфигурации показано, как настроить экземпляр '''Collector''' для монитор...»

2025-10-08T04:35:54Z

Новая страница: «В следующем примере конфигурации показано, как настроить экземпляр '''Collector''' для монитор...»

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

В следующем примере конфигурации показано, как настроить экземпляр '''Collector''' для мониторинга файлов логов и отправки записей логов в бэкэнд Ключ-АСТРОМ.

== Предустановка ==

* Один из следующих дистрибутивов '''Collector''' с [https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.136.0/receiver/filelogreceiver приемником Filelog] :
** [[Collector Ключ-АСТРОМ|'''Collector''' Ключ-АСТРОМ]]
** [[Collector Ключ-АСТРОМ|OpenTelemetry Contrib]]
** [[Collector Ключ-АСТРОМ|Пользовательская версия Builder]]
* [[Экспорт с помощью OTLP|URL-адрес конечной точки API Ключ-АСТРОМ]], на которую следует экспортировать данные.
* [[Экспорт с помощью OTLP|Токен API]] с соответствующей областью доступа (требуется только для '''SaaS''' и АктивногоШлюза)

Информацию о настройке '''Collector''' с использованием указанной ниже конфигурации см. в разделах [[Развертывание Collector|Развертывание коллектора]] и [[Настройка Collector|Конфигурация коллектора]].

== Демо конфигурация ==
{| class="wikitable"
|receivers:

filelog:

include: [ /path/to/file.log ]

start_at: beginning

operators:

- type: regex_parser

regex: '^(?P<nowiki><time>\d{4}-\d{2}-\d{2}) (?P<sev>[A-Z]*) (?P<msg>.*)$'</nowiki>

timestamp:

parse_from: attributes.time

layout: '%Y-%m-%d'

severity:

parse_from: attributes.sev

exporters:

otlphttp/dynatrace:

endpoint: ${env:DT_ENDPOINT}

headers:

"Authorization": "Api-Token ${env:DT_API_TOKEN}"

service:

pipelines:

logs:

receivers: [filelog]

processors: []

exporters: [otlphttp/dynatrace]
|}

== Пример файла логов ==
Для демонстрационной конфигурации, представленной выше, мы анализируем файл <code>file.log</code> в следующем формате:
{| class="wikitable"
|1970-01-01 INFO Something routine

1970-01-01 ERROR Some error occurred!

1970-01-01 DEBUG Some details...
|}
Каждая строка начинается с временной метки '''ISO 8601''', за которой следует уровень серьезности записи и заканчивается сообщением логов.

Мы разбираем каждую строку на отдельные части с помощью следующего регулярного выражения:
{| class="wikitable"
|^(?P<nowiki><time>\d{4}-\d{2}-\d{2}) (?P<sev>[A-Z]*) (?P<msg>.*)$</nowiki>
|}
Помимо двух утверждений начала (<code>^</code>) и конца (<code>$</code>) строки, у нас есть следующие именованные группы захвата:

* <code>(?P<nowiki><time>\d{4}-\d{2}-\d{2})</nowiki></code>— Присваивает имя своей группе захвата <code>time</code> и сопоставляет ее с типичной временной меткой '''ISO 8601'''.
* <code>(?P<sev>[A-Z]*)</code>— Именует свою группу захвата <code>sev</code> и сопоставляет произвольное количество латинских заглавных символов.
* <code>(?P<msg>.*)</code>— Присваивает имя своей группе захвата <code>msg</code> и сопоставляет ее с произвольным количеством символов.

== Компоненты ==
Для нашей конфигурации мы используем следующие компоненты.

=== Приемники ===
В разделе <code>receivers</code> мы указываем приемник <code>filelog</code>, как активный компонент приемника для нашего экземпляра '''Collector'''.

Приёмник '''Filelog''' поддерживает [https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/v0.136.0/receiver/filelogreceiver/README.md ряд параметров конфигурации], позволяющих настраивать его поведение. В нашем примере мы используем следующие:

* <code>include</code>— Указывает шаблон пути к файлам, которые мы хотим загрузить.
* <code>start_at</code>— Указывает, должен ли получатель читать файл с начала или, только для самых последних записей, с конца.
* <code>operators</code>— Настраивает операторы, применяемые к каждой записи логов. В нашем примере мы используем оператор '''[https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/v0.136.0/pkg/stanza/docs/operators/regex_parser.md regex_parser]''' для извлечения информации с помощью регулярного выражения.
** <code>regex</code>— Задаёт фактическое регулярное выражение. Используя именованные группы захвата (<code>(?P<name>)</code>), получатель делает захваченные данные доступными под соответствующим именем <code>attributes</code>.
** <code>timestamp</code>— Указывает, откуда брать временную метку записи (поле регулярного выражения <code>time</code>) и формат даты.
** <code>severity</code>— Указывает, откуда брать уровень серьезности записи (поле регулярного выражения <code>sev</code>).

=== Экспортеры ===
В разделе <code>exporters</code> мы указываем [https://github.com/open-telemetry/opentelemetry-collector/tree/v0.136.0/exporter/otlphttpexporter экспортер по умолчанию <code>otlphttp</code>] и настраиваем его с помощью URL-адреса нашего API Ключ-АСТРОМ и требуемого токена аутентификации.

Для этой цели мы устанавливаем следующие две переменные среды и ссылаемся на них в значениях конфигурации для <code>endpoint</code> и <code>Authorization</code>.

* <code>DT_ENDPOINT</code> содержит базовый [[Экспорт с помощью OTLP|URL-адрес конечной точки API Ключ-АСТРОМ]] (например, <code><nowiki>https://{your-environment-id}.live.dynatrace.com/api/v2/otlp</nowiki></code>)
* <code>DT_API_TOKEN</code> содержит токен API

=== Сервисные контейнеры ===
В <code>service</code> в конечном итоге мы собираем наши объекты приемника и экспортера в контейнер трассировок, который будет непрерывно отслеживать настроенные файлы и загружать их записи в Ключ-АСТРОМ с помощью OTLP.

Получение данных из файла логов - История изменений

IKuznetsov в 04:36, 8 октября 2025

IKuznetsov: Новая страница: «В следующем примере конфигурации показано, как настроить экземпляр '''Collector''' для монитор...»