@@ -12940,6 +12940,42 @@ components:
1294012940 description: The type of the resource. The value should always be device.
1294112941 type: string
1294212942 type: object
12943+ DnsMetricKey:
12944+ description: The metric key for DNS metrics.
12945+ enum:
12946+ - dns_total_requests
12947+ - dns_failures
12948+ - dns_successful_responses
12949+ - dns_failed_responses
12950+ - dns_timeouts
12951+ - dns_responses.nxdomain
12952+ - dns_responses.servfail
12953+ - dns_responses.other
12954+ - dns_success_latency_percentile
12955+ - dns_failure_latency_percentile
12956+ type: string
12957+ x-enum-descriptions:
12958+ - The total number of DNS requests made by the client.
12959+ - The total number of timeouts and errors in DNS requests.
12960+ - The total number of successful DNS responses.
12961+ - The total number of failed DNS responses.
12962+ - The total number of DNS timeouts.
12963+ - The total number of DNS responses with the NXDOMAIN error code.
12964+ - The total number of DNS responses with the SERVFAIL error code.
12965+ - The total number of DNS responses with other error codes.
12966+ - The latency percentile for successful DNS responses.
12967+ - The latency percentile for failed DNS responses.
12968+ x-enum-varnames:
12969+ - DNS_TOTAL_REQUESTS
12970+ - DNS_FAILURES
12971+ - DNS_SUCCESSFUL_RESPONSES
12972+ - DNS_FAILED_RESPONSES
12973+ - DNS_TIMEOUTS
12974+ - DNS_RESPONSES_NXDOMAIN
12975+ - DNS_RESPONSES_SERVFAIL
12976+ - DNS_RESPONSES_OTHER
12977+ - DNS_SUCCESS_LATENCY_PERCENTILE
12978+ - DNS_FAILURE_LATENCY_PERCENTILE
1294312979 DomainAllowlist:
1294412980 description: The email domain allowlist for an org.
1294512981 properties:
@@ -38423,6 +38459,75 @@ components:
3842338459 type: string
3842438460 x-enum-varnames:
3842538461 - AGGREGATED_CONNECTION
38462+ SingleAggregatedDnsResponseArray:
38463+ description: List of aggregated DNS flows.
38464+ properties:
38465+ data:
38466+ description: Array of aggregated DNS objects.
38467+ items:
38468+ $ref: '#/components/schemas/SingleAggregatedDnsResponseData'
38469+ type: array
38470+ type: object
38471+ SingleAggregatedDnsResponseData:
38472+ description: Object describing an aggregated DNS flow.
38473+ properties:
38474+ attributes:
38475+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributes'
38476+ id:
38477+ description: A unique identifier for the aggregated DNS traffic based on
38478+ the group by values.
38479+ example: client_service:example-service,network.dns_query:example.com
38480+ type: string
38481+ type:
38482+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataType'
38483+ example: aggregated_dns
38484+ type: object
38485+ SingleAggregatedDnsResponseDataAttributes:
38486+ description: Attributes for an aggregated DNS flow.
38487+ properties:
38488+ group_bys:
38489+ description: The key, value pairs for each group by.
38490+ items:
38491+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributesGroupByItems'
38492+ type: array
38493+ metrics:
38494+ description: Metrics associated with an aggregated DNS flow.
38495+ items:
38496+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributesMetricsItems'
38497+ type: array
38498+ type: object
38499+ SingleAggregatedDnsResponseDataAttributesGroupByItems:
38500+ description: Attributes associated with a group by
38501+ properties:
38502+ key:
38503+ description: The group by key.
38504+ example: client_team
38505+ type: string
38506+ value:
38507+ description: The group by value.
38508+ example: networks
38509+ type: string
38510+ type: object
38511+ SingleAggregatedDnsResponseDataAttributesMetricsItems:
38512+ description: Metrics associated with an aggregated DNS flow.
38513+ properties:
38514+ key:
38515+ $ref: '#/components/schemas/DnsMetricKey'
38516+ example: dns_total_requests
38517+ value:
38518+ description: The metric value.
38519+ example: 100
38520+ format: int64
38521+ type: integer
38522+ type: object
38523+ SingleAggregatedDnsResponseDataType:
38524+ default: aggregated_dns
38525+ description: Aggregated DNS resource type.
38526+ enum:
38527+ - aggregated_dns
38528+ type: string
38529+ x-enum-varnames:
38530+ - AGGREGATED_DNS
3842638531 SlackIntegrationMetadata:
3842738532 description: Incident integration metadata for the Slack integration.
3842838533 properties:
@@ -55108,6 +55213,69 @@ paths:
5510855213 x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,
5510955214
5511055215 contact [Datadog support](https://docs.datadoghq.com/help/).'
55216+ /api/v2/network/dns/aggregate:
55217+ get:
55218+ description: Get all aggregated DNS traffic.
55219+ operationId: GetAggregatedDns
55220+ parameters:
55221+ - description: Unix timestamp (number of seconds since epoch) of the start of
55222+ the query window. If not provided, the start of the query window is 15 minutes
55223+ before the `to` timestamp. If neither `from` nor `to` are provided, the
55224+ query window is `[now - 15m, now]`.
55225+ in: query
55226+ name: from
55227+ schema:
55228+ format: int64
55229+ type: integer
55230+ - description: Unix timestamp (number of seconds since epoch) of the end of
55231+ the query window. If not provided, the end of the query window is the current
55232+ time. If neither `from` nor `to` are provided, the query window is `[now
55233+ - 15m, now]`.
55234+ in: query
55235+ name: to
55236+ schema:
55237+ format: int64
55238+ type: integer
55239+ - description: Comma-separated list of fields to group DNS traffic by. The server
55240+ side defaults to `network.dns_query` if unspecified. `server_ungrouped`
55241+ may be used if groups are not desired. The maximum number of group_by(s)
55242+ is 10.
55243+ in: query
55244+ name: group_by
55245+ schema:
55246+ type: string
55247+ - description: Comma-separated list of tags to filter DNS traffic by.
55248+ in: query
55249+ name: tags
55250+ schema:
55251+ type: string
55252+ - description: The number of aggregated DNS entries to be returned. The maximum
55253+ value is 7500.
55254+ in: query
55255+ name: limit
55256+ schema:
55257+ default: 100
55258+ format: int32
55259+ maximum: 7500
55260+ minimum: 1
55261+ type: integer
55262+ responses:
55263+ '200':
55264+ content:
55265+ application/json:
55266+ schema:
55267+ $ref: '#/components/schemas/SingleAggregatedDnsResponseArray'
55268+ description: OK
55269+ '400':
55270+ $ref: '#/components/responses/BadRequestResponse'
55271+ '429':
55272+ $ref: '#/components/responses/TooManyRequestsResponse'
55273+ summary: Get all aggregated DNS traffic
55274+ tags:
55275+ - Cloud Network Monitoring
55276+ x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,
55277+
55278+ contact [Datadog support](https://docs.datadoghq.com/help/).'
5511155279 /api/v2/on-call/escalation-policies:
5511255280 post:
5511355281 description: Create a new On-Call escalation policy
@@ -65899,7 +66067,8 @@ tags:
6589966067 documentation](https://docs.datadoghq.com/cloud_cost_management/).
6590066068 name: Cloud Cost Management
6590166069- description: The Cloud Network Monitoring API allows you to fetch aggregated connections
65902- and their attributes. See the [Cloud Network Monitoring page](https://docs.datadoghq.com/network_monitoring/cloud_network_monitoring/)
66070+ and DNS traffic with their attributes. See the [Cloud Network Monitoring page](https://docs.datadoghq.com/network_monitoring/cloud_network_monitoring/)
66071+ and [DNS Monitoring page](https://docs.datadoghq.com/network_monitoring/dns/)
6590366072 for more information.
6590466073 name: Cloud Network Monitoring
6590566074- description: Manage your Datadog Cloudflare integration directly through the Datadog
0 commit comments