@@ -12634,6 +12634,43 @@ components:
1263412634 description: The type of the resource. The value should always be device.
1263512635 type: string
1263612636 type: object
12637+ DnsMetricKey:
12638+ description: The metric key for DNS metrics.
12639+ enum:
12640+ - dns_total_requests
12641+ - dns_failures
12642+ - dns_successful_responses
12643+ - dns_failed_responses
12644+ - dns_timeouts
12645+ - dns_responses.nxdomain
12646+ - dns_responses.servfail
12647+ - dns_responses.other
12648+ - dns_success_latency_percentile
12649+ - dns_failure_latency_percentile
12650+ example: dns_total_requests
12651+ type: string
12652+ x-enum-descriptions:
12653+ - The total number of DNS requests made by the client.
12654+ - The total number of timeouts and errors in DNS requests.
12655+ - The total number of successful DNS responses.
12656+ - The total number of failed DNS responses.
12657+ - The total number of DNS timeouts.
12658+ - The total number of DNS responses with the NXDOMAIN error code.
12659+ - The total number of DNS responses with the SERVFAIL error code.
12660+ - The total number of DNS responses with other error codes.
12661+ - The latency percentile for successful DNS responses.
12662+ - The latency percentile for failed DNS responses.
12663+ x-enum-varnames:
12664+ - DNS_TOTAL_REQUESTS
12665+ - DNS_FAILURES
12666+ - DNS_SUCCESSFUL_RESPONSES
12667+ - DNS_FAILED_RESPONSES
12668+ - DNS_TIMEOUTS
12669+ - DNS_RESPONSES_NXDOMAIN
12670+ - DNS_RESPONSES_SERVFAIL
12671+ - DNS_RESPONSES_OTHER
12672+ - DNS_SUCCESS_LATENCY_PERCENTILE
12673+ - DNS_FAILURE_LATENCY_PERCENTILE
1263712674 DomainAllowlist:
1263812675 description: The email domain allowlist for an org.
1263912676 properties:
@@ -37990,6 +38027,107 @@ components:
3799038027 type: string
3799138028 x-enum-varnames:
3799238029 - AGGREGATED_CONNECTION
38030+ SingleAggregatedDnsResponseArray:
38031+ description: List of aggregated DNS flows.
38032+ example:
38033+ data:
38034+ - attributes:
38035+ group_bys:
38036+ - key: client_team
38037+ value: networks
38038+ - key: server_service
38039+ value: hucklebuck
38040+ metrics:
38041+ - key: dns_total_requests
38042+ value: 100
38043+ - key: dns_failures
38044+ value: 6
38045+ - key: dns_successful_responses
38046+ value: 95
38047+ - key: dns_failed_responses
38048+ value: 4
38049+ - key: dns_timeouts
38050+ value: 2
38051+ - key: dns_responses.nxdomain
38052+ value: 1
38053+ - key: dns_responses.servfail
38054+ value: 1
38055+ - key: dns_responses.other
38056+ value: 3
38057+ - key: dns_success_latency_percentile
38058+ value: 50
38059+ - key: dns_failure_latency_percentile
38060+ value: 75
38061+ id: client_team:networks, server_service:hucklebuck
38062+ type: aggregated_dns
38063+ properties:
38064+ data:
38065+ description: Array of aggregated DNS flow objects.
38066+ items:
38067+ $ref: '#/components/schemas/SingleAggregatedDnsResponseData'
38068+ type: array
38069+ type: object
38070+ SingleAggregatedDnsResponseData:
38071+ description: Object describing an aggregated DNS flow.
38072+ properties:
38073+ attributes:
38074+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributes'
38075+ id:
38076+ description: A unique identifier for the aggregated DNS traffic based on
38077+ the group by values.
38078+ type: string
38079+ type:
38080+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataType'
38081+ type: object
38082+ SingleAggregatedDnsResponseDataAttributes:
38083+ description: Attributes for an aggregated DNS flow.
38084+ properties:
38085+ group_bys:
38086+ description: The key, value pairs for each group by.
38087+ items:
38088+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributesGroupByItems'
38089+ type: array
38090+ metrics:
38091+ description: Metrics associated with an aggregated DNS flow.
38092+ items:
38093+ $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributesMetricsItems'
38094+ type: array
38095+ type: object
38096+ SingleAggregatedDnsResponseDataAttributesGroupByItems:
38097+ description: Attributes associated with a group by
38098+ properties:
38099+ key:
38100+ description: The group by key.
38101+ type: string
38102+ value:
38103+ additionalProperties:
38104+ items:
38105+ type: string
38106+ type: array
38107+ description: The group by value.
38108+ type: object
38109+ SingleAggregatedDnsResponseDataAttributesMetricsItems:
38110+ description: Metrics associated with an aggregated DNS flow.
38111+ properties:
38112+ key:
38113+ $ref: '#/components/schemas/DnsMetricKey'
38114+ value:
38115+ description: The metric value.
38116+ example: 1
38117+ format: int64
38118+ type: integer
38119+ required:
38120+ - key
38121+ - value
38122+ type: object
38123+ SingleAggregatedDnsResponseDataType:
38124+ default: aggregated_dns
38125+ description: Aggregated DNS resource type.
38126+ enum:
38127+ - aggregated_dns
38128+ type: string
38129+ x-enum-varnames:
38130+ - AGGREGATED_DNS
3799338131 SlackIntegrationMetadata:
3799438132 description: Incident integration metadata for the Slack integration.
3799538133 properties:
@@ -54460,6 +54598,69 @@ paths:
5446054598 x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,
5446154599
5446254600 contact [Datadog support](https://docs.datadoghq.com/help/).'
54601+ /api/v2/network/dns/aggregate:
54602+ get:
54603+ description: Get all aggregated DNS traffic.
54604+ operationId: GetAggregatedDns
54605+ parameters:
54606+ - description: Unix timestamp (number of seconds since epoch) of the start of
54607+ the query window. If not provided, the start of the query window is 15 minutes
54608+ before the `to` timestamp. If neither `from` nor `to` are provided, the
54609+ query window is `[now - 15m, now]`.
54610+ in: query
54611+ name: from
54612+ schema:
54613+ format: int64
54614+ type: integer
54615+ - description: Unix timestamp (number of seconds since epoch) of the end of
54616+ the query window. If not provided, the end of the query window is the current
54617+ time. If neither `from` nor `to` are provided, the query window is `[now
54618+ - 15m, now]`.
54619+ in: query
54620+ name: to
54621+ schema:
54622+ format: int64
54623+ type: integer
54624+ - description: Comma-separated list of fields to group DNS traffic by. The server
54625+ side defaults to `network.dns_query` if unspecified. `server_ungrouped`
54626+ may be used if groups are not desired. The maximum number of group_by(s)
54627+ is 10.
54628+ in: query
54629+ name: group_by
54630+ schema:
54631+ type: string
54632+ - description: Comma-separated list of tags to filter DNS traffic by.
54633+ in: query
54634+ name: tags
54635+ schema:
54636+ type: string
54637+ - description: The number of aggregated DNS entries to be returned. The maximum
54638+ value is 7500.
54639+ in: query
54640+ name: limit
54641+ schema:
54642+ default: 100
54643+ format: int32
54644+ maximum: 7500
54645+ minimum: 1
54646+ type: integer
54647+ responses:
54648+ '200':
54649+ content:
54650+ application/json:
54651+ schema:
54652+ $ref: '#/components/schemas/SingleAggregatedDnsResponseArray'
54653+ description: OK
54654+ '400':
54655+ $ref: '#/components/responses/BadRequestResponse'
54656+ '429':
54657+ $ref: '#/components/responses/TooManyRequestsResponse'
54658+ summary: Get all aggregated DNS traffic
54659+ tags:
54660+ - Cloud Network Monitoring
54661+ x-unstable: '**Note**: This endpoint is in Preview. If you have any feedback,
54662+
54663+ contact [Datadog support](https://docs.datadoghq.com/help/).'
5446354664 /api/v2/on-call/escalation-policies:
5446454665 post:
5446554666 description: Create a new On-Call escalation policy
@@ -65264,7 +65465,8 @@ tags:
6526465465 documentation](https://docs.datadoghq.com/cloud_cost_management/).
6526565466 name: Cloud Cost Management
6526665467- description: The Cloud Network Monitoring API allows you to fetch aggregated connections
65267- and their attributes. See the [Cloud Network Monitoring page](https://docs.datadoghq.com/network_monitoring/cloud_network_monitoring/)
65468+ and DNS traffic with their attributes. See the [Cloud Network Monitoring page](https://docs.datadoghq.com/network_monitoring/cloud_network_monitoring/)
65469+ and [DNS Monitoring page](https://docs.datadoghq.com/network_monitoring/dns/)
6526865470 for more information.
6526965471 name: Cloud Network Monitoring
6527065472- description: Manage your Datadog Cloudflare integration directly through the Datadog
0 commit comments