@@ -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:
@@ -38383,6 +38419,131 @@ components:
38383
38419
type: string
38384
38420
x-enum-varnames:
38385
38421
- 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
+ description: The key, value pairs for each group by.
38481
+ example:
38482
+ - key: client_service
38483
+ value: example-service
38484
+ - key: network.dns_query
38485
+ value: example.com
38486
+ items:
38487
+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributesGroupByItems'
38488
+ type: array
38489
+ metrics:
38490
+ description: Metrics associated with an aggregated DNS flow.
38491
+ example:
38492
+ - key: dns_total_requests
38493
+ value: 100
38494
+ - key: dns_failures
38495
+ value: 7
38496
+ - key: dns_successful_responses
38497
+ value: 93
38498
+ - key: dns_failed_responses
38499
+ value: 5
38500
+ - key: dns_timeouts
38501
+ value: 2
38502
+ - key: dns_responses.nxdomain
38503
+ value: 1
38504
+ - key: dns_responses.servfail
38505
+ value: 1
38506
+ - key: dns_responses.other
38507
+ value: 3
38508
+ - key: dns_success_latency_percentile
38509
+ value: 50
38510
+ - key: dns_failure_latency_percentile
38511
+ value: 75
38512
+ items:
38513
+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributesMetricsItems'
38514
+ type: array
38515
+ type: object
38516
+ SingleAggregatedDnsResponseDataAttributesGroupByItems:
38517
+ description: Attributes associated with a group by
38518
+ properties:
38519
+ key:
38520
+ description: The group by key.
38521
+ type: string
38522
+ value:
38523
+ additionalProperties:
38524
+ items:
38525
+ type: string
38526
+ type: array
38527
+ description: The group by value.
38528
+ type: object
38529
+ SingleAggregatedDnsResponseDataAttributesMetricsItems:
38530
+ description: Metrics associated with an aggregated DNS flow.
38531
+ properties:
38532
+ key:
38533
+ $ref: '#/components/schemas/DnsMetricKey'
38534
+ value:
38535
+ description: The metric value.
38536
+ format: int64
38537
+ type: integer
38538
+ type: object
38539
+ SingleAggregatedDnsResponseDataType:
38540
+ default: aggregated_dns
38541
+ description: Aggregated DNS resource type.
38542
+ enum:
38543
+ - aggregated_dns
38544
+ type: string
38545
+ x-enum-varnames:
38546
+ - AGGREGATED_DNS
38386
38547
SlackIntegrationMetadata:
38387
38548
description: Incident integration metadata for the Slack integration.
38388
38549
properties:
@@ -55030,6 +55191,69 @@ paths:
55030
55191
x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,
55031
55192
55032
55193
contact [Datadog support](https://docs.datadoghq.com/help/).'
55194
+ /api/v2/network/dns/aggregate:
55195
+ get:
55196
+ description: Get all aggregated DNS traffic.
55197
+ operationId: GetAggregatedDns
55198
+ parameters:
55199
+ - description: Unix timestamp (number of seconds since epoch) of the start of
55200
+ the query window. If not provided, the start of the query window is 15 minutes
55201
+ before the `to` timestamp. If neither `from` nor `to` are provided, the
55202
+ query window is `[now - 15m, now]`.
55203
+ in: query
55204
+ name: from
55205
+ schema:
55206
+ format: int64
55207
+ type: integer
55208
+ - description: Unix timestamp (number of seconds since epoch) of the end of
55209
+ the query window. If not provided, the end of the query window is the current
55210
+ time. If neither `from` nor `to` are provided, the query window is `[now
55211
+ - 15m, now]`.
55212
+ in: query
55213
+ name: to
55214
+ schema:
55215
+ format: int64
55216
+ type: integer
55217
+ - description: Comma-separated list of fields to group DNS traffic by. The server
55218
+ side defaults to `network.dns_query` if unspecified. `server_ungrouped`
55219
+ may be used if groups are not desired. The maximum number of group_by(s)
55220
+ is 10.
55221
+ in: query
55222
+ name: group_by
55223
+ schema:
55224
+ type: string
55225
+ - description: Comma-separated list of tags to filter DNS traffic by.
55226
+ in: query
55227
+ name: tags
55228
+ schema:
55229
+ type: string
55230
+ - description: The number of aggregated DNS entries to be returned. The maximum
55231
+ value is 7500.
55232
+ in: query
55233
+ name: limit
55234
+ schema:
55235
+ default: 100
55236
+ format: int32
55237
+ maximum: 7500
55238
+ minimum: 1
55239
+ type: integer
55240
+ responses:
55241
+ '200':
55242
+ content:
55243
+ application/json:
55244
+ schema:
55245
+ $ref: '#/components/schemas/SingleAggregatedDnsResponseArray'
55246
+ description: OK
55247
+ '400':
55248
+ $ref: '#/components/responses/BadRequestResponse'
55249
+ '429':
55250
+ $ref: '#/components/responses/TooManyRequestsResponse'
55251
+ summary: Get all aggregated DNS traffic
55252
+ tags:
55253
+ - Cloud Network Monitoring
55254
+ x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,
55255
+
55256
+ contact [Datadog support](https://docs.datadoghq.com/help/).'
55033
55257
/api/v2/on-call/escalation-policies:
55034
55258
post:
55035
55259
description: Create a new On-Call escalation policy
@@ -65817,7 +66041,8 @@ tags:
65817
66041
documentation](https://docs.datadoghq.com/cloud_cost_management/).
65818
66042
name: Cloud Cost Management
65819
66043
- description: The Cloud Network Monitoring API allows you to fetch aggregated connections
65820
- and their attributes. See the [Cloud Network Monitoring page](https://docs.datadoghq.com/network_monitoring/cloud_network_monitoring/)
66044
+ and DNS traffic with their attributes. See the [Cloud Network Monitoring page](https://docs.datadoghq.com/network_monitoring/cloud_network_monitoring/)
66045
+ and [DNS Monitoring page](https://docs.datadoghq.com/network_monitoring/dns/)
65821
66046
for more information.
65822
66047
name: Cloud Network Monitoring
65823
66048
- description: Manage your Datadog Cloudflare integration directly through the Datadog
0 commit comments