## Get DNS time series grouped by dimension `client.Radar.DNS.TimeseriesGroupsV2(ctx, dimension, query) (*DNSTimeseriesGroupsV2Response, error)` **get** `/radar/dns/timeseries_groups/{dimension}` Retrieves the distribution of DNS queries grouped by dimension over time. ### Parameters - `dimension DNSTimeseriesGroupsV2ParamsDimension` Specifies the attribute by which to group the results. Grouping by `TLD_DNS_MAGNITUDE` does not support sub-daily aggregation intervals; `15m` and `1h` are raised to `1d`. - `const DNSTimeseriesGroupsV2ParamsDimensionAs DNSTimeseriesGroupsV2ParamsDimension = "AS"` - `const DNSTimeseriesGroupsV2ParamsDimensionCacheHit DNSTimeseriesGroupsV2ParamsDimension = "CACHE_HIT"` - `const DNSTimeseriesGroupsV2ParamsDimensionDNSSEC DNSTimeseriesGroupsV2ParamsDimension = "DNSSEC"` - `const DNSTimeseriesGroupsV2ParamsDimensionDNSSECAware DNSTimeseriesGroupsV2ParamsDimension = "DNSSEC_AWARE"` - `const DNSTimeseriesGroupsV2ParamsDimensionDNSSECE2E DNSTimeseriesGroupsV2ParamsDimension = "DNSSEC_E2E"` - `const DNSTimeseriesGroupsV2ParamsDimensionIPVersion DNSTimeseriesGroupsV2ParamsDimension = "IP_VERSION"` - `const DNSTimeseriesGroupsV2ParamsDimensionLocation DNSTimeseriesGroupsV2ParamsDimension = "LOCATION"` - `const DNSTimeseriesGroupsV2ParamsDimensionMatchingAnswer DNSTimeseriesGroupsV2ParamsDimension = "MATCHING_ANSWER"` - `const DNSTimeseriesGroupsV2ParamsDimensionProtocol DNSTimeseriesGroupsV2ParamsDimension = "PROTOCOL"` - `const DNSTimeseriesGroupsV2ParamsDimensionQueryType DNSTimeseriesGroupsV2ParamsDimension = "QUERY_TYPE"` - `const DNSTimeseriesGroupsV2ParamsDimensionResponseCode DNSTimeseriesGroupsV2ParamsDimension = "RESPONSE_CODE"` - `const DNSTimeseriesGroupsV2ParamsDimensionResponseTTL DNSTimeseriesGroupsV2ParamsDimension = "RESPONSE_TTL"` - `const DNSTimeseriesGroupsV2ParamsDimensionTLD DNSTimeseriesGroupsV2ParamsDimension = "TLD"` - `const DNSTimeseriesGroupsV2ParamsDimensionTLDDNSMagnitude DNSTimeseriesGroupsV2ParamsDimension = "TLD_DNS_MAGNITUDE"` - `query DNSTimeseriesGroupsV2Params` - `AggInterval param.Field[DNSTimeseriesGroupsV2ParamsAggInterval]` Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://edgetunnel-b2h.pages.dev/radar/concepts/aggregation-intervals/). When omitted, the interval is auto-selected from the requested date range; finer intervals are only available for shorter ranges. If the requested interval is too granular for the date range, the request is rejected. - `const DNSTimeseriesGroupsV2ParamsAggInterval15m DNSTimeseriesGroupsV2ParamsAggInterval = "15m"` - `const DNSTimeseriesGroupsV2ParamsAggInterval1h DNSTimeseriesGroupsV2ParamsAggInterval = "1h"` - `const DNSTimeseriesGroupsV2ParamsAggInterval1d DNSTimeseriesGroupsV2ParamsAggInterval = "1d"` - `const DNSTimeseriesGroupsV2ParamsAggInterval1w DNSTimeseriesGroupsV2ParamsAggInterval = "1w"` - `ASN param.Field[[]string]` Filters results by Autonomous System. Specify one or more Autonomous System Numbers (ASNs) as a comma-separated list. Prefix with `-` to exclude ASNs from results. For example, `-174, 3356` excludes results from AS174, but includes results from AS3356. - `CacheHit param.Field[[]bool]` Filters results based on cache status. - `Continent param.Field[[]string]` Filters results by continent. Specify a comma-separated list of alpha-2 codes. Prefix with `-` to exclude continents from results. For example, `-EU,NA` excludes results from EU, but includes results from NA. - `DateEnd param.Field[[]Time]` End of the date range (inclusive). Alternative to `dateRange`; provide together with `dateStart`. When requesting comparison series, every series must resolve to the same duration as the main series. Each `dateStart`/`dateEnd` is floored to the nearest 15 minutes before evaluation, so windows whose durations match only before alignment may be rejected. - `DateRange param.Field[[]string]` Filters results by relative date range ending at the current time, with each value producing a separate series. Use `d` for days (up to `364d`) or `w` for weeks (up to `52w`). Append `control` to request the equivalent previous period for comparison: the comparison window is shifted back by the current window's length rounded up to a whole number of weeks, so it keeps the same weekday alignment and does not overlap the current window (e.g. `7dcontrol` covers days -14 to -7, `10dcontrol` covers days -24 to -14). For example, pass `7d` and `7dcontrol` to compare this week with the previous week. All series must resolve to the same duration as the main series; relative ranges (including `control`) satisfy this automatically. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters). - `DateStart param.Field[[]Time]` Start of the date range. Alternative to `dateRange`; provide together with `dateEnd`. When requesting comparison series, every series must resolve to the same duration as the main series. Each `dateStart`/`dateEnd` is floored to the nearest 15 minutes before evaluation, so windows whose durations match only before alignment may be rejected. - `DNSSEC param.Field[[]DNSTimeseriesGroupsV2ParamsDNSSEC]` Filters results based on DNSSEC (DNS Security Extensions) support. - `const DNSTimeseriesGroupsV2ParamsDNSSECInvalid DNSTimeseriesGroupsV2ParamsDNSSEC = "INVALID"` - `const DNSTimeseriesGroupsV2ParamsDNSSECInsecure DNSTimeseriesGroupsV2ParamsDNSSEC = "INSECURE"` - `const DNSTimeseriesGroupsV2ParamsDNSSECSecure DNSTimeseriesGroupsV2ParamsDNSSEC = "SECURE"` - `const DNSTimeseriesGroupsV2ParamsDNSSECOther DNSTimeseriesGroupsV2ParamsDNSSEC = "OTHER"` - `DNSSECAware param.Field[[]DNSTimeseriesGroupsV2ParamsDNSSECAware]` Filters results based on DNSSEC (DNS Security Extensions) client awareness. - `const DNSTimeseriesGroupsV2ParamsDNSSECAwareSupported DNSTimeseriesGroupsV2ParamsDNSSECAware = "SUPPORTED"` - `const DNSTimeseriesGroupsV2ParamsDNSSECAwareNotSupported DNSTimeseriesGroupsV2ParamsDNSSECAware = "NOT_SUPPORTED"` - `DNSSECE2E param.Field[[]bool]` Filters results based on DNSSEC-validated answers by end-to-end security status. - `Format param.Field[DNSTimeseriesGroupsV2ParamsFormat]` Format in which results will be returned. - `const DNSTimeseriesGroupsV2ParamsFormatJson DNSTimeseriesGroupsV2ParamsFormat = "JSON"` - `const DNSTimeseriesGroupsV2ParamsFormatCsv DNSTimeseriesGroupsV2ParamsFormat = "CSV"` - `IPVersion param.Field[[]DNSTimeseriesGroupsV2ParamsIPVersion]` Filters results by IP version (Ipv4 vs. IPv6). - `const DNSTimeseriesGroupsV2ParamsIPVersionIPv4 DNSTimeseriesGroupsV2ParamsIPVersion = "IPv4"` - `const DNSTimeseriesGroupsV2ParamsIPVersionIPv6 DNSTimeseriesGroupsV2ParamsIPVersion = "IPv6"` - `LimitPerGroup param.Field[int64]` Limits the number of objects per group to the top items within the specified time range. When item count exceeds the limit, extra items appear grouped under an "other" category. Only supported on high-cardinality dimensions; otherwise the request is rejected. Minimum value is 2. - `Location param.Field[[]string]` Filters results by location. Specify a comma-separated list of alpha-2 codes. Prefix with `-` to exclude locations from results. For example, `-US,PT` excludes results from the US, but includes results from PT. - `MatchingAnswer param.Field[[]bool]` Filters results based on whether the queries have a matching answer. - `Name param.Field[[]string]` Array of names used to label the series in the response. - `Nodata param.Field[[]bool]` Specifies whether the response includes empty DNS responses (NODATA). - `Normalization param.Field[DNSTimeseriesGroupsV2ParamsNormalization]` Normalization method applied to the results. Refer to [Normalization methods](https://edgetunnel-b2h.pages.dev/radar/concepts/normalization/). `RANK` is only meaningful with the `TLD_DNS_MAGNITUDE` dimension, where it ranks TLDs by DNS query magnitude at each timestamp; for other dimensions it has no effect. - `const DNSTimeseriesGroupsV2ParamsNormalizationPercentage DNSTimeseriesGroupsV2ParamsNormalization = "PERCENTAGE"` - `const DNSTimeseriesGroupsV2ParamsNormalizationMin0Max DNSTimeseriesGroupsV2ParamsNormalization = "MIN0_MAX"` - `const DNSTimeseriesGroupsV2ParamsNormalizationRank DNSTimeseriesGroupsV2ParamsNormalization = "RANK"` - `Protocol param.Field[[]DNSTimeseriesGroupsV2ParamsProtocol]` Filters results by DNS transport protocol. - `const DNSTimeseriesGroupsV2ParamsProtocolUdp DNSTimeseriesGroupsV2ParamsProtocol = "UDP"` - `const DNSTimeseriesGroupsV2ParamsProtocolTCP DNSTimeseriesGroupsV2ParamsProtocol = "TCP"` - `const DNSTimeseriesGroupsV2ParamsProtocolHTTPS DNSTimeseriesGroupsV2ParamsProtocol = "HTTPS"` - `const DNSTimeseriesGroupsV2ParamsProtocolTLS DNSTimeseriesGroupsV2ParamsProtocol = "TLS"` - `QueryType param.Field[[]DNSTimeseriesGroupsV2ParamsQueryType]` Filters results by DNS query type. - `const DNSTimeseriesGroupsV2ParamsQueryTypeA DNSTimeseriesGroupsV2ParamsQueryType = "A"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeAAAA DNSTimeseriesGroupsV2ParamsQueryType = "AAAA"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeA6 DNSTimeseriesGroupsV2ParamsQueryType = "A6"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeAfsdb DNSTimeseriesGroupsV2ParamsQueryType = "AFSDB"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeAny DNSTimeseriesGroupsV2ParamsQueryType = "ANY"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeApl DNSTimeseriesGroupsV2ParamsQueryType = "APL"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeAtma DNSTimeseriesGroupsV2ParamsQueryType = "ATMA"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeAXFR DNSTimeseriesGroupsV2ParamsQueryType = "AXFR"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeCAA DNSTimeseriesGroupsV2ParamsQueryType = "CAA"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeCdnskey DNSTimeseriesGroupsV2ParamsQueryType = "CDNSKEY"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeCds DNSTimeseriesGroupsV2ParamsQueryType = "CDS"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeCERT DNSTimeseriesGroupsV2ParamsQueryType = "CERT"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeCNAME DNSTimeseriesGroupsV2ParamsQueryType = "CNAME"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeCsync DNSTimeseriesGroupsV2ParamsQueryType = "CSYNC"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeDhcid DNSTimeseriesGroupsV2ParamsQueryType = "DHCID"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeDlv DNSTimeseriesGroupsV2ParamsQueryType = "DLV"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeDname DNSTimeseriesGroupsV2ParamsQueryType = "DNAME"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeDNSKEY DNSTimeseriesGroupsV2ParamsQueryType = "DNSKEY"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeDoa DNSTimeseriesGroupsV2ParamsQueryType = "DOA"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeDS DNSTimeseriesGroupsV2ParamsQueryType = "DS"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeEid DNSTimeseriesGroupsV2ParamsQueryType = "EID"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeEui48 DNSTimeseriesGroupsV2ParamsQueryType = "EUI48"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeEui64 DNSTimeseriesGroupsV2ParamsQueryType = "EUI64"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeGpos DNSTimeseriesGroupsV2ParamsQueryType = "GPOS"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeGid DNSTimeseriesGroupsV2ParamsQueryType = "GID"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeHinfo DNSTimeseriesGroupsV2ParamsQueryType = "HINFO"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeHip DNSTimeseriesGroupsV2ParamsQueryType = "HIP"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeHTTPS DNSTimeseriesGroupsV2ParamsQueryType = "HTTPS"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeIpseckey DNSTimeseriesGroupsV2ParamsQueryType = "IPSECKEY"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeIsdn DNSTimeseriesGroupsV2ParamsQueryType = "ISDN"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeIxfr DNSTimeseriesGroupsV2ParamsQueryType = "IXFR"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeKey DNSTimeseriesGroupsV2ParamsQueryType = "KEY"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeKx DNSTimeseriesGroupsV2ParamsQueryType = "KX"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeL32 DNSTimeseriesGroupsV2ParamsQueryType = "L32"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeL64 DNSTimeseriesGroupsV2ParamsQueryType = "L64"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeLOC DNSTimeseriesGroupsV2ParamsQueryType = "LOC"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeLp DNSTimeseriesGroupsV2ParamsQueryType = "LP"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeMaila DNSTimeseriesGroupsV2ParamsQueryType = "MAILA"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeMailb DNSTimeseriesGroupsV2ParamsQueryType = "MAILB"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeMB DNSTimeseriesGroupsV2ParamsQueryType = "MB"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeMd DNSTimeseriesGroupsV2ParamsQueryType = "MD"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeMf DNSTimeseriesGroupsV2ParamsQueryType = "MF"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeMg DNSTimeseriesGroupsV2ParamsQueryType = "MG"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeMinfo DNSTimeseriesGroupsV2ParamsQueryType = "MINFO"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeMr DNSTimeseriesGroupsV2ParamsQueryType = "MR"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeMX DNSTimeseriesGroupsV2ParamsQueryType = "MX"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeNAPTR DNSTimeseriesGroupsV2ParamsQueryType = "NAPTR"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeNb DNSTimeseriesGroupsV2ParamsQueryType = "NB"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeNbstat DNSTimeseriesGroupsV2ParamsQueryType = "NBSTAT"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeNid DNSTimeseriesGroupsV2ParamsQueryType = "NID"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeNimloc DNSTimeseriesGroupsV2ParamsQueryType = "NIMLOC"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeNinfo DNSTimeseriesGroupsV2ParamsQueryType = "NINFO"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeNS DNSTimeseriesGroupsV2ParamsQueryType = "NS"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeNsap DNSTimeseriesGroupsV2ParamsQueryType = "NSAP"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeNsec DNSTimeseriesGroupsV2ParamsQueryType = "NSEC"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeNsec3 DNSTimeseriesGroupsV2ParamsQueryType = "NSEC3"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeNsec3Param DNSTimeseriesGroupsV2ParamsQueryType = "NSEC3PARAM"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeNull DNSTimeseriesGroupsV2ParamsQueryType = "NULL"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeNxt DNSTimeseriesGroupsV2ParamsQueryType = "NXT"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeOpenpgpkey DNSTimeseriesGroupsV2ParamsQueryType = "OPENPGPKEY"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeOpt DNSTimeseriesGroupsV2ParamsQueryType = "OPT"` - `const DNSTimeseriesGroupsV2ParamsQueryTypePTR DNSTimeseriesGroupsV2ParamsQueryType = "PTR"` - `const DNSTimeseriesGroupsV2ParamsQueryTypePx DNSTimeseriesGroupsV2ParamsQueryType = "PX"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeRkey DNSTimeseriesGroupsV2ParamsQueryType = "RKEY"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeRp DNSTimeseriesGroupsV2ParamsQueryType = "RP"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeRrsig DNSTimeseriesGroupsV2ParamsQueryType = "RRSIG"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeRt DNSTimeseriesGroupsV2ParamsQueryType = "RT"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeSig DNSTimeseriesGroupsV2ParamsQueryType = "SIG"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeSink DNSTimeseriesGroupsV2ParamsQueryType = "SINK"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeSMIMEA DNSTimeseriesGroupsV2ParamsQueryType = "SMIMEA"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeSOA DNSTimeseriesGroupsV2ParamsQueryType = "SOA"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeSPF DNSTimeseriesGroupsV2ParamsQueryType = "SPF"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeSRV DNSTimeseriesGroupsV2ParamsQueryType = "SRV"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeSSHFP DNSTimeseriesGroupsV2ParamsQueryType = "SSHFP"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeSVCB DNSTimeseriesGroupsV2ParamsQueryType = "SVCB"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeTa DNSTimeseriesGroupsV2ParamsQueryType = "TA"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeTalink DNSTimeseriesGroupsV2ParamsQueryType = "TALINK"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeTkey DNSTimeseriesGroupsV2ParamsQueryType = "TKEY"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeTLSA DNSTimeseriesGroupsV2ParamsQueryType = "TLSA"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeTSIG DNSTimeseriesGroupsV2ParamsQueryType = "TSIG"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeTXT DNSTimeseriesGroupsV2ParamsQueryType = "TXT"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeUinfo DNSTimeseriesGroupsV2ParamsQueryType = "UINFO"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeUID DNSTimeseriesGroupsV2ParamsQueryType = "UID"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeUnspec DNSTimeseriesGroupsV2ParamsQueryType = "UNSPEC"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeURI DNSTimeseriesGroupsV2ParamsQueryType = "URI"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeWks DNSTimeseriesGroupsV2ParamsQueryType = "WKS"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeX25 DNSTimeseriesGroupsV2ParamsQueryType = "X25"` - `const DNSTimeseriesGroupsV2ParamsQueryTypeZonemd DNSTimeseriesGroupsV2ParamsQueryType = "ZONEMD"` - `ResponseCode param.Field[[]DNSTimeseriesGroupsV2ParamsResponseCode]` Filters results by DNS response code. - `const DNSTimeseriesGroupsV2ParamsResponseCodeNoerror DNSTimeseriesGroupsV2ParamsResponseCode = "NOERROR"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeFormerr DNSTimeseriesGroupsV2ParamsResponseCode = "FORMERR"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeServfail DNSTimeseriesGroupsV2ParamsResponseCode = "SERVFAIL"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeNxdomain DNSTimeseriesGroupsV2ParamsResponseCode = "NXDOMAIN"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeNotimp DNSTimeseriesGroupsV2ParamsResponseCode = "NOTIMP"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeRefused DNSTimeseriesGroupsV2ParamsResponseCode = "REFUSED"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeYxdomain DNSTimeseriesGroupsV2ParamsResponseCode = "YXDOMAIN"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeYxrrset DNSTimeseriesGroupsV2ParamsResponseCode = "YXRRSET"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeNxrrset DNSTimeseriesGroupsV2ParamsResponseCode = "NXRRSET"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeNotauth DNSTimeseriesGroupsV2ParamsResponseCode = "NOTAUTH"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeNotzone DNSTimeseriesGroupsV2ParamsResponseCode = "NOTZONE"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeBadsig DNSTimeseriesGroupsV2ParamsResponseCode = "BADSIG"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeBadkey DNSTimeseriesGroupsV2ParamsResponseCode = "BADKEY"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeBadtime DNSTimeseriesGroupsV2ParamsResponseCode = "BADTIME"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeBadmode DNSTimeseriesGroupsV2ParamsResponseCode = "BADMODE"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeBadname DNSTimeseriesGroupsV2ParamsResponseCode = "BADNAME"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeBadalg DNSTimeseriesGroupsV2ParamsResponseCode = "BADALG"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeBadtrunc DNSTimeseriesGroupsV2ParamsResponseCode = "BADTRUNC"` - `const DNSTimeseriesGroupsV2ParamsResponseCodeBadcookie DNSTimeseriesGroupsV2ParamsResponseCode = "BADCOOKIE"` - `ResponseTTL param.Field[[]DNSTimeseriesGroupsV2ParamsResponseTTL]` Filters results by DNS response TTL. - `const DNSTimeseriesGroupsV2ParamsResponseTTLLte1M DNSTimeseriesGroupsV2ParamsResponseTTL = "LTE_1M"` - `const DNSTimeseriesGroupsV2ParamsResponseTTLGt1MLte5M DNSTimeseriesGroupsV2ParamsResponseTTL = "GT_1M_LTE_5M"` - `const DNSTimeseriesGroupsV2ParamsResponseTTLGt5MLte15M DNSTimeseriesGroupsV2ParamsResponseTTL = "GT_5M_LTE_15M"` - `const DNSTimeseriesGroupsV2ParamsResponseTTLGt15MLte1H DNSTimeseriesGroupsV2ParamsResponseTTL = "GT_15M_LTE_1H"` - `const DNSTimeseriesGroupsV2ParamsResponseTTLGt1HLte1D DNSTimeseriesGroupsV2ParamsResponseTTL = "GT_1H_LTE_1D"` - `const DNSTimeseriesGroupsV2ParamsResponseTTLGt1DLte1W DNSTimeseriesGroupsV2ParamsResponseTTL = "GT_1D_LTE_1W"` - `const DNSTimeseriesGroupsV2ParamsResponseTTLGt1W DNSTimeseriesGroupsV2ParamsResponseTTL = "GT_1W"` - `TLD param.Field[[]string]` Filters results by top-level domain. Incompatible with the `ipVersion`, `protocol`, `dnssecE2e`, `dnssecAware`, `responseTtl`, and `cacheHit` filters/dimensions; this restriction does not apply to country-code TLDs (2-letter, e.g. `uk`). ### Returns - `type DNSTimeseriesGroupsV2Response struct{…}` - `Meta DNSTimeseriesGroupsV2ResponseMeta` Metadata for the results. - `AggInterval DNSTimeseriesGroupsV2ResponseMetaAggInterval` Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://edgetunnel-b2h.pages.dev/radar/concepts/aggregation-intervals/). - `const DNSTimeseriesGroupsV2ResponseMetaAggIntervalFifteenMinutes DNSTimeseriesGroupsV2ResponseMetaAggInterval = "FIFTEEN_MINUTES"` - `const DNSTimeseriesGroupsV2ResponseMetaAggIntervalOneHour DNSTimeseriesGroupsV2ResponseMetaAggInterval = "ONE_HOUR"` - `const DNSTimeseriesGroupsV2ResponseMetaAggIntervalOneDay DNSTimeseriesGroupsV2ResponseMetaAggInterval = "ONE_DAY"` - `const DNSTimeseriesGroupsV2ResponseMetaAggIntervalOneWeek DNSTimeseriesGroupsV2ResponseMetaAggInterval = "ONE_WEEK"` - `const DNSTimeseriesGroupsV2ResponseMetaAggIntervalOneMonth DNSTimeseriesGroupsV2ResponseMetaAggInterval = "ONE_MONTH"` - `ConfidenceInfo DNSTimeseriesGroupsV2ResponseMetaConfidenceInfo` - `Annotations []DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotation` - `DataSource DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource` Data source for annotations. - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceAll DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceAIBots DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceBGP DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceBots DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceCT DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "CT"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceDNS DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceDos DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceFw DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "FW"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceFwPg DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceHTTP DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceIQI DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceNet DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "NET"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceSpeed DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"` - `Description string` - `EndDate Time` - `EventType DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventType` Event type for annotations. - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventTypeEvent DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventTypeGeneral DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventTypeOutage DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventTypePipeline DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"` - `const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC_ANOMALY"` - `IsInstantaneous bool` Whether event is a single point in time or a time range. - `LinkedURL string` - `StartDate Time` - `Tags []string` - `Level int64` Provides an indication of how much confidence Cloudflare has in the data. - `DateRange []DNSTimeseriesGroupsV2ResponseMetaDateRange` - `EndTime Time` Adjusted end of date range. - `StartTime Time` Adjusted start of date range. - `LastUpdated Time` Timestamp of the last dataset update. - `Normalization DNSTimeseriesGroupsV2ResponseMetaNormalization` Normalization method applied to the results. Refer to [Normalization methods](https://edgetunnel-b2h.pages.dev/radar/concepts/normalization/). - `const DNSTimeseriesGroupsV2ResponseMetaNormalizationPercentage DNSTimeseriesGroupsV2ResponseMetaNormalization = "PERCENTAGE"` - `const DNSTimeseriesGroupsV2ResponseMetaNormalizationMin0Max DNSTimeseriesGroupsV2ResponseMetaNormalization = "MIN0_MAX"` - `const DNSTimeseriesGroupsV2ResponseMetaNormalizationMinMax DNSTimeseriesGroupsV2ResponseMetaNormalization = "MIN_MAX"` - `const DNSTimeseriesGroupsV2ResponseMetaNormalizationRawValues DNSTimeseriesGroupsV2ResponseMetaNormalization = "RAW_VALUES"` - `const DNSTimeseriesGroupsV2ResponseMetaNormalizationPercentageChange DNSTimeseriesGroupsV2ResponseMetaNormalization = "PERCENTAGE_CHANGE"` - `const DNSTimeseriesGroupsV2ResponseMetaNormalizationRollingAverage DNSTimeseriesGroupsV2ResponseMetaNormalization = "ROLLING_AVERAGE"` - `const DNSTimeseriesGroupsV2ResponseMetaNormalizationOverlappedPercentage DNSTimeseriesGroupsV2ResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"` - `const DNSTimeseriesGroupsV2ResponseMetaNormalizationRatio DNSTimeseriesGroupsV2ResponseMetaNormalization = "RATIO"` - `Units []DNSTimeseriesGroupsV2ResponseMetaUnit` Measurement units for the results. - `Name string` - `Value string` - `Serie0 DNSTimeseriesGroupsV2ResponseSerie0` - `Timestamps []Time` ### Example ```go package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/option" "github.com/cloudflare/cloudflare-go/radar" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) response, err := client.Radar.DNS.TimeseriesGroupsV2( context.TODO(), radar.DNSTimeseriesGroupsV2ParamsDimensionAs, radar.DNSTimeseriesGroupsV2Params{ }, ) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.Meta) } ``` #### Response ```json { "result": { "meta": { "aggInterval": "FIFTEEN_MINUTES", "confidenceInfo": { "annotations": [ { "dataSource": "ALL", "description": "Cable cut in Tonga", "endDate": "2019-12-27T18:11:19.117Z", "eventType": "EVENT", "isInstantaneous": true, "linkedUrl": "https://example.com", "startDate": "2019-12-27T18:11:19.117Z", "tags": [ "BOT_CLASS" ] } ], "level": 0 }, "dateRange": [ { "endTime": "2022-09-17T10:22:57.555Z", "startTime": "2022-09-16T10:22:57.555Z" } ], "lastUpdated": "2019-12-27T18:11:19.117Z", "normalization": "PERCENTAGE", "units": [ { "name": "*", "value": "requests" } ] }, "serie_0": { "timestamps": [ "2023-08-08T10:15:00Z" ] } }, "success": true } ```