@@ -12826,6 +12826,42 @@ components:
12826
12826
description: The type of the resource. The value should always be device.
12827
12827
type: string
12828
12828
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
12829
12865
DomainAllowlist:
12830
12866
description: The email domain allowlist for an org.
12831
12867
properties:
@@ -38284,6 +38320,131 @@ components:
38284
38320
type: string
38285
38321
x-enum-varnames:
38286
38322
- 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
38287
38448
SlackIntegrationMetadata:
38288
38449
description: Incident integration metadata for the Slack integration.
38289
38450
properties:
@@ -54931,6 +55092,69 @@ paths:
54931
55092
x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,
54932
55093
54933
55094
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/).'
54934
55158
/api/v2/on-call/escalation-policies:
54935
55159
post:
54936
55160
description: Create a new On-Call escalation policy
@@ -65718,7 +65942,8 @@ tags:
65718
65942
documentation](https://docs.datadoghq.com/cloud_cost_management/).
65719
65943
name: Cloud Cost Management
65720
65944
- 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/)
65722
65947
for more information.
65723
65948
name: Cloud Network Monitoring
65724
65949
- description: Manage your Datadog Cloudflare integration directly through the Datadog
0 commit comments