datadog

Lesen Sie Logs über die Datadog Logs Search API in OTLP-förmige Tabellen

Maintainer: smithclay

Installation und Laden

INSTALL datadog FROM community;
LOAD datadog;

Beispiel

-- Store your Datadog credentials once (kept out of query text; redacted in duckdb_secrets()).
CREATE SECRET (
TYPE datadog,
API_KEY '<dd-api-key>',
APP_KEY '<dd-application-key>',
SITE 'datadoghq.com' -- optional; e.g. datadoghq.eu, us5.datadoghq.com
);
-- Read a window of logs; the extension follows Datadog's cursor pagination for you.
SELECT time_unix_nano, service_name, severity_text, body
FROM read_datadog_logs(
query => 'service:web-store status:error',
"from" => 'now-1h',
"to" => 'now'
);

Über datadog

Diese Erweiterung liest Logs über die Datadog Logs Search API v2 direkt in DuckDB. Zeilen entsprechen dem OTLP-Logs-Schema (passend zu duckdb-otlp read_otlp_logs), sodass Datadog-Logs direkt in ein OTLP-förmiges Lakehouse neben Daten aus anderen Quellen gelangen.

Funktionen:

  • Anmeldedaten über DuckDB-Secrets (CREATE SECRET (TYPE datadog, ...)), in duckdb_secrets() geschwärzt
  • Cursor-Pagination über das gesamte Zeitfenster, seitenweise gestreamt
  • Automatische Wiederholungen bei Rate Limits (HTTP 429, unter Beachtung des vom Server empfohlenen Resets), HTTP 5xx und transienten Netzwerkfehlern; Wartezeiten respektieren die Abbruch der Abfrage
  • Projection Pushdown: nur ausgewählte Spalten werden dekodiert, sodass Aggregationen die zeilenweise JSON-Serialisierung der Attribute überspringen
  • Benutzerdefinierte Datadog-Attribute werden als JSON in log_attributes bereitgestellt, zur Nutzung mit den JSON-Funktionen von DuckDB

Logs werden derzeit unterstützt; Traces/Spans und Metriken sind geplant. Die vollständige Dokumentation finden Sie im Erweiterungs-Repository.

Hinzugefügte Funktionen

function_name function_type description comment examples
datadog_serve scalar NULL NULL
datadog_stop scalar NULL NULL
read_datadog_log_stats table NULL NULL
read_datadog_logs table NULL NULL
read_datadog_metrics table NULL NULL
read_datadog_service_dependencies table NULL NULL
read_datadog_traces table NULL NULL
send_datadog_logs scalar NULL NULL
write_datadog_traces scalar NULL NULL

Überladene Funktionen

Diese Erweiterung fügt keine Funktionsüberladungen hinzu.

Hinzugefügte Typen

Diese Erweiterung fügt keine Typen hinzu.

Hinzugefügte Einstellungen

Diese Erweiterung fügt keine Einstellungen hinzu.