@@ -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:
@@ -38398,6 +38434,134 @@ components:
3839838434 type: string
3839938435 x-enum-varnames:
3840038436 - AGGREGATED_CONNECTION
38437+ SingleAggregatedDnsResponseArray:
38438+ additionalProperties: {}
38439+ description: List of aggregated DNS flows.
38440+ example:
38441+ data:
38442+ - attributes:
38443+ group_bys:
38444+ - key: client_team
38445+ value: networks
38446+ - key: server_service
38447+ value: hucklebuck
38448+ metrics:
38449+ - key: dns_total_requests
38450+ value: 100
38451+ - key: dns_failures
38452+ value: 6
38453+ - key: dns_successful_responses
38454+ value: 95
38455+ - key: dns_failed_responses
38456+ value: 4
38457+ - key: dns_timeouts
38458+ value: 2
38459+ - key: dns_responses.nxdomain
38460+ value: 1
38461+ - key: dns_responses.servfail
38462+ value: 1
38463+ - key: dns_responses.other
38464+ value: 3
38465+ - key: dns_success_latency_percentile
38466+ value: 50
38467+ - key: dns_failure_latency_percentile
38468+ value: 75
38469+ id: client_team:networks, server_service:hucklebuck
38470+ type: aggregated_dns
38471+ properties:
38472+ data:
38473+ description: Array of aggregated DNS objects.
38474+ items:
38475+ $ref: '#/components/schemas/SingleAggregatedDnsResponseData'
38476+ type: array
38477+ type: object
38478+ SingleAggregatedDnsResponseData:
38479+ description: Object describing an aggregated DNS flow.
38480+ properties:
38481+ attributes:
38482+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributes'
38483+ id:
38484+ description: A unique identifier for the aggregated DNS traffic based on
38485+ the group by values.
38486+ example: client_service:example-service,network.dns_query:example.com
38487+ type: string
38488+ type:
38489+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataType'
38490+ example: aggregated_dns
38491+ type: object
38492+ SingleAggregatedDnsResponseDataAttributes:
38493+ description: Attributes for an aggregated DNS flow.
38494+ properties:
38495+ group_bys:
38496+ additionalProperties: {}
38497+ description: The key, value pairs for each group by.
38498+ example:
38499+ - key: client_service
38500+ value: example-service
38501+ - key: network.dns_query
38502+ value: example.com
38503+ items:
38504+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributesGroupByItems'
38505+ type: array
38506+ metrics:
38507+ additionalProperties: {}
38508+ description: Metrics associated with an aggregated DNS flow.
38509+ example:
38510+ - key: dns_total_requests
38511+ value: 100
38512+ - key: dns_failures
38513+ value: 7
38514+ - key: dns_successful_responses
38515+ value: 93
38516+ - key: dns_failed_responses
38517+ value: 5
38518+ - key: dns_timeouts
38519+ value: 2
38520+ - key: dns_responses.nxdomain
38521+ value: 1
38522+ - key: dns_responses.servfail
38523+ value: 1
38524+ - key: dns_responses.other
38525+ value: 3
38526+ - key: dns_success_latency_percentile
38527+ value: 50
38528+ - key: dns_failure_latency_percentile
38529+ value: 76
38530+ items:
38531+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributesMetricsItems'
38532+ type: array
38533+ type: object
38534+ SingleAggregatedDnsResponseDataAttributesGroupByItems:
38535+ description: Attributes associated with a group by
38536+ properties:
38537+ key:
38538+ description: The group by key.
38539+ type: string
38540+ value:
38541+ additionalProperties:
38542+ items:
38543+ type: string
38544+ type: array
38545+ description: The group by value.
38546+ type: object
38547+ SingleAggregatedDnsResponseDataAttributesMetricsItems:
38548+ description: Metrics associated with an aggregated DNS flow.
38549+ properties:
38550+ key:
38551+ $ref: '#/components/schemas/DnsMetricKey'
38552+ value:
38553+ description: The metric value.
38554+ format: int64
38555+ type: integer
38556+ type: object
38557+ SingleAggregatedDnsResponseDataType:
38558+ default: aggregated_dns
38559+ description: Aggregated DNS resource type.
38560+ enum:
38561+ - aggregated_dns
38562+ type: string
38563+ x-enum-varnames:
38564+ - AGGREGATED_DNS
3840138565 SlackIntegrationMetadata:
3840238566 description: Incident integration metadata for the Slack integration.
3840338567 properties:
@@ -55045,6 +55209,69 @@ paths:
5504555209 x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,
5504655210
5504755211 contact [Datadog support](https://docs.datadoghq.com/help/).'
55212+ /api/v2/network/dns/aggregate:
55213+ get:
55214+ description: Get all aggregated DNS traffic.
55215+ operationId: GetAggregatedDns
55216+ parameters:
55217+ - description: Unix timestamp (number of seconds since epoch) of the start of
55218+ the query window. If not provided, the start of the query window is 15 minutes
55219+ before the `to` timestamp. If neither `from` nor `to` are provided, the
55220+ query window is `[now - 15m, now]`.
55221+ in: query
55222+ name: from
55223+ schema:
55224+ format: int64
55225+ type: integer
55226+ - description: Unix timestamp (number of seconds since epoch) of the end of
55227+ the query window. If not provided, the end of the query window is the current
55228+ time. If neither `from` nor `to` are provided, the query window is `[now
55229+ - 15m, now]`.
55230+ in: query
55231+ name: to
55232+ schema:
55233+ format: int64
55234+ type: integer
55235+ - description: Comma-separated list of fields to group DNS traffic by. The server
55236+ side defaults to `network.dns_query` if unspecified. `server_ungrouped`
55237+ may be used if groups are not desired. The maximum number of group_by(s)
55238+ is 10.
55239+ in: query
55240+ name: group_by
55241+ schema:
55242+ type: string
55243+ - description: Comma-separated list of tags to filter DNS traffic by.
55244+ in: query
55245+ name: tags
55246+ schema:
55247+ type: string
55248+ - description: The number of aggregated DNS entries to be returned. The maximum
55249+ value is 7500.
55250+ in: query
55251+ name: limit
55252+ schema:
55253+ default: 100
55254+ format: int32
55255+ maximum: 7500
55256+ minimum: 1
55257+ type: integer
55258+ responses:
55259+ '200':
55260+ content:
55261+ application/json:
55262+ schema:
55263+ $ref: '#/components/schemas/SingleAggregatedDnsResponseArray'
55264+ description: OK
55265+ '400':
55266+ $ref: '#/components/responses/BadRequestResponse'
55267+ '429':
55268+ $ref: '#/components/responses/TooManyRequestsResponse'
55269+ summary: Get all aggregated DNS traffic
55270+ tags:
55271+ - Cloud Network Monitoring
55272+ x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,
55273+
55274+ contact [Datadog support](https://docs.datadoghq.com/help/).'
5504855275 /api/v2/on-call/escalation-policies:
5504955276 post:
5505055277 description: Create a new On-Call escalation policy
@@ -65836,7 +66063,8 @@ tags:
6583666063 documentation](https://docs.datadoghq.com/cloud_cost_management/).
6583766064 name: Cloud Cost Management
6583866065- description: The Cloud Network Monitoring API allows you to fetch aggregated connections
65839- and their attributes. See the [Cloud Network Monitoring page](https://docs.datadoghq.com/network_monitoring/cloud_network_monitoring/)
66066+ and DNS traffic with their attributes. See the [Cloud Network Monitoring page](https://docs.datadoghq.com/network_monitoring/cloud_network_monitoring/)
66067+ and [DNS Monitoring page](https://docs.datadoghq.com/network_monitoring/dns/)
6584066068 for more information.
6584166069 name: Cloud Network Monitoring
6584266070- description: Manage your Datadog Cloudflare integration directly through the Datadog
0 commit comments