@@ -12789,6 +12789,42 @@ components:
12789
12789
description: The type of the resource. The value should always be device.
12790
12790
type: string
12791
12791
type: object
12792
+ DnsMetricKey:
12793
+ description: The metric key for DNS metrics.
12794
+ enum:
12795
+ - dns_total_requests
12796
+ - dns_failures
12797
+ - dns_successful_responses
12798
+ - dns_failed_responses
12799
+ - dns_timeouts
12800
+ - dns_responses.nxdomain
12801
+ - dns_responses.servfail
12802
+ - dns_responses.other
12803
+ - dns_success_latency_percentile
12804
+ - dns_failure_latency_percentile
12805
+ type: string
12806
+ x-enum-descriptions:
12807
+ - The total number of DNS requests made by the client.
12808
+ - The total number of timeouts and errors in DNS requests.
12809
+ - The total number of successful DNS responses.
12810
+ - The total number of failed DNS responses.
12811
+ - The total number of DNS timeouts.
12812
+ - The total number of DNS responses with the NXDOMAIN error code.
12813
+ - The total number of DNS responses with the SERVFAIL error code.
12814
+ - The total number of DNS responses with other error codes.
12815
+ - The latency percentile for successful DNS responses.
12816
+ - The latency percentile for failed DNS responses.
12817
+ x-enum-varnames:
12818
+ - DNS_TOTAL_REQUESTS
12819
+ - DNS_FAILURES
12820
+ - DNS_SUCCESSFUL_RESPONSES
12821
+ - DNS_FAILED_RESPONSES
12822
+ - DNS_TIMEOUTS
12823
+ - DNS_RESPONSES_NXDOMAIN
12824
+ - DNS_RESPONSES_SERVFAIL
12825
+ - DNS_RESPONSES_OTHER
12826
+ - DNS_SUCCESS_LATENCY_PERCENTILE
12827
+ - DNS_FAILURE_LATENCY_PERCENTILE
12792
12828
DomainAllowlist:
12793
12829
description: The email domain allowlist for an org.
12794
12830
properties:
@@ -39059,6 +39095,131 @@ components:
39059
39095
type: string
39060
39096
x-enum-varnames:
39061
39097
- AGGREGATED_CONNECTION
39098
+ SingleAggregatedDnsResponseArray:
39099
+ description: List of aggregated DNS flows.
39100
+ example:
39101
+ data:
39102
+ - attributes:
39103
+ group_bys:
39104
+ - key: client_team
39105
+ value: networks
39106
+ - key: server_service
39107
+ value: hucklebuck
39108
+ metrics:
39109
+ - key: dns_total_requests
39110
+ value: 100
39111
+ - key: dns_failures
39112
+ value: 6
39113
+ - key: dns_successful_responses
39114
+ value: 95
39115
+ - key: dns_failed_responses
39116
+ value: 4
39117
+ - key: dns_timeouts
39118
+ value: 2
39119
+ - key: dns_responses.nxdomain
39120
+ value: 1
39121
+ - key: dns_responses.servfail
39122
+ value: 1
39123
+ - key: dns_responses.other
39124
+ value: 3
39125
+ - key: dns_success_latency_percentile
39126
+ value: 50
39127
+ - key: dns_failure_latency_percentile
39128
+ value: 75
39129
+ id: client_team:networks, server_service:hucklebuck
39130
+ type: aggregated_dns
39131
+ properties:
39132
+ data:
39133
+ description: Array of aggregated DNS objects.
39134
+ items:
39135
+ $ref: '#/components/schemas/SingleAggregatedDnsResponseData'
39136
+ type: array
39137
+ type: object
39138
+ SingleAggregatedDnsResponseData:
39139
+ description: Object describing an aggregated DNS flow.
39140
+ properties:
39141
+ attributes:
39142
+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributes'
39143
+ id:
39144
+ description: A unique identifier for the aggregated DNS traffic based on
39145
+ the group by values.
39146
+ example: client_service:example-service,network.dns_query:example.com
39147
+ type: string
39148
+ type:
39149
+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataType'
39150
+ example: aggregated_dns
39151
+ type: object
39152
+ SingleAggregatedDnsResponseDataAttributes:
39153
+ description: Attributes for an aggregated DNS flow.
39154
+ properties:
39155
+ group_bys:
39156
+ description: The key, value pairs for each group by.
39157
+ example:
39158
+ - key: client_service
39159
+ value: example-service
39160
+ - key: network.dns_query
39161
+ value: example.com
39162
+ items:
39163
+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributesGroupByItems'
39164
+ type: array
39165
+ metrics:
39166
+ description: Metrics associated with an aggregated DNS flow.
39167
+ example:
39168
+ - key: dns_total_requests
39169
+ value: 100
39170
+ - key: dns_failures
39171
+ value: 7
39172
+ - key: dns_successful_responses
39173
+ value: 93
39174
+ - key: dns_failed_responses
39175
+ value: 5
39176
+ - key: dns_timeouts
39177
+ value: 2
39178
+ - key: dns_responses.nxdomain
39179
+ value: 1
39180
+ - key: dns_responses.servfail
39181
+ value: 1
39182
+ - key: dns_responses.other
39183
+ value: 3
39184
+ - key: dns_success_latency_percentile
39185
+ value: 50
39186
+ - key: dns_failure_latency_percentile
39187
+ value: 75
39188
+ items:
39189
+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributesMetricsItems'
39190
+ type: array
39191
+ type: object
39192
+ SingleAggregatedDnsResponseDataAttributesGroupByItems:
39193
+ description: Attributes associated with a group by
39194
+ properties:
39195
+ key:
39196
+ description: The group by key.
39197
+ type: string
39198
+ value:
39199
+ additionalProperties:
39200
+ items:
39201
+ type: string
39202
+ type: array
39203
+ description: The group by value.
39204
+ type: object
39205
+ SingleAggregatedDnsResponseDataAttributesMetricsItems:
39206
+ description: Metrics associated with an aggregated DNS flow.
39207
+ properties:
39208
+ key:
39209
+ $ref: '#/components/schemas/DnsMetricKey'
39210
+ value:
39211
+ description: The metric value.
39212
+ format: int64
39213
+ type: integer
39214
+ type: object
39215
+ SingleAggregatedDnsResponseDataType:
39216
+ default: aggregated_dns
39217
+ description: Aggregated DNS resource type.
39218
+ enum:
39219
+ - aggregated_dns
39220
+ type: string
39221
+ x-enum-varnames:
39222
+ - AGGREGATED_DNS
39062
39223
SlackIntegrationMetadata:
39063
39224
description: Incident integration metadata for the Slack integration.
39064
39225
properties:
@@ -57562,6 +57723,72 @@ paths:
57562
57723
x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,
57563
57724
57564
57725
contact [Datadog support](https://docs.datadoghq.com/help/).'
57726
+ /api/v2/network/dns/aggregate:
57727
+ get:
57728
+ description: Get all aggregated DNS traffic.
57729
+ operationId: GetAggregatedDns
57730
+ parameters:
57731
+ - description: Unix timestamp (number of seconds since epoch) of the start of
57732
+ the query window. If not provided, the start of the query window is 15 minutes
57733
+ before the `to` timestamp. If neither `from` nor `to` are provided, the
57734
+ query window is `[now - 15m, now]`.
57735
+ in: query
57736
+ name: from
57737
+ schema:
57738
+ format: int64
57739
+ type: integer
57740
+ - description: Unix timestamp (number of seconds since epoch) of the end of
57741
+ the query window. If not provided, the end of the query window is the current
57742
+ time. If neither `from` nor `to` are provided, the query window is `[now
57743
+ - 15m, now]`.
57744
+ in: query
57745
+ name: to
57746
+ schema:
57747
+ format: int64
57748
+ type: integer
57749
+ - description: Comma-separated list of fields to group DNS traffic by. The server
57750
+ side defaults to `network.dns_query` if unspecified. `server_ungrouped`
57751
+ may be used if groups are not desired. The maximum number of group_by(s)
57752
+ is 10.
57753
+ in: query
57754
+ name: group_by
57755
+ schema:
57756
+ type: string
57757
+ - description: Comma-separated list of tags to filter DNS traffic by.
57758
+ in: query
57759
+ name: tags
57760
+ schema:
57761
+ type: string
57762
+ - description: The number of aggregated DNS entries to be returned. The maximum
57763
+ value is 7500.
57764
+ in: query
57765
+ name: limit
57766
+ schema:
57767
+ default: 100
57768
+ format: int32
57769
+ maximum: 7500
57770
+ minimum: 1
57771
+ type: integer
57772
+ responses:
57773
+ '200':
57774
+ content:
57775
+ application/json:
57776
+ schema:
57777
+ $ref: '#/components/schemas/SingleAggregatedDnsResponseArray'
57778
+ description: OK
57779
+ '400':
57780
+ $ref: '#/components/responses/BadRequestResponse'
57781
+ '429':
57782
+ $ref: '#/components/responses/TooManyRequestsResponse'
57783
+ summary: Get all aggregated DNS traffic
57784
+ tags:
57785
+ - Cloud Network Monitoring
57786
+ x-menu-order: 2
57787
+ x-undo:
57788
+ type: safe
57789
+ x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,
57790
+
57791
+ contact [Datadog support](https://docs.datadoghq.com/help/).'
57565
57792
/api/v2/on-call/escalation-policies:
57566
57793
post:
57567
57794
description: Create a new On-Call escalation policy
@@ -70287,7 +70514,8 @@ tags:
70287
70514
documentation](https://docs.datadoghq.com/cloud_cost_management/).
70288
70515
name: Cloud Cost Management
70289
70516
- description: The Cloud Network Monitoring API allows you to fetch aggregated connections
70290
- and their attributes. See the [Cloud Network Monitoring page](https://docs.datadoghq.com/network_monitoring/cloud_network_monitoring/)
70517
+ and DNS traffic with their attributes. See the [Cloud Network Monitoring page](https://docs.datadoghq.com/network_monitoring/cloud_network_monitoring/)
70518
+ and [DNS Monitoring page](https://docs.datadoghq.com/network_monitoring/dns/)
70291
70519
for more information.
70292
70520
name: Cloud Network Monitoring
70293
70521
- description: Manage your Datadog Cloudflare integration directly through the Datadog
0 commit comments