@@ -12925,6 +12925,42 @@ components:
1292512925 description: The type of the resource. The value should always be device.
1292612926 type: string
1292712927 type: object
12928+ DnsMetricKey:
12929+ description: The metric key for DNS metrics.
12930+ enum:
12931+ - dns_total_requests
12932+ - dns_failures
12933+ - dns_successful_responses
12934+ - dns_failed_responses
12935+ - dns_timeouts
12936+ - dns_responses.nxdomain
12937+ - dns_responses.servfail
12938+ - dns_responses.other
12939+ - dns_success_latency_percentile
12940+ - dns_failure_latency_percentile
12941+ type: string
12942+ x-enum-descriptions:
12943+ - The total number of DNS requests made by the client.
12944+ - The total number of timeouts and errors in DNS requests.
12945+ - The total number of successful DNS responses.
12946+ - The total number of failed DNS responses.
12947+ - The total number of DNS timeouts.
12948+ - The total number of DNS responses with the NXDOMAIN error code.
12949+ - The total number of DNS responses with the SERVFAIL error code.
12950+ - The total number of DNS responses with other error codes.
12951+ - The latency percentile for successful DNS responses.
12952+ - The latency percentile for failed DNS responses.
12953+ x-enum-varnames:
12954+ - DNS_TOTAL_REQUESTS
12955+ - DNS_FAILURES
12956+ - DNS_SUCCESSFUL_RESPONSES
12957+ - DNS_FAILED_RESPONSES
12958+ - DNS_TIMEOUTS
12959+ - DNS_RESPONSES_NXDOMAIN
12960+ - DNS_RESPONSES_SERVFAIL
12961+ - DNS_RESPONSES_OTHER
12962+ - DNS_SUCCESS_LATENCY_PERCENTILE
12963+ - DNS_FAILURE_LATENCY_PERCENTILE
1292812964 DomainAllowlist:
1292912965 description: The email domain allowlist for an org.
1293012966 properties:
@@ -38383,6 +38419,131 @@ components:
3838338419 type: string
3838438420 x-enum-varnames:
3838538421 - AGGREGATED_CONNECTION
38422+ SingleAggregatedDnsResponseArray:
38423+ description: List of aggregated DNS flows.
38424+ example:
38425+ data:
38426+ - attributes:
38427+ group_bys:
38428+ - key: client_team
38429+ value: networks
38430+ - key: server_service
38431+ value: hucklebuck
38432+ metrics:
38433+ - key: dns_total_requests
38434+ value: 100
38435+ - key: dns_failures
38436+ value: 6
38437+ - key: dns_successful_responses
38438+ value: 95
38439+ - key: dns_failed_responses
38440+ value: 4
38441+ - key: dns_timeouts
38442+ value: 2
38443+ - key: dns_responses.nxdomain
38444+ value: 1
38445+ - key: dns_responses.servfail
38446+ value: 1
38447+ - key: dns_responses.other
38448+ value: 3
38449+ - key: dns_success_latency_percentile
38450+ value: 50
38451+ - key: dns_failure_latency_percentile
38452+ value: 75
38453+ id: client_team:networks, server_service:hucklebuck
38454+ type: aggregated_dns
38455+ properties:
38456+ data:
38457+ description: Array of aggregated DNS objects.
38458+ items:
38459+ $ref: '#/components/schemas/SingleAggregatedDnsResponseData'
38460+ type: array
38461+ type: object
38462+ SingleAggregatedDnsResponseData:
38463+ description: Object describing an aggregated DNS flow.
38464+ properties:
38465+ attributes:
38466+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributes'
38467+ id:
38468+ description: A unique identifier for the aggregated DNS traffic based on
38469+ the group by values.
38470+ example: client_service:example-service,network.dns_query:example.com
38471+ type: string
38472+ type:
38473+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataType'
38474+ example: aggregated_dns
38475+ type: object
38476+ SingleAggregatedDnsResponseDataAttributes:
38477+ description: Attributes for an aggregated DNS flow.
38478+ properties:
38479+ group_bys:
38480+ description: The key, value pairs for each group by.
38481+ example:
38482+ - key: client_service
38483+ value: example-service
38484+ - key: network.dns_query
38485+ value: example.com
38486+ items:
38487+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributesGroupByItems'
38488+ type: array
38489+ metrics:
38490+ description: Metrics associated with an aggregated DNS flow.
38491+ example:
38492+ - key: dns_total_requests
38493+ value: 100
38494+ - key: dns_failures
38495+ value: 7
38496+ - key: dns_successful_responses
38497+ value: 93
38498+ - key: dns_failed_responses
38499+ value: 5
38500+ - key: dns_timeouts
38501+ value: 2
38502+ - key: dns_responses.nxdomain
38503+ value: 1
38504+ - key: dns_responses.servfail
38505+ value: 1
38506+ - key: dns_responses.other
38507+ value: 3
38508+ - key: dns_success_latency_percentile
38509+ value: 50
38510+ - key: dns_failure_latency_percentile
38511+ value: 75
38512+ items:
38513+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributesMetricsItems'
38514+ type: array
38515+ type: object
38516+ SingleAggregatedDnsResponseDataAttributesGroupByItems:
38517+ description: Attributes associated with a group by
38518+ properties:
38519+ key:
38520+ description: The group by key.
38521+ type: string
38522+ value:
38523+ additionalProperties:
38524+ items:
38525+ type: string
38526+ type: array
38527+ description: The group by value.
38528+ type: object
38529+ SingleAggregatedDnsResponseDataAttributesMetricsItems:
38530+ description: Metrics associated with an aggregated DNS flow.
38531+ properties:
38532+ key:
38533+ $ref: '#/components/schemas/DnsMetricKey'
38534+ value:
38535+ description: The metric value.
38536+ format: int64
38537+ type: integer
38538+ type: object
38539+ SingleAggregatedDnsResponseDataType:
38540+ default: aggregated_dns
38541+ description: Aggregated DNS resource type.
38542+ enum:
38543+ - aggregated_dns
38544+ type: string
38545+ x-enum-varnames:
38546+ - AGGREGATED_DNS
3838638547 SlackIntegrationMetadata:
3838738548 description: Incident integration metadata for the Slack integration.
3838838549 properties:
@@ -55030,6 +55191,69 @@ paths:
5503055191 x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,
5503155192
5503255193 contact [Datadog support](https://docs.datadoghq.com/help/).'
55194+ /api/v2/network/dns/aggregate:
55195+ get:
55196+ description: Get all aggregated DNS traffic.
55197+ operationId: GetAggregatedDns
55198+ parameters:
55199+ - description: Unix timestamp (number of seconds since epoch) of the start of
55200+ the query window. If not provided, the start of the query window is 15 minutes
55201+ before the `to` timestamp. If neither `from` nor `to` are provided, the
55202+ query window is `[now - 15m, now]`.
55203+ in: query
55204+ name: from
55205+ schema:
55206+ format: int64
55207+ type: integer
55208+ - description: Unix timestamp (number of seconds since epoch) of the end of
55209+ the query window. If not provided, the end of the query window is the current
55210+ time. If neither `from` nor `to` are provided, the query window is `[now
55211+ - 15m, now]`.
55212+ in: query
55213+ name: to
55214+ schema:
55215+ format: int64
55216+ type: integer
55217+ - description: Comma-separated list of fields to group DNS traffic by. The server
55218+ side defaults to `network.dns_query` if unspecified. `server_ungrouped`
55219+ may be used if groups are not desired. The maximum number of group_by(s)
55220+ is 10.
55221+ in: query
55222+ name: group_by
55223+ schema:
55224+ type: string
55225+ - description: Comma-separated list of tags to filter DNS traffic by.
55226+ in: query
55227+ name: tags
55228+ schema:
55229+ type: string
55230+ - description: The number of aggregated DNS entries to be returned. The maximum
55231+ value is 7500.
55232+ in: query
55233+ name: limit
55234+ schema:
55235+ default: 100
55236+ format: int32
55237+ maximum: 7500
55238+ minimum: 1
55239+ type: integer
55240+ responses:
55241+ '200':
55242+ content:
55243+ application/json:
55244+ schema:
55245+ $ref: '#/components/schemas/SingleAggregatedDnsResponseArray'
55246+ description: OK
55247+ '400':
55248+ $ref: '#/components/responses/BadRequestResponse'
55249+ '429':
55250+ $ref: '#/components/responses/TooManyRequestsResponse'
55251+ summary: Get all aggregated DNS traffic
55252+ tags:
55253+ - Cloud Network Monitoring
55254+ x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,
55255+
55256+ contact [Datadog support](https://docs.datadoghq.com/help/).'
5503355257 /api/v2/on-call/escalation-policies:
5503455258 post:
5503555259 description: Create a new On-Call escalation policy
@@ -65817,7 +66041,8 @@ tags:
6581766041 documentation](https://docs.datadoghq.com/cloud_cost_management/).
6581866042 name: Cloud Cost Management
6581966043- description: The Cloud Network Monitoring API allows you to fetch aggregated connections
65820- and their attributes. See the [Cloud Network Monitoring page](https://docs.datadoghq.com/network_monitoring/cloud_network_monitoring/)
66044+ and DNS traffic with their attributes. See the [Cloud Network Monitoring page](https://docs.datadoghq.com/network_monitoring/cloud_network_monitoring/)
66045+ and [DNS Monitoring page](https://docs.datadoghq.com/network_monitoring/dns/)
6582166046 for more information.
6582266047 name: Cloud Network Monitoring
6582366048- description: Manage your Datadog Cloudflare integration directly through the Datadog
0 commit comments