airbyte/docs/integrations/sources/datadog.md

Datadog

This is a setup guide for the Datadog source connector which collects data from its API.

Prerequisites

An API key is required as well as an API application key. See the Datadog API and Application Keys section for more information.

Setup guide

Step 1: Set up the Datadog connector in Airbyte

For Airbyte Cloud:

1. Log into your Airbyte Cloud account.
2. In the left navigation bar, click Sources. In the top-right corner, click +new source.
3. On the Set up the source page, enter the name for the Datadog connector and select Datadog from the Source type dropdown.
4. Enter your api_key - Datadog API key.
5. Enter your application_key - Datadog application key.
6. Enter your query - Optional. Type your query to filter records when collecting data from Logs and AuditLogs stream.
7. Enter your limit - Number of records to collect per request.
8. Enter your start_date - Optional. Start date to filter records when collecting data from Logs and AuditLogs stream.
9. Enter your end_date - Optional. End date to filter records when collecting data from Logs and AuditLogs stream.
10. Enter your queries - Optional. Multiple queries resulting in multiple streams.
    1. Enter the name- Optional. Query Name.
    2. Select the data_source from dropdown - Optional. Supported data sources - metrics, cloud_cost, logs, rum.
    3. Enter the query- Optional. A classic query string. Example - "kubernetes_state.node.count{*}", "@type:resource @resource.status_code:>=400 @resource.type:(xhr OR fetch)"
11. Click Set up source.

For Airbyte OSS:

1. Navigate to the Airbyte Open Source dashboard.
2. Set the name for your source.
3. Enter your api_key - Datadog API key.
4. Enter your application_key - Datadog application key.
5. Enter your query - Optional. Type your query to filter records when collecting data from Logs and AuditLogs stream.
6. Enter your limit - Number of records to collect per request.
7. Enter your start_date - Optional. Start date to filter records when collecting data from Logs and AuditLogs stream.
8. Enter your end_date - Optional. End date to filter records when collecting data from Logs and AuditLogs stream.
9. Enter your queries - Optional. Multiple queries resulting in multiple streams.
   1. Enter the name- Required. Query Name.
   2. Select the data_source - Required. Supported data sources - metrics, cloud_cost, logs, rum.
   3. Enter the query- Required. A classic query string. Example - "kubernetes_state.node.count{*}", "@type:resource @resource.status_code:>=400 @resource.type:(xhr OR fetch)"
10. Click Set up source.

Supported sync modes

The Datadog source connector supports the following sync modes:

Feature	Supported?
Full Refresh Sync	Yes
Incremental Sync	Yes
SSL connection	Yes
Namespaces	No

Supported Streams

• AuditLogs
• Dashboards
• Downtimes
• IncidentTeams
• Incidents
• Logs
• Metrics
• Monitors
• ServiceLevelObjectives
• SyntheticTests
• Users
• Series

Changelog

Expand to review

Version	Date	Pull Request	Subject
2.0.24	2025-05-24	60420	Update dependencies
2.0.23	2025-05-10	59399	Update dependencies
2.0.22	2025-04-26	58888	Update dependencies
2.0.21	2025-04-19	58342	Update dependencies
2.0.20	2025-04-12	57776	Update dependencies
2.0.19	2025-04-05	57246	Update dependencies
2.0.18	2025-03-29	56528	Update dependencies
2.0.17	2025-03-25	54206	remove default end date value
2.0.16	2025-03-22	55994	Update dependencies
2.0.15	2025-03-08	55280	Update dependencies
2.0.14	2025-03-01	54921	Update dependencies
2.0.13	2025-02-22	54444	Update dependencies
2.0.12	2025-02-20	54180	🐛 Source Datadog : Fix the Pagination in the logs stream
2.0.11	2025-02-15	53705	Update dependencies
2.0.10	2025-02-08	53382	Update dependencies
2.0.9	2025-02-01	52866	Update dependencies
2.0.8	2025-01-25	52350	Update dependencies
2.0.7	2025-01-18	51677	Update dependencies
2.0.6	2024-01-16	48537	Update default start and end dates for logs stream, if they are not configured as default
2.0.5	2025-01-11	51122	Update dependencies
2.0.4	2024-12-28	50567	Update dependencies
2.0.3	2024-12-21	49988	Update dependencies
2.0.2	2024-12-14	49472	Update dependencies
2.0.1	2024-12-12	48300	Update dependencies
2.0.0	2024-12-06	48833	Remove is_read_only parameter from dashboards stream schema
1.1.1	2024-10-28	46502	Update dependencies
1.1.0	2023-10-04	46387	Migrate to manifest only
1.0.6	2024-09-28	46190	Update dependencies
1.0.5	2024-09-21	45771	Update dependencies
1.0.4	2024-09-14	45581	Update dependencies
1.0.3	2024-09-07	45297	Update dependencies
1.0.2	2024-08-31	44992	Update dependencies
1.0.1	2024-08-24	44706	Update dependencies
1.0.0	2024-08-19	44371	Update CDK version and dependencies, remove parameters and migrate to inline schemas
0.4.15	2024-08-17	44313	Update dependencies
0.4.14	2024-08-12	43741	Update dependencies
0.4.13	2024-08-10	43555	Update dependencies
0.4.12	2024-08-03	43141	Update dependencies
0.4.11	2024-07-27	42776	Update dependencies
0.4.10	2024-07-20	42341	Update dependencies
0.4.9	2024-07-13	41783	Update dependencies
0.4.8	2024-07-10	41416	Update dependencies
0.4.7	2024-07-09	41168	Update dependencies
0.4.6	2024-07-06	40985	Update dependencies
0.4.5	2024-06-25	40306	Update dependencies
0.4.4	2024-06-22	40063	Update dependencies
0.4.3	2024-06-13	37590	Change last_records to last_record
0.4.2	2024-06-04	39060	[autopull] Upgrade base image to v1.2.1
0.4.1	2024-05-20	38424	[autopull] base image + poetry + up_to_date
0.4.0	2023-12-04	30999	Add monitors and service_level_objectives Streams
0.3.0	2023-08-27	29885	Migrate to low code
0.2.2	2023-07-10	28089	Additional stream and query details in response
0.2.1	2023-06-28	26534	Support multiple query streams and pulling data from different datadog sites
0.2.0	2023-06-28	27784	Add necessary fields to schemas
0.1.1	2023-04-27	25562	Update testing dependencies
0.1.0	2022-10-18	18150	New Source: Datadog