Прием данных OpenTelemetry с помощью Zerobus Ingest

Zerobus Ingest OTLP — это собственная конечная точка Протокола OpenTelemetry (OTLP), встроенная в службу Zerobus Ingest. Это позволяет отправлять трассировки, журналы и метрики непосредственно в таблицы каталога Unity Delta, используя стандартные SDK и сборщики OpenTelemetry, без необходимости в пользовательских библиотеках.

Для настройки клиента OTLP для отправки данных в приемник Zerobus см. в статье Настройка клиентов OpenTelemetry (OTLP) для отправки данных в Zerobus Ingest.

Azure Databricks выставляет счета за прием данных OTLP как за использование Zerobus Ingest. Для ценообразования и отслеживания расходов см. раздел «Стоимость».

Основные понятия

Следующие понятия полезны для понимания работы Zerobus Ingest OTLP.

Совместимость OTLP

Zerobus Ingest OTLP реализует стандартные сервисы OTLP Collector, определённые спецификацией OpenTelemetry, как через gRPC, так и через HTTP (Protobuf). Любой совместимый с OTLP экспортер, такой как OpenTelemetry SDK, OpenTelemetry Collector или другая библиотека инструментов, может отправлять данные на эту конечную точку.

Поддерживаемые сигналы

Zerobus Ingest OTLP показывает один сервис на каждый тип телеметрического сигнала . Каждый сигнал доступен как через OTLP/gRPC , так и через OTLP/HTTP (Protobuf):

Сигнал Путь к службе gRPC HTTP-путь
Трассировки: распределенные протяженности трассировки с полной поддержкой событий, ссылок и состояния. /opentelemetry.proto.collector.trace.v1.TraceService/Export /v1/traces
Журналы: записи журнала с уровнем серьезности, содержанием и корреляцией с трассировками через trace_id и span_id. /opentelemetry.proto.collector.logs.v1.LogsService/Export /v1/logs
Метрики: все пять типов метрик OTLP: Гейдж, Сумма, Гистограмма, Экспоненциальная гистограмма и Сводка. /opentelemetry.proto.collector.metrics.v1.MetricsService/Export /v1/metrics

Частичный успех

Zerobus Ingest OTLP поддерживает частичный успех, определенный спецификацией OTLP. Если запрос содержит сочетание допустимых и недопустимых записей, допустимые записи принимаются и недопустимые записи отклоняются. Ответ включает количество отклоненных записей (rejected_spansилиrejected_log_recordsrejected_data_points) и error_message описание причин.

Сжатие

Сжатие Gzip поддерживается во всех трёх сервисах OTLP, как через gRPC, так и через HTTP. Для gRPC установите для заголовка grpc-encoding значение gzip. Для HTTP установите заголовок Content-Encoding в значение gzip. Или настройте ваш OTLP-экспортер на gzip-компрессию.

Ограничения

  • Поддерживается только кодировка Protobuf для OTLP/HTTP. OTLP/HTTP с телом JSON не поддерживается, а запросы с Content-Type типа application/json отклоняются.
  • Каждый запрос предназначен для одной таблицы, указанной с помощью заголовка x-databricks-zerobus-table-name . Чтобы получить трассировку, журналы и метрики, настройте отдельных экспортеров, указывающих на разные таблицы.
  • Таблицы необходимо создать заранее с правильной схемой. Zerobus Ingest не создает и не изменяет таблицы.
  • Квота по умолчанию составляет 10 000 запросов в секунду. Если требуется более высокая квота, обратитесь к представителю Databricks.
  • Некоторые числовые поля OTLP могут терять точность или переполняться при сопоставлении с типами Delta. См. Числовая точность и знаковые типы.
  • Полный список квот Zerobus Ingest см. в статье Квоты Zerobus Ingest.

Дополнительные ресурсы

  • Last updated on