IKuznetsov: Новая страница: «При приеме логов '''OpenTelemetry''' применяются следующие правила преобразования и ограничения...»

2025-09-08T21:59:17Z

Новая страница: «При приеме логов '''OpenTelemetry''' применяются следующие правила преобразования и ограничения...»

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

При приеме логов '''OpenTelemetry''' применяются следующие правила преобразования и ограничения приема.

== Типы данных ==
Ключ-АСТРОМ поддерживает тип данных '''OpenTelemetry''' по умолчанию <code>Any</code> для приема данных, который может принимать любое из следующих значений:

* Скалярные значения (строки, числа, логические значения)
* Массивы <code>Any</code>
* Байтовые массивы
* Сопоставления со строковыми ключами и значениями <code>Any</code>

=== Скалярное значение ===
Скалярные значения усваиваются в их строковом представлении.
{| class="wikitable"
!Тип
!Данные
!Принимается в виде
|-
|String
|"hello world"
|"hello world"
|-
|Number
|1234
|1234
|-
|Boolean
|false
|"false"
|}

=== Массив байтов ===
Массив байтов принимается как строка, закодированная в формате '''Base64'''. Например, следующий массив:
{| class="wikitable"
|[0x68, 0x65, 0x6c, 0x6c, 0x6f, 0x20, 0x77, 0x6f, 0x72, 0x6c, 0x64]
|}
преобразуется и принимактся как <code>aGVsbG8gd29yZA==</code>.

=== Множество ===
Массив <code>Any</code> принимается как есть, но каждое значение преобразуется следующим образом:

* Скалярные значения усваиваются в их строковом представлении (см. скалярное значение (выше)).
* Массивы байтов обрабатываются как строки '''Base64''' (см. массив байтов (выше)).
* Массивы <code>Any</code> и карты обрабатываются как строки, сериализованные в формате '''JSON''' (до пяти уровней).

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

Например, эта карта атрибутов <code>planet</code>:
{| class="wikitable"
|{

"name": "earth"

"system" : {

"name": "solar",

"galaxy": {

"name": "milky way",

"group": {

"name": "local"

}

}

}

}
|}
это можно свести к четырем атрибутам:
{| class="wikitable"
|"planet.name": "earth"

"planet.system.name": "solar"

"planet.system.galaxy.name": "milky way"

"planet.system.galaxy.group.name": "local"
|}

* Скалярные значения усваиваются в их строковом представлении (см. скалярное значение (выше)).
* Массивы байтов обрабатываются как строки '''Base64''' (см. массив байтов (выше)).
* Массивы <code>Any</code> обрабатываются как списки, а значения преобразуются в массивы.
* Карты выравниваются, как описано выше (до пяти уровней).

== Семантические атрибуты ==
Ключ-АСТРОМ автоматически распознает ряд имен атрибутов и сопоставляет их с соответствующими полями логов Ключ-АСТРОМ.

Например, если вы указываете атрибут <code>Timestamp</code>, его значение автоматически анализируется как дата и время этой записи логов.

Полный список атрибутов и их названий см. в разделе «Поддерживаемые семантические ключи атрибутов» в [[API мониторинг логов - POST прием логов]].

== Прием атрибутов ==
'''OpenTelemetry''' поддерживает атрибуты на разных уровнях в запросе логов '''OpenTelemetry''', такие как атрибуты ресурсов, атрибуты области действия и атрибуты записи.

Поскольку на стороне Ключ-АСТРОМ атрибуты сохраняются в сжатом виде, могут возникать конфликты имён, если атрибуты на разных уровнях имеют одно и то же имя. Ключ-АСТРОМ решает эту проблему, добавляя к дублирующимся атрибутам префикс <code>overwritten[COUNTER].</code>. Значение счётчика показывает, сколько раз имя атрибута уже встречалось как дубликат.

Например, если у вас есть три атрибута, все из которых поименованы <code>my.attribute</code> на уровнях ресурса, области действия и логов:

* атрибут ресурса принимается как <code>my.attribute</code>
* атрибут области действия принимается как <code>overwritten1.my.attribute</code>
* атрибут логов принимается как <code>overwritten2.my.attribute</code>

== Ограничения в приеме ==
Информацию об ограничениях, применяемых к принятым запросам логов, их атрибутам и значениям, см. в разделах [[Ограничения по умолчанию для управления логами и аналитики|Ограничения по умолчанию для управления логов и аналитики]] и [[Ограничения по умолчанию для мониторинга логов|Ограничения по умолчанию для мониторинга логов (Logs Classic)]].

Прием логов OpenTelemetry - История изменений

IKuznetsov: Новая страница: «При приеме логов '''OpenTelemetry''' применяются следующие правила преобразования и ограничения...»