@@ -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,134 @@ components:
38398
38434
type: string
38399
38435
x-enum-varnames:
38400
38436
- AGGREGATED_CONNECTION
38437
+ SingleAggregatedDnsResponseArray:
38438
+ additionalProperties: {}
38439
+ description: List of aggregated DNS flows.
38440
+ example:
38441
+ data:
38442
+ - attributes:
38443
+ group_bys:
38444
+ - key: client_team
38445
+ value: networks
38446
+ - key: server_service
38447
+ value: hucklebuck
38448
+ metrics:
38449
+ - key: dns_total_requests
38450
+ value: 100
38451
+ - key: dns_failures
38452
+ value: 6
38453
+ - key: dns_successful_responses
38454
+ value: 95
38455
+ - key: dns_failed_responses
38456
+ value: 4
38457
+ - key: dns_timeouts
38458
+ value: 2
38459
+ - key: dns_responses.nxdomain
38460
+ value: 1
38461
+ - key: dns_responses.servfail
38462
+ value: 1
38463
+ - key: dns_responses.other
38464
+ value: 3
38465
+ - key: dns_success_latency_percentile
38466
+ value: 50
38467
+ - key: dns_failure_latency_percentile
38468
+ value: 75
38469
+ id: client_team:networks, server_service:hucklebuck
38470
+ type: aggregated_dns
38471
+ properties:
38472
+ data:
38473
+ description: Array of aggregated DNS objects.
38474
+ items:
38475
+ $ref: '#/components/schemas/SingleAggregatedDnsResponseData'
38476
+ type: array
38477
+ type: object
38478
+ SingleAggregatedDnsResponseData:
38479
+ description: Object describing an aggregated DNS flow.
38480
+ properties:
38481
+ attributes:
38482
+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributes'
38483
+ id:
38484
+ description: A unique identifier for the aggregated DNS traffic based on
38485
+ the group by values.
38486
+ example: client_service:example-service,network.dns_query:example.com
38487
+ type: string
38488
+ type:
38489
+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataType'
38490
+ example: aggregated_dns
38491
+ type: object
38492
+ SingleAggregatedDnsResponseDataAttributes:
38493
+ description: Attributes for an aggregated DNS flow.
38494
+ properties:
38495
+ group_bys:
38496
+ additionalProperties: {}
38497
+ description: The key, value pairs for each group by.
38498
+ example:
38499
+ - key: client_service
38500
+ value: example-service
38501
+ - key: network.dns_query
38502
+ value: example.com
38503
+ items:
38504
+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributesGroupByItems'
38505
+ type: array
38506
+ metrics:
38507
+ additionalProperties: {}
38508
+ description: Metrics associated with an aggregated DNS flow.
38509
+ example:
38510
+ - key: dns_total_requests
38511
+ value: 100
38512
+ - key: dns_failures
38513
+ value: 7
38514
+ - key: dns_successful_responses
38515
+ value: 93
38516
+ - key: dns_failed_responses
38517
+ value: 5
38518
+ - key: dns_timeouts
38519
+ value: 2
38520
+ - key: dns_responses.nxdomain
38521
+ value: 1
38522
+ - key: dns_responses.servfail
38523
+ value: 1
38524
+ - key: dns_responses.other
38525
+ value: 3
38526
+ - key: dns_success_latency_percentile
38527
+ value: 50
38528
+ - key: dns_failure_latency_percentile
38529
+ value: 76
38530
+ items:
38531
+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributesMetricsItems'
38532
+ type: array
38533
+ type: object
38534
+ SingleAggregatedDnsResponseDataAttributesGroupByItems:
38535
+ description: Attributes associated with a group by
38536
+ properties:
38537
+ key:
38538
+ description: The group by key.
38539
+ type: string
38540
+ value:
38541
+ additionalProperties:
38542
+ items:
38543
+ type: string
38544
+ type: array
38545
+ description: The group by value.
38546
+ type: object
38547
+ SingleAggregatedDnsResponseDataAttributesMetricsItems:
38548
+ description: Metrics associated with an aggregated DNS flow.
38549
+ properties:
38550
+ key:
38551
+ $ref: '#/components/schemas/DnsMetricKey'
38552
+ value:
38553
+ description: The metric value.
38554
+ format: int64
38555
+ type: integer
38556
+ type: object
38557
+ SingleAggregatedDnsResponseDataType:
38558
+ default: aggregated_dns
38559
+ description: Aggregated DNS resource type.
38560
+ enum:
38561
+ - aggregated_dns
38562
+ type: string
38563
+ x-enum-varnames:
38564
+ - AGGREGATED_DNS
38401
38565
SlackIntegrationMetadata:
38402
38566
description: Incident integration metadata for the Slack integration.
38403
38567
properties:
@@ -55045,6 +55209,69 @@ paths:
55045
55209
x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,
55046
55210
55047
55211
contact [Datadog support](https://docs.datadoghq.com/help/).'
55212
+ /api/v2/network/dns/aggregate:
55213
+ get:
55214
+ description: Get all aggregated DNS traffic.
55215
+ operationId: GetAggregatedDns
55216
+ parameters:
55217
+ - description: Unix timestamp (number of seconds since epoch) of the start of
55218
+ the query window. If not provided, the start of the query window is 15 minutes
55219
+ before the `to` timestamp. If neither `from` nor `to` are provided, the
55220
+ query window is `[now - 15m, now]`.
55221
+ in: query
55222
+ name: from
55223
+ schema:
55224
+ format: int64
55225
+ type: integer
55226
+ - description: Unix timestamp (number of seconds since epoch) of the end of
55227
+ the query window. If not provided, the end of the query window is the current
55228
+ time. If neither `from` nor `to` are provided, the query window is `[now
55229
+ - 15m, now]`.
55230
+ in: query
55231
+ name: to
55232
+ schema:
55233
+ format: int64
55234
+ type: integer
55235
+ - description: Comma-separated list of fields to group DNS traffic by. The server
55236
+ side defaults to `network.dns_query` if unspecified. `server_ungrouped`
55237
+ may be used if groups are not desired. The maximum number of group_by(s)
55238
+ is 10.
55239
+ in: query
55240
+ name: group_by
55241
+ schema:
55242
+ type: string
55243
+ - description: Comma-separated list of tags to filter DNS traffic by.
55244
+ in: query
55245
+ name: tags
55246
+ schema:
55247
+ type: string
55248
+ - description: The number of aggregated DNS entries to be returned. The maximum
55249
+ value is 7500.
55250
+ in: query
55251
+ name: limit
55252
+ schema:
55253
+ default: 100
55254
+ format: int32
55255
+ maximum: 7500
55256
+ minimum: 1
55257
+ type: integer
55258
+ responses:
55259
+ '200':
55260
+ content:
55261
+ application/json:
55262
+ schema:
55263
+ $ref: '#/components/schemas/SingleAggregatedDnsResponseArray'
55264
+ description: OK
55265
+ '400':
55266
+ $ref: '#/components/responses/BadRequestResponse'
55267
+ '429':
55268
+ $ref: '#/components/responses/TooManyRequestsResponse'
55269
+ summary: Get all aggregated DNS traffic
55270
+ tags:
55271
+ - Cloud Network Monitoring
55272
+ x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,
55273
+
55274
+ contact [Datadog support](https://docs.datadoghq.com/help/).'
55048
55275
/api/v2/on-call/escalation-policies:
55049
55276
post:
55050
55277
description: Create a new On-Call escalation policy
@@ -65836,7 +66063,8 @@ tags:
65836
66063
documentation](https://docs.datadoghq.com/cloud_cost_management/).
65837
66064
name: Cloud Cost Management
65838
66065
- 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/)
66066
+ and DNS traffic with their attributes. See the [Cloud Network Monitoring page](https://docs.datadoghq.com/network_monitoring/cloud_network_monitoring/)
66067
+ and [DNS Monitoring page](https://docs.datadoghq.com/network_monitoring/dns/)
65840
66068
for more information.
65841
66069
name: Cloud Network Monitoring
65842
66070
- description: Manage your Datadog Cloudflare integration directly through the Datadog
0 commit comments