@@ -12939,6 +12939,42 @@ components:
1293912939 description: The type of the resource. The value should always be device.
1294012940 type: string
1294112941 type: object
12942+ DnsMetricKey:
12943+ description: The metric key for DNS metrics.
12944+ enum:
12945+ - dns_total_requests
12946+ - dns_failures
12947+ - dns_successful_responses
12948+ - dns_failed_responses
12949+ - dns_timeouts
12950+ - dns_responses.nxdomain
12951+ - dns_responses.servfail
12952+ - dns_responses.other
12953+ - dns_success_latency_percentile
12954+ - dns_failure_latency_percentile
12955+ type: string
12956+ x-enum-descriptions:
12957+ - The total number of DNS requests made by the client.
12958+ - The total number of timeouts and errors in DNS requests.
12959+ - The total number of successful DNS responses.
12960+ - The total number of failed DNS responses.
12961+ - The total number of DNS timeouts.
12962+ - The total number of DNS responses with the NXDOMAIN error code.
12963+ - The total number of DNS responses with the SERVFAIL error code.
12964+ - The total number of DNS responses with other error codes.
12965+ - The latency percentile for successful DNS responses.
12966+ - The latency percentile for failed DNS responses.
12967+ x-enum-varnames:
12968+ - DNS_TOTAL_REQUESTS
12969+ - DNS_FAILURES
12970+ - DNS_SUCCESSFUL_RESPONSES
12971+ - DNS_FAILED_RESPONSES
12972+ - DNS_TIMEOUTS
12973+ - DNS_RESPONSES_NXDOMAIN
12974+ - DNS_RESPONSES_SERVFAIL
12975+ - DNS_RESPONSES_OTHER
12976+ - DNS_SUCCESS_LATENCY_PERCENTILE
12977+ - DNS_FAILURE_LATENCY_PERCENTILE
1294212978 DomainAllowlist:
1294312979 description: The email domain allowlist for an org.
1294412980 properties:
@@ -38433,6 +38469,106 @@ components:
3843338469 type: string
3843438470 x-enum-varnames:
3843538471 - AGGREGATED_CONNECTION
38472+ SingleAggregatedDnsResponseArray:
38473+ description: List of aggregated DNS flows.
38474+ example:
38475+ data:
38476+ - attributes:
38477+ group_bys:
38478+ - key: client_service
38479+ value: example-service
38480+ - key: network.dns_query
38481+ value: example.com
38482+ metrics:
38483+ - key: dns_total_requests
38484+ value: 100
38485+ - key: dns_failures
38486+ value: 7
38487+ - key: dns_successful_responses
38488+ value: 93
38489+ - key: dns_failed_responses
38490+ value: 5
38491+ - key: dns_timeouts
38492+ value: 2
38493+ - key: dns_responses.nxdomain
38494+ value: 1
38495+ - key: dns_responses.servfail
38496+ value: 1
38497+ - key: dns_responses.other
38498+ value: 3
38499+ - key: dns_success_latency_percentile
38500+ value: 50
38501+ - key: dns_failure_latency_percentile
38502+ value: 75
38503+ id: client_service:example-service,network.dns_query:example.com
38504+ type: aggregated_dns
38505+ properties:
38506+ data:
38507+ description: Array of aggregated DNS objects.
38508+ items:
38509+ $ref: '#/components/schemas/SingleAggregatedDnsResponseData'
38510+ type: array
38511+ type: object
38512+ SingleAggregatedDnsResponseData:
38513+ description: Object describing an aggregated DNS flow.
38514+ properties:
38515+ attributes:
38516+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributes'
38517+ id:
38518+ description: A unique identifier for the aggregated DNS traffic based on
38519+ the group by values.
38520+ example: client_service:example-service,network.dns_query:example.com
38521+ type: string
38522+ type:
38523+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataType'
38524+ example: aggregated_dns
38525+ type: object
38526+ SingleAggregatedDnsResponseDataAttributes:
38527+ description: Attributes for an aggregated DNS flow.
38528+ properties:
38529+ group_bys:
38530+ description: The key, value pairs for each group by.
38531+ items:
38532+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributesGroupByItems'
38533+ type: array
38534+ metrics:
38535+ description: Metrics associated with an aggregated DNS flow.
38536+ items:
38537+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributesMetricsItems'
38538+ type: array
38539+ type: object
38540+ SingleAggregatedDnsResponseDataAttributesGroupByItems:
38541+ description: Attributes associated with a group by
38542+ properties:
38543+ key:
38544+ description: The group by key.
38545+ example: client_team
38546+ type: string
38547+ value:
38548+ description: The group by value.
38549+ example: networks
38550+ type: string
38551+ type: object
38552+ SingleAggregatedDnsResponseDataAttributesMetricsItems:
38553+ description: Metrics associated with an aggregated DNS flow.
38554+ properties:
38555+ key:
38556+ $ref: '#/components/schemas/DnsMetricKey'
38557+ example: dns_total_requests
38558+ value:
38559+ description: The metric value.
38560+ example: 10
38561+ format: int64
38562+ type: integer
38563+ type: object
38564+ SingleAggregatedDnsResponseDataType:
38565+ default: aggregated_dns
38566+ description: Aggregated DNS resource type.
38567+ enum:
38568+ - aggregated_dns
38569+ type: string
38570+ x-enum-varnames:
38571+ - AGGREGATED_DNS
3843638572 SlackIntegrationMetadata:
3843738573 description: Incident integration metadata for the Slack integration.
3843838574 properties:
@@ -55119,6 +55255,69 @@ paths:
5511955255 x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,
5512055256
5512155257 contact [Datadog support](https://docs.datadoghq.com/help/).'
55258+ /api/v2/network/dns/aggregate:
55259+ get:
55260+ description: Get all aggregated DNS traffic.
55261+ operationId: GetAggregatedDns
55262+ parameters:
55263+ - description: Unix timestamp (number of seconds since epoch) of the start of
55264+ the query window. If not provided, the start of the query window is 15 minutes
55265+ before the `to` timestamp. If neither `from` nor `to` are provided, the
55266+ query window is `[now - 15m, now]`.
55267+ in: query
55268+ name: from
55269+ schema:
55270+ format: int64
55271+ type: integer
55272+ - description: Unix timestamp (number of seconds since epoch) of the end of
55273+ the query window. If not provided, the end of the query window is the current
55274+ time. If neither `from` nor `to` are provided, the query window is `[now
55275+ - 15m, now]`.
55276+ in: query
55277+ name: to
55278+ schema:
55279+ format: int64
55280+ type: integer
55281+ - description: Comma-separated list of fields to group DNS traffic by. The server
55282+ side defaults to `network.dns_query` if unspecified. `server_ungrouped`
55283+ may be used if groups are not desired. The maximum number of group_by(s)
55284+ is 10.
55285+ in: query
55286+ name: group_by
55287+ schema:
55288+ type: string
55289+ - description: Comma-separated list of tags to filter DNS traffic by.
55290+ in: query
55291+ name: tags
55292+ schema:
55293+ type: string
55294+ - description: The number of aggregated DNS entries to be returned. The maximum
55295+ value is 7500.
55296+ in: query
55297+ name: limit
55298+ schema:
55299+ default: 100
55300+ format: int32
55301+ maximum: 7500
55302+ minimum: 1
55303+ type: integer
55304+ responses:
55305+ '200':
55306+ content:
55307+ application/json:
55308+ schema:
55309+ $ref: '#/components/schemas/SingleAggregatedDnsResponseArray'
55310+ description: OK
55311+ '400':
55312+ $ref: '#/components/responses/BadRequestResponse'
55313+ '429':
55314+ $ref: '#/components/responses/TooManyRequestsResponse'
55315+ summary: Get all aggregated DNS traffic
55316+ tags:
55317+ - Cloud Network Monitoring
55318+ x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,
55319+
55320+ contact [Datadog support](https://docs.datadoghq.com/help/).'
5512255321 /api/v2/on-call/escalation-policies:
5512355322 post:
5512455323 description: Create a new On-Call escalation policy
@@ -65906,7 +66105,8 @@ tags:
6590666105 documentation](https://docs.datadoghq.com/cloud_cost_management/).
6590766106 name: Cloud Cost Management
6590866107- description: The Cloud Network Monitoring API allows you to fetch aggregated connections
65909- and their attributes. See the [Cloud Network Monitoring page](https://docs.datadoghq.com/network_monitoring/cloud_network_monitoring/)
66108+ and DNS traffic with their attributes. See the [Cloud Network Monitoring page](https://docs.datadoghq.com/network_monitoring/cloud_network_monitoring/)
66109+ and [DNS Monitoring page](https://docs.datadoghq.com/network_monitoring/dns/)
6591066110 for more information.
6591166111 name: Cloud Network Monitoring
6591266112- description: Manage your Datadog Cloudflare integration directly through the Datadog
0 commit comments