@@ -12925,6 +12925,42 @@ components:
12925
12925
description: The type of the resource. The value should always be device.
12926
12926
type: string
12927
12927
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
12928
12964
DomainAllowlist:
12929
12965
description: The email domain allowlist for an org.
12930
12966
properties:
@@ -38398,6 +38434,75 @@ components:
38398
38434
type: string
38399
38435
x-enum-varnames:
38400
38436
- 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
38401
38506
SlackIntegrationMetadata:
38402
38507
description: Incident integration metadata for the Slack integration.
38403
38508
properties:
@@ -55045,6 +55150,69 @@ paths:
55045
55150
x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,
55046
55151
55047
55152
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/).'
55048
55216
/api/v2/on-call/escalation-policies:
55049
55217
post:
55050
55218
description: Create a new On-Call escalation policy
@@ -65836,7 +66004,8 @@ tags:
65836
66004
documentation](https://docs.datadoghq.com/cloud_cost_management/).
65837
66005
name: Cloud Cost Management
65838
66006
- 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/)
65840
66009
for more information.
65841
66010
name: Cloud Network Monitoring
65842
66011
- description: Manage your Datadog Cloudflare integration directly through the Datadog
0 commit comments