@@ -12826,6 +12826,43 @@ components:
1282612826 description: The type of the resource. The value should always be device.
1282712827 type: string
1282812828 type: object
12829+ DnsMetricKey:
12830+ description: The metric key for DNS metrics.
12831+ enum:
12832+ - dns_total_requests
12833+ - dns_failures
12834+ - dns_successful_responses
12835+ - dns_failed_responses
12836+ - dns_timeouts
12837+ - dns_responses.nxdomain
12838+ - dns_responses.servfail
12839+ - dns_responses.other
12840+ - dns_success_latency_percentile
12841+ - dns_failure_latency_percentile
12842+ example: dns_total_requests
12843+ type: string
12844+ x-enum-descriptions:
12845+ - The total number of DNS requests made by the client.
12846+ - The total number of timeouts and errors in DNS requests.
12847+ - The total number of successful DNS responses.
12848+ - The total number of failed DNS responses.
12849+ - The total number of DNS timeouts.
12850+ - The total number of DNS responses with the NXDOMAIN error code.
12851+ - The total number of DNS responses with the SERVFAIL error code.
12852+ - The total number of DNS responses with other error codes.
12853+ - The latency percentile for successful DNS responses.
12854+ - The latency percentile for failed DNS responses.
12855+ x-enum-varnames:
12856+ - DNS_TOTAL_REQUESTS
12857+ - DNS_FAILURES
12858+ - DNS_SUCCESSFUL_RESPONSES
12859+ - DNS_FAILED_RESPONSES
12860+ - DNS_TIMEOUTS
12861+ - DNS_RESPONSES_NXDOMAIN
12862+ - DNS_RESPONSES_SERVFAIL
12863+ - DNS_RESPONSES_OTHER
12864+ - DNS_SUCCESS_LATENCY_PERCENTILE
12865+ - DNS_FAILURE_LATENCY_PERCENTILE
1282912866 DomainAllowlist:
1283012867 description: The email domain allowlist for an org.
1283112868 properties:
@@ -38222,6 +38259,107 @@ components:
3822238259 type: string
3822338260 x-enum-varnames:
3822438261 - AGGREGATED_CONNECTION
38262+ SingleAggregatedDnsResponseArray:
38263+ description: List of aggregated DNS flows.
38264+ example:
38265+ data:
38266+ - attributes:
38267+ group_bys:
38268+ - key: client_team
38269+ value: networks
38270+ - key: server_service
38271+ value: hucklebuck
38272+ metrics:
38273+ - key: dns_total_requests
38274+ value: 100
38275+ - key: dns_failures
38276+ value: 6
38277+ - key: dns_successful_responses
38278+ value: 95
38279+ - key: dns_failed_responses
38280+ value: 4
38281+ - key: dns_timeouts
38282+ value: 2
38283+ - key: dns_responses.nxdomain
38284+ value: 1
38285+ - key: dns_responses.servfail
38286+ value: 1
38287+ - key: dns_responses.other
38288+ value: 3
38289+ - key: dns_success_latency_percentile
38290+ value: 50
38291+ - key: dns_failure_latency_percentile
38292+ value: 75
38293+ id: client_team:networks, server_service:hucklebuck
38294+ type: aggregated_dns
38295+ properties:
38296+ data:
38297+ description: Array of aggregated DNS objects.
38298+ items:
38299+ $ref: '#/components/schemas/SingleAggregatedDnsResponseData'
38300+ type: array
38301+ type: object
38302+ SingleAggregatedDnsResponseData:
38303+ description: Object describing an aggregated DNS flow.
38304+ properties:
38305+ attributes:
38306+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributes'
38307+ id:
38308+ description: A unique identifier for the aggregated DNS traffic based on
38309+ the group by values.
38310+ example: client_service:example-service
38311+ type: string
38312+ type:
38313+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataType'
38314+ example: aggregated_dns
38315+ type: object
38316+ SingleAggregatedDnsResponseDataAttributes:
38317+ description: Attributes for an aggregated DNS flow.
38318+ properties:
38319+ group_bys:
38320+ description: The key, value pairs for each group by.
38321+ items:
38322+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributesGroupByItems'
38323+ type: array
38324+ metrics:
38325+ description: Metrics associated with an aggregated DNS flow.
38326+ items:
38327+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributesMetricsItems'
38328+ type: array
38329+ type: object
38330+ SingleAggregatedDnsResponseDataAttributesGroupByItems:
38331+ description: Attributes associated with a group by
38332+ properties:
38333+ key:
38334+ description: The group by key.
38335+ example: client_service
38336+ type: string
38337+ value:
38338+ additionalProperties:
38339+ items:
38340+ type: string
38341+ type: array
38342+ description: The group by value.
38343+ example: example-service
38344+ type: object
38345+ SingleAggregatedDnsResponseDataAttributesMetricsItems:
38346+ description: Metrics associated with an aggregated DNS flow.
38347+ properties:
38348+ key:
38349+ $ref: '#/components/schemas/DnsMetricKey'
38350+ value:
38351+ description: The metric value.
38352+ format: int64
38353+ type: integer
38354+ type: object
38355+ SingleAggregatedDnsResponseDataType:
38356+ default: aggregated_dns
38357+ description: Aggregated DNS resource type.
38358+ enum:
38359+ - aggregated_dns
38360+ type: string
38361+ x-enum-varnames:
38362+ - AGGREGATED_DNS
3822538363 SlackIntegrationMetadata:
3822638364 description: Incident integration metadata for the Slack integration.
3822738365 properties:
@@ -54825,6 +54963,69 @@ paths:
5482554963 x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,
5482654964
5482754965 contact [Datadog support](https://docs.datadoghq.com/help/).'
54966+ /api/v2/network/dns/aggregate:
54967+ get:
54968+ description: Get all aggregated DNS traffic.
54969+ operationId: GetAggregatedDns
54970+ parameters:
54971+ - description: Unix timestamp (number of seconds since epoch) of the start of
54972+ the query window. If not provided, the start of the query window is 15 minutes
54973+ before the `to` timestamp. If neither `from` nor `to` are provided, the
54974+ query window is `[now - 15m, now]`.
54975+ in: query
54976+ name: from
54977+ schema:
54978+ format: int64
54979+ type: integer
54980+ - description: Unix timestamp (number of seconds since epoch) of the end of
54981+ the query window. If not provided, the end of the query window is the current
54982+ time. If neither `from` nor `to` are provided, the query window is `[now
54983+ - 15m, now]`.
54984+ in: query
54985+ name: to
54986+ schema:
54987+ format: int64
54988+ type: integer
54989+ - description: Comma-separated list of fields to group DNS traffic by. The server
54990+ side defaults to `network.dns_query` if unspecified. `server_ungrouped`
54991+ may be used if groups are not desired. The maximum number of group_by(s)
54992+ is 10.
54993+ in: query
54994+ name: group_by
54995+ schema:
54996+ type: string
54997+ - description: Comma-separated list of tags to filter DNS traffic by.
54998+ in: query
54999+ name: tags
55000+ schema:
55001+ type: string
55002+ - description: The number of aggregated DNS entries to be returned. The maximum
55003+ value is 7500.
55004+ in: query
55005+ name: limit
55006+ schema:
55007+ default: 100
55008+ format: int32
55009+ maximum: 7500
55010+ minimum: 1
55011+ type: integer
55012+ responses:
55013+ '200':
55014+ content:
55015+ application/json:
55016+ schema:
55017+ $ref: '#/components/schemas/SingleAggregatedDnsResponseArray'
55018+ description: OK
55019+ '400':
55020+ $ref: '#/components/responses/BadRequestResponse'
55021+ '429':
55022+ $ref: '#/components/responses/TooManyRequestsResponse'
55023+ summary: Get all aggregated DNS traffic
55024+ tags:
55025+ - Cloud Network Monitoring
55026+ x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,
55027+
55028+ contact [Datadog support](https://docs.datadoghq.com/help/).'
5482855029 /api/v2/on-call/escalation-policies:
5482955030 post:
5483055031 description: Create a new On-Call escalation policy
@@ -65612,7 +65813,8 @@ tags:
6561265813 documentation](https://docs.datadoghq.com/cloud_cost_management/).
6561365814 name: Cloud Cost Management
6561465815- description: The Cloud Network Monitoring API allows you to fetch aggregated connections
65615- and their attributes. See the [Cloud Network Monitoring page](https://docs.datadoghq.com/network_monitoring/cloud_network_monitoring/)
65816+ and DNS traffic with their attributes. See the [Cloud Network Monitoring page](https://docs.datadoghq.com/network_monitoring/cloud_network_monitoring/)
65817+ and [DNS Monitoring page](https://docs.datadoghq.com/network_monitoring/dns/)
6561665818 for more information.
6561765819 name: Cloud Network Monitoring
6561865820- description: Manage your Datadog Cloudflare integration directly through the Datadog
0 commit comments