@@ -12826,6 +12826,42 @@ 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+ type: string
12843+ x-enum-descriptions:
12844+ - The total number of DNS requests made by the client.
12845+ - The total number of timeouts and errors in DNS requests.
12846+ - The total number of successful DNS responses.
12847+ - The total number of failed DNS responses.
12848+ - The total number of DNS timeouts.
12849+ - The total number of DNS responses with the NXDOMAIN error code.
12850+ - The total number of DNS responses with the SERVFAIL error code.
12851+ - The total number of DNS responses with other error codes.
12852+ - The latency percentile for successful DNS responses.
12853+ - The latency percentile for failed DNS responses.
12854+ x-enum-varnames:
12855+ - DNS_TOTAL_REQUESTS
12856+ - DNS_FAILURES
12857+ - DNS_SUCCESSFUL_RESPONSES
12858+ - DNS_FAILED_RESPONSES
12859+ - DNS_TIMEOUTS
12860+ - DNS_RESPONSES_NXDOMAIN
12861+ - DNS_RESPONSES_SERVFAIL
12862+ - DNS_RESPONSES_OTHER
12863+ - DNS_SUCCESS_LATENCY_PERCENTILE
12864+ - DNS_FAILURE_LATENCY_PERCENTILE
1282912865 DomainAllowlist:
1283012866 description: The email domain allowlist for an org.
1283112867 properties:
@@ -38284,6 +38320,131 @@ components:
3828438320 type: string
3828538321 x-enum-varnames:
3828638322 - AGGREGATED_CONNECTION
38323+ SingleAggregatedDnsResponseArray:
38324+ description: List of aggregated DNS flows.
38325+ example:
38326+ data:
38327+ - attributes:
38328+ group_bys:
38329+ - key: client_team
38330+ value: networks
38331+ - key: server_service
38332+ value: hucklebuck
38333+ metrics:
38334+ - key: dns_total_requests
38335+ value: 100
38336+ - key: dns_failures
38337+ value: 6
38338+ - key: dns_successful_responses
38339+ value: 95
38340+ - key: dns_failed_responses
38341+ value: 4
38342+ - key: dns_timeouts
38343+ value: 2
38344+ - key: dns_responses.nxdomain
38345+ value: 1
38346+ - key: dns_responses.servfail
38347+ value: 1
38348+ - key: dns_responses.other
38349+ value: 3
38350+ - key: dns_success_latency_percentile
38351+ value: 50
38352+ - key: dns_failure_latency_percentile
38353+ value: 75
38354+ id: client_team:networks, server_service:hucklebuck
38355+ type: aggregated_dns
38356+ properties:
38357+ data:
38358+ description: Array of aggregated DNS objects.
38359+ items:
38360+ $ref: '#/components/schemas/SingleAggregatedDnsResponseData'
38361+ type: array
38362+ type: object
38363+ SingleAggregatedDnsResponseData:
38364+ description: Object describing an aggregated DNS flow.
38365+ properties:
38366+ attributes:
38367+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributes'
38368+ id:
38369+ description: A unique identifier for the aggregated DNS traffic based on
38370+ the group by values.
38371+ example: client_service:example-service,network.dns_query:example.com
38372+ type: string
38373+ type:
38374+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataType'
38375+ example: aggregated_dns
38376+ type: object
38377+ SingleAggregatedDnsResponseDataAttributes:
38378+ description: Attributes for an aggregated DNS flow.
38379+ properties:
38380+ group_bys:
38381+ description: The key, value pairs for each group by.
38382+ example:
38383+ - key: client_service
38384+ value: example-service
38385+ - key: network.dns_query
38386+ value: example.com
38387+ items:
38388+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributesGroupByItems'
38389+ type: array
38390+ metrics:
38391+ description: Metrics associated with an aggregated DNS flow.
38392+ example:
38393+ - key: dns_total_requests
38394+ value: 100
38395+ - key: dns_failures
38396+ value: 7
38397+ - key: dns_successful_responses
38398+ value: 93
38399+ - key: dns_failed_responses
38400+ value: 5
38401+ - key: dns_timeouts
38402+ value: 2
38403+ - key: dns_responses.nxdomain
38404+ value: 1
38405+ - key: dns_responses.servfail
38406+ value: 1
38407+ - key: dns_responses.other
38408+ value: 3
38409+ - key: dns_success_latency_percentile
38410+ value: 50
38411+ - key: dns_failure_latency_percentile
38412+ value: 75
38413+ items:
38414+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributesMetricsItems'
38415+ type: array
38416+ type: object
38417+ SingleAggregatedDnsResponseDataAttributesGroupByItems:
38418+ description: Attributes associated with a group by
38419+ properties:
38420+ key:
38421+ description: The group by key.
38422+ type: string
38423+ value:
38424+ additionalProperties:
38425+ items:
38426+ type: string
38427+ type: array
38428+ description: The group by value.
38429+ type: object
38430+ SingleAggregatedDnsResponseDataAttributesMetricsItems:
38431+ description: Metrics associated with an aggregated DNS flow.
38432+ properties:
38433+ key:
38434+ $ref: '#/components/schemas/DnsMetricKey'
38435+ value:
38436+ description: The metric value.
38437+ format: int64
38438+ type: integer
38439+ type: object
38440+ SingleAggregatedDnsResponseDataType:
38441+ default: aggregated_dns
38442+ description: Aggregated DNS resource type.
38443+ enum:
38444+ - aggregated_dns
38445+ type: string
38446+ x-enum-varnames:
38447+ - AGGREGATED_DNS
3828738448 SlackIntegrationMetadata:
3828838449 description: Incident integration metadata for the Slack integration.
3828938450 properties:
@@ -54931,6 +55092,69 @@ paths:
5493155092 x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,
5493255093
5493355094 contact [Datadog support](https://docs.datadoghq.com/help/).'
55095+ /api/v2/network/dns/aggregate:
55096+ get:
55097+ description: Get all aggregated DNS traffic.
55098+ operationId: GetAggregatedDns
55099+ parameters:
55100+ - description: Unix timestamp (number of seconds since epoch) of the start of
55101+ the query window. If not provided, the start of the query window is 15 minutes
55102+ before the `to` timestamp. If neither `from` nor `to` are provided, the
55103+ query window is `[now - 15m, now]`.
55104+ in: query
55105+ name: from
55106+ schema:
55107+ format: int64
55108+ type: integer
55109+ - description: Unix timestamp (number of seconds since epoch) of the end of
55110+ the query window. If not provided, the end of the query window is the current
55111+ time. If neither `from` nor `to` are provided, the query window is `[now
55112+ - 15m, now]`.
55113+ in: query
55114+ name: to
55115+ schema:
55116+ format: int64
55117+ type: integer
55118+ - description: Comma-separated list of fields to group DNS traffic by. The server
55119+ side defaults to `network.dns_query` if unspecified. `server_ungrouped`
55120+ may be used if groups are not desired. The maximum number of group_by(s)
55121+ is 10.
55122+ in: query
55123+ name: group_by
55124+ schema:
55125+ type: string
55126+ - description: Comma-separated list of tags to filter DNS traffic by.
55127+ in: query
55128+ name: tags
55129+ schema:
55130+ type: string
55131+ - description: The number of aggregated DNS entries to be returned. The maximum
55132+ value is 7500.
55133+ in: query
55134+ name: limit
55135+ schema:
55136+ default: 100
55137+ format: int32
55138+ maximum: 7500
55139+ minimum: 1
55140+ type: integer
55141+ responses:
55142+ '200':
55143+ content:
55144+ application/json:
55145+ schema:
55146+ $ref: '#/components/schemas/SingleAggregatedDnsResponseArray'
55147+ description: OK
55148+ '400':
55149+ $ref: '#/components/responses/BadRequestResponse'
55150+ '429':
55151+ $ref: '#/components/responses/TooManyRequestsResponse'
55152+ summary: Get all aggregated DNS traffic
55153+ tags:
55154+ - Cloud Network Monitoring
55155+ x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,
55156+
55157+ contact [Datadog support](https://docs.datadoghq.com/help/).'
5493455158 /api/v2/on-call/escalation-policies:
5493555159 post:
5493655160 description: Create a new On-Call escalation policy
@@ -65718,7 +65942,8 @@ tags:
6571865942 documentation](https://docs.datadoghq.com/cloud_cost_management/).
6571965943 name: Cloud Cost Management
6572065944- description: The Cloud Network Monitoring API allows you to fetch aggregated connections
65721- and their attributes. See the [Cloud Network Monitoring page](https://docs.datadoghq.com/network_monitoring/cloud_network_monitoring/)
65945+ and DNS traffic with their attributes. See the [Cloud Network Monitoring page](https://docs.datadoghq.com/network_monitoring/cloud_network_monitoring/)
65946+ and [DNS Monitoring page](https://docs.datadoghq.com/network_monitoring/dns/)
6572265947 for more information.
6572365948 name: Cloud Network Monitoring
6572465949- description: Manage your Datadog Cloudflare integration directly through the Datadog
0 commit comments