@@ -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:
@@ -38383,6 +38419,133 @@ components:
3838338419 type: string
3838438420 x-enum-varnames:
3838538421 - AGGREGATED_CONNECTION
38422+ SingleAggregatedDnsResponseArray:
38423+ description: List of aggregated DNS flows.
38424+ example:
38425+ data:
38426+ - attributes:
38427+ group_bys:
38428+ - key: client_team
38429+ value: networks
38430+ - key: server_service
38431+ value: hucklebuck
38432+ metrics:
38433+ - key: dns_total_requests
38434+ value: 100
38435+ - key: dns_failures
38436+ value: 6
38437+ - key: dns_successful_responses
38438+ value: 95
38439+ - key: dns_failed_responses
38440+ value: 4
38441+ - key: dns_timeouts
38442+ value: 2
38443+ - key: dns_responses.nxdomain
38444+ value: 1
38445+ - key: dns_responses.servfail
38446+ value: 1
38447+ - key: dns_responses.other
38448+ value: 3
38449+ - key: dns_success_latency_percentile
38450+ value: 50
38451+ - key: dns_failure_latency_percentile
38452+ value: 75
38453+ id: client_team:networks, server_service:hucklebuck
38454+ type: aggregated_dns
38455+ properties:
38456+ data:
38457+ description: Array of aggregated DNS objects.
38458+ items:
38459+ $ref: '#/components/schemas/SingleAggregatedDnsResponseData'
38460+ type: array
38461+ type: object
38462+ SingleAggregatedDnsResponseData:
38463+ description: Object describing an aggregated DNS flow.
38464+ properties:
38465+ attributes:
38466+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributes'
38467+ id:
38468+ description: A unique identifier for the aggregated DNS traffic based on
38469+ the group by values.
38470+ example: client_service:example-service,network.dns_query:example.com
38471+ type: string
38472+ type:
38473+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataType'
38474+ example: aggregated_dns
38475+ type: object
38476+ SingleAggregatedDnsResponseDataAttributes:
38477+ description: Attributes for an aggregated DNS flow.
38478+ properties:
38479+ group_bys:
38480+ additionalProperties: {}
38481+ description: The key, value pairs for each group by.
38482+ example:
38483+ - key: client_service
38484+ value: example-service
38485+ - key: network.dns_query
38486+ value: example.com
38487+ items:
38488+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributesGroupByItems'
38489+ type: array
38490+ metrics:
38491+ additionalProperties: {}
38492+ description: Metrics associated with an aggregated DNS flow.
38493+ example:
38494+ - key: dns_total_requests
38495+ value: 100
38496+ - key: dns_failures
38497+ value: 7
38498+ - key: dns_successful_responses
38499+ value: 93
38500+ - key: dns_failed_responses
38501+ value: 5
38502+ - key: dns_timeouts
38503+ value: 2
38504+ - key: dns_responses.nxdomain
38505+ value: 1
38506+ - key: dns_responses.servfail
38507+ value: 1
38508+ - key: dns_responses.other
38509+ value: 3
38510+ - key: dns_success_latency_percentile
38511+ value: 50
38512+ - key: dns_failure_latency_percentile
38513+ value: 76
38514+ items:
38515+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributesMetricsItems'
38516+ type: array
38517+ type: object
38518+ SingleAggregatedDnsResponseDataAttributesGroupByItems:
38519+ description: Attributes associated with a group by
38520+ properties:
38521+ key:
38522+ description: The group by key.
38523+ type: string
38524+ value:
38525+ additionalProperties:
38526+ items:
38527+ type: string
38528+ type: array
38529+ description: The group by value.
38530+ type: object
38531+ SingleAggregatedDnsResponseDataAttributesMetricsItems:
38532+ description: Metrics associated with an aggregated DNS flow.
38533+ properties:
38534+ key:
38535+ $ref: '#/components/schemas/DnsMetricKey'
38536+ value:
38537+ description: The metric value.
38538+ format: int64
38539+ type: integer
38540+ type: object
38541+ SingleAggregatedDnsResponseDataType:
38542+ default: aggregated_dns
38543+ description: Aggregated DNS resource type.
38544+ enum:
38545+ - aggregated_dns
38546+ type: string
38547+ x-enum-varnames:
38548+ - AGGREGATED_DNS
3838638549 SlackIntegrationMetadata:
3838738550 description: Incident integration metadata for the Slack integration.
3838838551 properties:
@@ -55030,6 +55193,69 @@ paths:
5503055193 x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,
5503155194
5503255195 contact [Datadog support](https://docs.datadoghq.com/help/).'
55196+ /api/v2/network/dns/aggregate:
55197+ get:
55198+ description: Get all aggregated DNS traffic.
55199+ operationId: GetAggregatedDns
55200+ parameters:
55201+ - description: Unix timestamp (number of seconds since epoch) of the start of
55202+ the query window. If not provided, the start of the query window is 15 minutes
55203+ before the `to` timestamp. If neither `from` nor `to` are provided, the
55204+ query window is `[now - 15m, now]`.
55205+ in: query
55206+ name: from
55207+ schema:
55208+ format: int64
55209+ type: integer
55210+ - description: Unix timestamp (number of seconds since epoch) of the end of
55211+ the query window. If not provided, the end of the query window is the current
55212+ time. If neither `from` nor `to` are provided, the query window is `[now
55213+ - 15m, now]`.
55214+ in: query
55215+ name: to
55216+ schema:
55217+ format: int64
55218+ type: integer
55219+ - description: Comma-separated list of fields to group DNS traffic by. The server
55220+ side defaults to `network.dns_query` if unspecified. `server_ungrouped`
55221+ may be used if groups are not desired. The maximum number of group_by(s)
55222+ is 10.
55223+ in: query
55224+ name: group_by
55225+ schema:
55226+ type: string
55227+ - description: Comma-separated list of tags to filter DNS traffic by.
55228+ in: query
55229+ name: tags
55230+ schema:
55231+ type: string
55232+ - description: The number of aggregated DNS entries to be returned. The maximum
55233+ value is 7500.
55234+ in: query
55235+ name: limit
55236+ schema:
55237+ default: 100
55238+ format: int32
55239+ maximum: 7500
55240+ minimum: 1
55241+ type: integer
55242+ responses:
55243+ '200':
55244+ content:
55245+ application/json:
55246+ schema:
55247+ $ref: '#/components/schemas/SingleAggregatedDnsResponseArray'
55248+ description: OK
55249+ '400':
55250+ $ref: '#/components/responses/BadRequestResponse'
55251+ '429':
55252+ $ref: '#/components/responses/TooManyRequestsResponse'
55253+ summary: Get all aggregated DNS traffic
55254+ tags:
55255+ - Cloud Network Monitoring
55256+ x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,
55257+
55258+ contact [Datadog support](https://docs.datadoghq.com/help/).'
5503355259 /api/v2/on-call/escalation-policies:
5503455260 post:
5503555261 description: Create a new On-Call escalation policy
@@ -65821,7 +66047,8 @@ tags:
6582166047 documentation](https://docs.datadoghq.com/cloud_cost_management/).
6582266048 name: Cloud Cost Management
6582366049- description: The Cloud Network Monitoring API allows you to fetch aggregated connections
65824- and their attributes. See the [Cloud Network Monitoring page](https://docs.datadoghq.com/network_monitoring/cloud_network_monitoring/)
66050+ and DNS traffic with their attributes. See the [Cloud Network Monitoring page](https://docs.datadoghq.com/network_monitoring/cloud_network_monitoring/)
66051+ and [DNS Monitoring page](https://docs.datadoghq.com/network_monitoring/dns/)
6582566052 for more information.
6582666053 name: Cloud Network Monitoring
6582766054- description: Manage your Datadog Cloudflare integration directly through the Datadog
0 commit comments