Datadog connector

Set up the Datadog connector in Kaivo: authentication, configuration, the 11 BigQuery tables it syncs, and answers to common questions.

Written By Lauri Raivio

Last updated 15 days ago

Kaivo is a fully managed data platform that syncs your Datadog data into a Google BigQuery warehouse and keeps it up to date automatically. There is no pipeline to build and no infrastructure to run, so you can spend your time analysing your data from Datadog instead of moving it.

What is the Datadog connector

Sync your Datadog monitoring data into BigQuery with Kaivo to analyse incidents, monitors, and reliability trends over the long term.

Category	Tech
Authentication	API key
Setup	Self-service

Getting started with the Datadog connector

Sign up for Kaivo and create a workspace.
Connect your Datadog account.
Choose which tables to sync.
Wait for the initial sync to finish.
Query your data in BigQuery or your favourite AI or BI tool.

Authenticating Datadog

Authenticate with your Datadog credentials. You provide:

Field	Description
API Key	Your Datadog API key.
Application Key	Your Datadog application key.

Configuring the Datadog connector

When you set up the connector, you provide:

Field	Description
Query	Search query for log filtering. Applies to incremental syncs only. Leave empty to collect all logs.
Start Date	Any data before this date will not be fetched.
Site	The Datadog site your account is hosted on.
Queries	List of metric queries to be run and used as inputs.

Tables and columns synced from Datadog

Kaivo syncs 11 tables from Datadog into a dedicated dataset in your BigQuery warehouse. Click any table to see its columns and types.

audit_logs (7 columns)

Column	Type	Description
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`type`	`STRING`	Type of the event. Allowed enum values: audit
`attributes__service`	`STRING`	Name of the application or service generating Audit Logs events.
`attributes__timestamp`	`TIMESTAMP`	Timestamp of your event.
`id`	`STRING`	Unique ID of the event.
`sync_date`	`STRING`
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: audit_logsattributestags

Column	Type	Description
`_kaivo_parent_id`	`STRING`	Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`value`	`STRING`
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

dashboards (11 columns)

Column	Type	Description
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`description`	`STRING`	Description of the dashboard.
`author_handle`	`STRING`	Identifier of the dashboard author.
`created_at`	`TIMESTAMP`	Creation date of the dashboard.
`deleted_at`	`TIMESTAMP`	Deletion date of the dashboard.
`id`	`STRING`	Dashboard identifier.
`layout_type`	`STRING`	Layout type of the dashboard
`modified_at`	`TIMESTAMP`	Modification date of the dashboard.
`title`	`STRING`	Title of the dashboard.
`url`	`STRING`	URL of the dashboard.
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

downtimes (22 columns)

Column	Type	Description
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`active`	`BOOL`	If a scheduled downtime currently exists.
`canceled`	`INT64`	If a scheduled downtime is canceled.
`child_id`	`INT64`
`created`	`INT64`
`creator_id`	`INT64`	User ID of the downtime creator.
`disabled`	`BOOL`	If a downtime has been disabled.
`downtime_type`	`INT64`	0 for a downtime applied on * or all, 1 when the downtime is only scoped to hosts, or 2 when the downtime is scoped to anything but hosts.
`end`	`INT64`	POSIX timestamp to end the downtime. If not provided, the downtime is in effect indefinitely until you cancel it.
`id`	`INT64`	The downtime ID.
`message`	`STRING`	A message to include with notifications for this downtime.
`modified`	`INT64`
`monitor_id`	`INT64`	A single monitor to which the downtime applies. If not provided, the downtime applies to all monitors.
`mute_first_recovery_notification`	`BOOL`	If the first recovery notification during a downtime should be muted.
`org_id`	`INT64`
`parent_id`	`INT64`	ID of the parent Downtime.
`start`	`INT64`	POSIX timestamp to start the downtime. If not provided, the downtime starts the moment it is created.
`status`	`STRING`
`timezone`	`STRING`	The timezone in which to display the downtime's start and end times in Datadog applications.
`updater_id`	`INT64`	ID of the last user that updated the downtime.
`uuid`	`STRING`
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: downtimes__monitor_tags

Column	Type	Description
`_kaivo_parent_id`	`STRING`	Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`value`	`STRING`
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: downtimes__notify_end_states

Column	Type	Description
`_kaivo_parent_id`	`STRING`	Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`value`	`STRING`
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: downtimes__notify_end_types

Column	Type	Description
`_kaivo_parent_id`	`STRING`	Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`value`	`STRING`
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: downtimes__scope

Column	Type	Description
`_kaivo_parent_id`	`STRING`	Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`value`	`STRING`
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

incident_teams (11 columns)

Column	Type	Description
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`type`	`STRING`	Incident Team resource type. Allowed enum values: teams
`attributes__created`	`TIMESTAMP`	Timestamp of when the incident team was created.
`attributes__modified`	`TIMESTAMP`	Timestamp of when the incident team was modified.
`attributes__name`	`STRING`	Name of the incident team.
`id`	`STRING`	The incident team's ID.
`relationships__created_by__data__type`	`STRING`	Users resource type. Allowed enum values: users
`relationships__created_by__data__id`	`STRING`	A unique identifier that represents the user.
`relationships__last_modified_by__data__type`	`STRING`	Users resource type. Allowed enum values: users
`relationships__last_modified_by__data__id`	`STRING`	A unique identifier that represents the user.
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

incidents (19 columns)

Column	Type	Description
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`type`	`STRING`	Incident resource type. Allowed enum values: incidents
`attributes__created`	`TIMESTAMP`	Timestamp when the incident was created.
`attributes__customer_impact_duration`	`INT64`	Length of the incident's customer impact in seconds. Equals the difference between customer_impact_start and customer_impact_end.
`attributes__customer_impact_end`	`TIMESTAMP`	Timestamp when customers were no longer impacted by the incident.
`attributes__customer_impact_scope`	`STRING`	A summary of the impact customers experienced during the incident.
`attributes__customer_impact_start`	`TIMESTAMP`	Timestamp when customers began being impacted by the incident.
`attributes__customer_impacted`	`BOOL`	A flag indicating whether the incident caused customer impact.
`attributes__detected`	`TIMESTAMP`	Timestamp when the incident was detected.
`attributes__modified`	`TIMESTAMP`	Timestamp when the incident was last modified.
`attributes__public_id`	`INT64`	The monotonically increasing integer ID for the incident.
`attributes__resolved`	`TIMESTAMP`	Timestamp when the incident's state was last changed from active or stable to resolved or completed.
`attributes__time_to_detect`	`INT64`	The amount of time in seconds to detect the incident. Equals the difference between customer_impact_start and detected.
`attributes__time_to_internal_response`	`INT64`	The amount of time in seconds to call incident after detection. Equals the difference of detected and created.
`attributes__time_to_repair`	`INT64`	The amount of time in seconds to resolve customer impact after detecting the issue. Equals the difference between customer_impact_end and detected.
`attributes__time_to_resolve`	`INT64`	The amount of time in seconds to resolve the incident after it was created. Equals the difference between created and resolved.
`attributes__title`	`STRING`	The title of the incident, which summarizes what happened.
`id`	`STRING`	The incident's ID.
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: incidentsattributesnotification_handles

Column	Type	Description
`_kaivo_parent_id`	`STRING`	Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

logs (10 columns)

Column	Type	Description
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`type`	`STRING`	Type of the event. Allowed enum values: log
`attributes__host`	`STRING`	Name of the machine from where the logs are being sent.
`attributes__message`	`STRING`	The message reserved attribute of your log.
`attributes__service`	`STRING`	The name of the application or service generating the log events.
`attributes__status`	`STRING`	Status of the message associated with your log.
`attributes__timestamp`	`TIMESTAMP`	Timestamp of your log.
`id`	`STRING`	Unique ID of the Log.
`sync_date`	`STRING`
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: logsattributestags

Column	Type	Description
`_kaivo_parent_id`	`STRING`	Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`value`	`STRING`
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

metrics (4 columns)

Column	Type	Description
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`type`	`STRING`	The metric resource type.
`id`	`STRING`	The metric name for this resource.
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

monitors (53 columns)

Column	Type	Description
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`type`	`STRING`
`created`	`STRING`
`created_at`	`INT64`
`creator__email`	`STRING`
`creator__handle`	`STRING`
`creator__name`	`STRING`
`deleted`	`STRING`
`id`	`INT64`
`message`	`STRING`
`modified`	`STRING`
`multi`	`BOOL`
`name`	`STRING`
`options__aggregation__type`	`STRING`
`options__aggregation__metric`	`STRING`
`options__enable_logs_sample`	`BOOL`
`options__enable_samples`	`BOOL`
`options__escalation_message`	`STRING`
`options__evaluation_delay`	`INT64`
`options__group_retention_duration`	`STRING`
`options__groupby_simple_monitor`	`BOOL`
`options__include_tags`	`BOOL`
`options__locked`	`BOOL`
`options__new_group_delay`	`INT64`
`options__new_host_delay`	`INT64`
`options__no_data_timeframe`	`INT64`
`options__notification_preset_name`	`STRING`
`options__notify_audit`	`BOOL`
`options__notify_no_data`	`BOOL`
`options__on_missing_data`	`STRING`
`options__renotify_interval`	`INT64`
`options__renotify_occurrences`	`INT64`
`options__require_full_window`	`BOOL`
`options__scheduling_options__evaluation_window__day_starts`	`STRING`
`options__scheduling_options__evaluation_window__hour_starts`	`STRING`
`options__scheduling_options__evaluation_window__month_starts`	`INT64`
`options__silenced`	`JSON`
`options__synthetics_check_id`	`STRING`
`options__threshold_windows__recovery_window`	`STRING`
`options__threshold_windows__trigger_window`	`STRING`
`options__thresholds__critical`	`FLOAT64`
`options__thresholds__critical_recovery`	`FLOAT64`
`options__thresholds__ok`	`FLOAT64`
`options__thresholds__unknown`	`FLOAT64`
`options__thresholds__warning`	`FLOAT64`
`options__thresholds__warning_recovery`	`FLOAT64`
`options__timeout_h`	`INT64`
`org_id`	`INT64`
`overall_state`	`STRING`
`overall_state_modified`	`STRING`
`priority`	`INT64`
`query`	`STRING`
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: monitors__matching_downtimes

Column	Type	Description
`_kaivo_parent_id`	`STRING`	Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`end`	`INT64`
`id`	`INT64`
`start`	`INT64`
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: monitors__matching_downtimes__scope

Column	Type	Description
`_kaivo_parent_id`	`STRING`	Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`value`	`STRING`
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: monitorsoptionsaggregation__group_by

Column	Type	Description
`_kaivo_parent_id`	`STRING`	Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`value`	`STRING`
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: monitorsoptionsdevice_ids

Column	Type	Description
`_kaivo_parent_id`	`STRING`	Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`value`	`STRING`
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: monitorsoptionsnotify_by

Column	Type	Description
`_kaivo_parent_id`	`STRING`	Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`value`	`STRING`
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: monitorsoptionsrenotify_statuses

Column	Type	Description
`_kaivo_parent_id`	`STRING`	Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`value`	`STRING`
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: monitorsoptionsvariables

Column	Type	Description
`_kaivo_parent_id`	`STRING`	Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`compute__aggregation`	`STRING`
`compute__interval`	`INT64`
`compute__metric`	`STRING`
`data_source`	`STRING`
`name`	`STRING`
`search__query`	`STRING`
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: monitorsoptionsvariables__group_by

Column	Type	Description
`_kaivo_parent_id`	`STRING`	Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`facet`	`STRING`
`limit`	`INT64`
`sort__aggregation`	`STRING`
`sort__metric`	`STRING`
`sort__order`	`STRING`
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: monitorsoptionsvariables__indexes

Column	Type	Description
`_kaivo_parent_id`	`STRING`	Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`value`	`STRING`
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: monitors__restricted_roles

Column	Type	Description
`_kaivo_parent_id`	`STRING`	Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`value`	`STRING`
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: monitors__tags

Column	Type	Description
`_kaivo_parent_id`	`STRING`	Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`value`	`STRING`
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

service_level_objectives (17 columns)

Column	Type	Description
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`type`	`STRING`
`description`	`STRING`
`created_at`	`INT64`
`creator__email`	`STRING`
`creator__handle`	`STRING`
`creator__name`	`STRING`
`id`	`STRING`
`modified_at`	`INT64`
`name`	`STRING`
`query__denominator`	`STRING`
`query__numerator`	`STRING`
`target_threshold`	`FLOAT64`
`timeframe`	`STRING`
`type_id`	`INT64`
`warning_threshold`	`FLOAT64`
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: service_level_objectives__groups

Column	Type	Description
`_kaivo_parent_id`	`STRING`	Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`value`	`STRING`
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: service_level_objectives__monitor_ids

Column	Type	Description
`_kaivo_parent_id`	`STRING`	Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`value`	`INT64`
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: service_level_objectives__monitor_tags

Column	Type	Description
`_kaivo_parent_id`	`STRING`	Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`value`	`STRING`
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: service_level_objectives__tags

Column	Type	Description
`_kaivo_parent_id`	`STRING`	Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`value`	`STRING`
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: service_level_objectives__thresholds

Column	Type	Description
`_kaivo_parent_id`	`STRING`	Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`target`	`FLOAT64`
`target_display`	`STRING`
`timeframe`	`STRING`
`warning`	`FLOAT64`
`warning_display`	`STRING`
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

synthetic_tests (14 columns)

Column	Type	Description
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`type`	`STRING`	Type of the Synthetic test, either api or browser. Allowed enum values: api,browser
`created_at`	`TIMESTAMP`	Creation date of the Synthetic test.
`creator__email`	`STRING`	Email of the creator.
`creator__handle`	`STRING`	Handle of the creator.
`creator__name`	`STRING`	Name of the creator.
`message`	`STRING`	Notification message associated with the test.
`modified_at`	`TIMESTAMP`	Creation date of the Synthetic test.
`monitor_id`	`INT64`	The associated monitor ID.
`name`	`STRING`	Name of the test.
`public_id`	`STRING`	The test public ID.
`status`	`STRING`	Define whether you want to start (live) or pause (paused) a Synthetic test. Allowed enum values: live,paused
`subtype`	`STRING`	The subtype of the Synthetic API test, http, ssl, tcp, dns, icmp, udp, websocket, grpc or multi. Allowed enum values: http,ssl,tcp,dns,multi,icmp,udp,websocket,grpc
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: synthetic_tests__locations

Column	Type	Description
`_kaivo_parent_id`	`STRING`	Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`value`	`STRING`
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: synthetic_tests__tags

Column	Type	Description
`_kaivo_parent_id`	`STRING`	Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`value`	`STRING`
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

users (15 columns)

Column	Type	Description
`_kaivo_id`	`STRING`	Primary key that uniquely identifies the row. Auto-generated by Kaivo.
`type`	`STRING`	Users resource type. Allowed enum values: users
`attributes__created_at`	`TIMESTAMP`	Creation time of the user.
`attributes__disabled`	`BOOL`	Whether the user is disabled.
`attributes__email`	`STRING`	Email of the user.
`attributes__handle`	`STRING`	Handle of the user.
`attributes__icon`	`STRING`	URL of the user's icon.
`attributes__modified_at`	`TIMESTAMP`	Time that the user was last modified.
`attributes__name`	`STRING`	Name of the user.
`attributes__service_account`	`BOOL`	Whether the user is a service account.
`attributes__status`	`STRING`	Status of the user.
`attributes__title`	`STRING`	Title of the user.
`attributes__verified`	`BOOL`	Whether the user is verified.
`id`	`STRING`	ID of the user.
`_kaivo_extracted_at`	`TIMESTAMP`	Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

How the Datadog sync works

After the first load, Kaivo keeps your BigQuery warehouse up to date for you. Where Datadog supports it, each sync pulls only new and changed records so it stays fast; otherwise it refreshes the whole table. Every record keeps its original ID, so you won't get duplicate rows.

Frequently asked questions

How long does the initial sync take for Datadog?

It depends on how much history is in your Datadog account. Most initial syncs finish within minutes, while large accounts can take a few hours. After that, syncs only fetch new and changed records, so they're much faster.

Can I sync only some tables or columns?

Yes. You pick which tables to sync when you set up the connection and can change the selection later. Tables you don't select are never copied to your warehouse.

What happens when Datadog's schema changes?

New fields are never added automatically. You choose which fields to sync, so data you haven't selected (sensitive personal data, for example) never lands in your warehouse. When a new field appears, it becomes available for you to add. What happens to removed or renamed fields depends on a table's sync mode: full-refresh tables always match what's currently in Datadog, so dropped fields disappear, while incremental tables keep their existing columns and history, so an old field stays and newly added fields fill in over time.

Your data lives in your own Kaivo-managed BigQuery warehouse, so the most direct option is to delete or anonymise specific records right in BigQuery. If you delete data in Datadog instead, full-refresh tables drop it on the next sync, while incremental tables keep it, so you would remove the row in BigQuery or ask us to run a full refresh. To remove everything, delete the Datadog connector in Kaivo and all of its synced data is deleted with it.

Common use cases for Datadog data

Incident analysis

Use incidents and incident_teams to track frequency, severity, and time to resolve over time.

Monitor inventory

Bring monitors and service_level_objectives together to document coverage and SLO health.

Reliability trends

Join incidents with services to see which services cause the most disruption.

Audit and access

Use audit_logs and users to review activity and access across your account.

Use Datadog data in your AI and BI tools

Once Datadog data lands in your Kaivo-managed BigQuery warehouse, you can explore it with AI tools or any BI tool that connects to BigQuery. Here's how the most common destinations work with Datadog data.

Claude

Use Kaivo's MCP server to give Claude secure, workspace-scoped access to your data. Setup guide →

Power BI

Microsoft's BI tool with a native BigQuery connector. Supports direct query and scheduled refresh. Setup guide →

Data Studio

Free Google BI tool with native BigQuery support. One-click connection to your Kaivo warehouse; great for SMB teams on Google Workspace. Setup guide →

Tableau

The premium analytics standard, with native BigQuery integration. Setup guide →

Google Sheets

Use Connected Sheets to query BigQuery directly from a spreadsheet, with no SQL. Setup guide →

Excel

Connect via Power Query's BigQuery connector. Setup guide →

Metabase

Open-source BI tool with strong BigQuery support. Setup guide →

See our pricing page for Datadog connector pricing and plan details.

Adform: Sync Adform to BigQuery.
Amplitude: Sync Amplitude to BigQuery.
Auth0: Sync Auth0 to BigQuery.
Convex: Sync Convex to BigQuery.
GitHub: Sync GitHub to BigQuery.
GitLab: Sync GitLab to BigQuery.

Was this helpful?

Still need help? Share an idea