Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Important
Cette fonctionnalité est en version bêta.
Zerobus Ingest OTLP est un point de terminaison OTLP (OpenTelemetry Protocol) natif intégré au service Zerobus Ingest. Il vous permet de pousser des traces, des journaux et des métriques directement dans des tables Delta du catalogue Unity à l’aide des kits SDK OpenTelemetry standard et de collecteurs, sans avoir besoin de bibliothèques personnalisées.
Pour configurer votre client OTLP pour envoyer des données à Zerobus Ingest, consultez Configurer des clients OpenTelemetry (OTLP) pour envoyer des données au catalogue Unity.
Les concepts
Les concepts suivants sont utiles pour comprendre le fonctionnement de Zerobus Ingest OTLP.
Compatibilité OTLP
Zerobus Ingest OTLP implémente les services standard de collecteur OTLP tels que définis par la spécification OpenTelemetry. Tout exportateur compatible OTLP (par exemple, les kits SDK OpenTelemetry, le collecteur OpenTelemetry ou d’autres bibliothèques d’instrumentation) peut envoyer des données à ce point de terminaison.
Signaux pris en charge
Zerobus Ingest OTLP expose trois services OTLP/gRPC , un par type de signal de télémétrie :
| Signal | Chemin du service gRPC |
|---|---|
| Traces : étendues de trace distribuées avec prise en charge complète des événements, des liens et de l’état. | /opentelemetry.proto.collector.trace.v1.TraceService/Export |
Journaux d’activité : enregistrements de journal avec gravité, contenu et corrélation avec les traces via trace_id et span_id. |
/opentelemetry.proto.collector.logs.v1.LogsService/Export |
| Métriques : tous les cinq types de métriques OTLP : Jauge, Somme, Histogramme, ExponentielHistogramme et Résumé. | /opentelemetry.proto.collector.metrics.v1.MetricsService/Export |
Réussite partielle
Zerobus Ingest OTLP prend en charge la réussite partielle telle que définie par la spécification OTLP. Si une demande contient un mélange d’enregistrements valides et non valides, les enregistrements valides sont ingérés et les enregistrements non valides sont rejetés. La réponse inclut le nombre d’enregistrements rejetés (rejected_spans, rejected_log_recordsou rejected_data_points) et une error_message description de la raison.
Compression
La compression Gzip est prise en charge sur les trois services OTLP. Définissez l'en-tête grpc-encoding sur gzip, ou configurez votre exportateur OTLP pour utiliser la compression gzip.
Limites
- Seul le transport OTLP/gRPC (Protobuf) est pris en charge. HTTP (Protobuf) n’est pas encore pris en charge.
- Chaque requête cible une table, spécifiée à l’aide de l’en-tête
x-databricks-zerobus-table-name. Pour ingérer des traces, des logs et des métriques, configurez des exportateurs distincts qui pointent vers différentes tables. - Les tables doivent être créées à l’avance avec le schéma approprié. La fonctionnalité Zerobus Ingest ne crée ni ne modifie les tables.
- Le quota par défaut est de 10 000 requêtes par seconde. Si vous avez besoin d’un quota plus élevé, contactez votre représentant Databricks.
- Pour obtenir la liste complète des limitations d'ingestion Zerobus, consultez les limitations du connecteur Zerobus Ingest.
Étapes suivantes
- Configure OpenTelemetry (OTLP) clients pour envoyer des données à Unity Catalog — exemples Python et configuration du collecteur OpenTelemetry.
- Informations de référence sur la table OpenTelemetry pour l’ingestion Zerobus : schémas de table et référence de mappage de données.
- Interroger des données OpenTelemetry : exemples de requêtes SQL sur les spans, les journaux et les indicateurs.
- Limitations du connecteur d’ingestion Zerobus