@@ -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,75 @@ components:
3839838434 type: string
3839938435 x-enum-varnames:
3840038436 - AGGREGATED_CONNECTION
38437+ SingleAggregatedDnsResponseArray:
38438+ description: List of aggregated DNS flows.
38439+ properties:
38440+ data:
38441+ description: Array of aggregated DNS objects.
38442+ items:
38443+ $ref: '#/components/schemas/SingleAggregatedDnsResponseData'
38444+ type: array
38445+ type: object
38446+ SingleAggregatedDnsResponseData:
38447+ description: Object describing an aggregated DNS flow.
38448+ properties:
38449+ attributes:
38450+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributes'
38451+ id:
38452+ description: A unique identifier for the aggregated DNS traffic based on
38453+ the group by values.
38454+ example: client_service:example-service,network.dns_query:example.com
38455+ type: string
38456+ type:
38457+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataType'
38458+ example: aggregated_dns
38459+ type: object
38460+ SingleAggregatedDnsResponseDataAttributes:
38461+ description: Attributes for an aggregated DNS flow.
38462+ properties:
38463+ group_bys:
38464+ description: The key, value pairs for each group by.
38465+ items:
38466+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributesGroupByItems'
38467+ type: array
38468+ metrics:
38469+ description: Metrics associated with an aggregated DNS flow.
38470+ items:
38471+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributesMetricsItems'
38472+ type: array
38473+ type: object
38474+ SingleAggregatedDnsResponseDataAttributesGroupByItems:
38475+ description: Attributes associated with a group by
38476+ properties:
38477+ key:
38478+ description: The group by key.
38479+ example: client_team
38480+ type: string
38481+ value:
38482+ description: The group by value.
38483+ example: networks
38484+ type: string
38485+ type: object
38486+ SingleAggregatedDnsResponseDataAttributesMetricsItems:
38487+ description: Metrics associated with an aggregated DNS flow.
38488+ properties:
38489+ key:
38490+ $ref: '#/components/schemas/DnsMetricKey'
38491+ example: dns_total_requests
38492+ value:
38493+ description: The metric value.
38494+ example: 100
38495+ format: int64
38496+ type: integer
38497+ type: object
38498+ SingleAggregatedDnsResponseDataType:
38499+ default: aggregated_dns
38500+ description: Aggregated DNS resource type.
38501+ enum:
38502+ - aggregated_dns
38503+ type: string
38504+ x-enum-varnames:
38505+ - AGGREGATED_DNS
3840138506 SlackIntegrationMetadata:
3840238507 description: Incident integration metadata for the Slack integration.
3840338508 properties:
@@ -55045,6 +55150,69 @@ paths:
5504555150 x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,
5504655151
5504755152 contact [Datadog support](https://docs.datadoghq.com/help/).'
55153+ /api/v2/network/dns/aggregate:
55154+ get:
55155+ description: Get all aggregated DNS traffic.
55156+ operationId: GetAggregatedDns
55157+ parameters:
55158+ - description: Unix timestamp (number of seconds since epoch) of the start of
55159+ the query window. If not provided, the start of the query window is 15 minutes
55160+ before the `to` timestamp. If neither `from` nor `to` are provided, the
55161+ query window is `[now - 15m, now]`.
55162+ in: query
55163+ name: from
55164+ schema:
55165+ format: int64
55166+ type: integer
55167+ - description: Unix timestamp (number of seconds since epoch) of the end of
55168+ the query window. If not provided, the end of the query window is the current
55169+ time. If neither `from` nor `to` are provided, the query window is `[now
55170+ - 15m, now]`.
55171+ in: query
55172+ name: to
55173+ schema:
55174+ format: int64
55175+ type: integer
55176+ - description: Comma-separated list of fields to group DNS traffic by. The server
55177+ side defaults to `network.dns_query` if unspecified. `server_ungrouped`
55178+ may be used if groups are not desired. The maximum number of group_by(s)
55179+ is 10.
55180+ in: query
55181+ name: group_by
55182+ schema:
55183+ type: string
55184+ - description: Comma-separated list of tags to filter DNS traffic by.
55185+ in: query
55186+ name: tags
55187+ schema:
55188+ type: string
55189+ - description: The number of aggregated DNS entries to be returned. The maximum
55190+ value is 7500.
55191+ in: query
55192+ name: limit
55193+ schema:
55194+ default: 100
55195+ format: int32
55196+ maximum: 7500
55197+ minimum: 1
55198+ type: integer
55199+ responses:
55200+ '200':
55201+ content:
55202+ application/json:
55203+ schema:
55204+ $ref: '#/components/schemas/SingleAggregatedDnsResponseArray'
55205+ description: OK
55206+ '400':
55207+ $ref: '#/components/responses/BadRequestResponse'
55208+ '429':
55209+ $ref: '#/components/responses/TooManyRequestsResponse'
55210+ summary: Get all aggregated DNS traffic
55211+ tags:
55212+ - Cloud Network Monitoring
55213+ x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,
55214+
55215+ contact [Datadog support](https://docs.datadoghq.com/help/).'
5504855216 /api/v2/on-call/escalation-policies:
5504955217 post:
5505055218 description: Create a new On-Call escalation policy
@@ -65836,7 +66004,8 @@ tags:
6583666004 documentation](https://docs.datadoghq.com/cloud_cost_management/).
6583766005 name: Cloud Cost Management
6583866006- 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/)
66007+ and DNS traffic with their attributes. See the [Cloud Network Monitoring page](https://docs.datadoghq.com/network_monitoring/cloud_network_monitoring/)
66008+ and [DNS Monitoring page](https://docs.datadoghq.com/network_monitoring/dns/)
6584066009 for more information.
6584166010 name: Cloud Network Monitoring
6584266011- description: Manage your Datadog Cloudflare integration directly through the Datadog
0 commit comments