Skip to main content

governance_insights

Creates, updates, deletes, gets or lists a governance_insights resource.

Overview

Namegovernance_insights
TypeResource
Iddatadog.organization.governance_insights

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringThe unique identifier of the insight. (example: 498ee21f-8037-48b8-a961-a488692902f4)
attributesobjectThe attributes of a governance insight. Exactly one of metric_query, event_query, usage_query, audit_query, or percentage_query is populated, depending on the data source the insight is computed from; the rest are null.
typestringJSON:API resource type for a governance insight. (insight) (example: insight)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_governance_insightsselectfilter[product]Retrieve the list of governance insights available to the organization. Each insight<br />reports the query used to compute it, so that the value can be computed client-side.<br />Insights can be filtered by product.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
sitestringThe Datadog site (region) for your organization, for example datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, ap1.datadoghq.com, ap2.datadoghq.com, datadoghq.eu, ddog-gov.com. Resolved from the DD_SITE environment variable when set. Optional: defaults to datadoghq.com, or the value of the DD_SITE environment variable when set; a WHERE value overrides both.
filter[product]arrayRestrict the results to insights belonging to the given products. May be repeated to filter by multiple products. Matching is case-insensitive. (example: [Usage, Logs Settings])

SELECT examples

Retrieve the list of governance insights available to the organization. Each insight<br />reports the query used to compute it, so that the value can be computed client-side.<br />Insights can be filtered by product.

SELECT
id,
attributes,
type
FROM datadog.organization.governance_insights
WHERE filter[product] = '{{ filter[product] }}'
;