## Get HTTP requests time series grouped by dimension `client.Radar.HTTP.TimeseriesGroupsV2(ctx, dimension, query) (*HTTPTimeseriesGroupsV2Response, error)` **get** `/radar/http/timeseries_groups/{dimension}` Retrieves the distribution of HTTP requests grouped by dimension. ### Parameters - `dimension HTTPTimeseriesGroupsV2ParamsDimension` Specifies the HTTP attribute by which to group the results. - `const HTTPTimeseriesGroupsV2ParamsDimensionAdm1 HTTPTimeseriesGroupsV2ParamsDimension = "ADM1"` - `const HTTPTimeseriesGroupsV2ParamsDimensionAs HTTPTimeseriesGroupsV2ParamsDimension = "AS"` - `const HTTPTimeseriesGroupsV2ParamsDimensionBotClass HTTPTimeseriesGroupsV2ParamsDimension = "BOT_CLASS"` - `const HTTPTimeseriesGroupsV2ParamsDimensionBrowser HTTPTimeseriesGroupsV2ParamsDimension = "BROWSER"` - `const HTTPTimeseriesGroupsV2ParamsDimensionBrowserFamily HTTPTimeseriesGroupsV2ParamsDimension = "BROWSER_FAMILY"` - `const HTTPTimeseriesGroupsV2ParamsDimensionDeviceType HTTPTimeseriesGroupsV2ParamsDimension = "DEVICE_TYPE"` - `const HTTPTimeseriesGroupsV2ParamsDimensionHTTPProtocol HTTPTimeseriesGroupsV2ParamsDimension = "HTTP_PROTOCOL"` - `const HTTPTimeseriesGroupsV2ParamsDimensionHTTPVersion HTTPTimeseriesGroupsV2ParamsDimension = "HTTP_VERSION"` - `const HTTPTimeseriesGroupsV2ParamsDimensionIPVersion HTTPTimeseriesGroupsV2ParamsDimension = "IP_VERSION"` - `const HTTPTimeseriesGroupsV2ParamsDimensionLocation HTTPTimeseriesGroupsV2ParamsDimension = "LOCATION"` - `const HTTPTimeseriesGroupsV2ParamsDimensionOS HTTPTimeseriesGroupsV2ParamsDimension = "OS"` - `const HTTPTimeseriesGroupsV2ParamsDimensionPostQuantum HTTPTimeseriesGroupsV2ParamsDimension = "POST_QUANTUM"` - `const HTTPTimeseriesGroupsV2ParamsDimensionTLSVersion HTTPTimeseriesGroupsV2ParamsDimension = "TLS_VERSION"` - `query HTTPTimeseriesGroupsV2Params` - `AggInterval param.Field[HTTPTimeseriesGroupsV2ParamsAggInterval]` Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/). - `const HTTPTimeseriesGroupsV2ParamsAggInterval15m HTTPTimeseriesGroupsV2ParamsAggInterval = "15m"` - `const HTTPTimeseriesGroupsV2ParamsAggInterval1h HTTPTimeseriesGroupsV2ParamsAggInterval = "1h"` - `const HTTPTimeseriesGroupsV2ParamsAggInterval1d HTTPTimeseriesGroupsV2ParamsAggInterval = "1d"` - `const HTTPTimeseriesGroupsV2ParamsAggInterval1w HTTPTimeseriesGroupsV2ParamsAggInterval = "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. - `BotClass param.Field[[]HTTPTimeseriesGroupsV2ParamsBotClass]` Filters results by bot class. Refer to [Bot classes](https://developers.cloudflare.com/radar/concepts/bot-classes/). - `const HTTPTimeseriesGroupsV2ParamsBotClassLikelyAutomated HTTPTimeseriesGroupsV2ParamsBotClass = "LIKELY_AUTOMATED"` - `const HTTPTimeseriesGroupsV2ParamsBotClassLikelyHuman HTTPTimeseriesGroupsV2ParamsBotClass = "LIKELY_HUMAN"` - `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). - `DateRange param.Field[[]string]` Filters results by date range. For example, use `7d` and `7dcontrol` to compare this week with the previous week. Use this parameter or set specific start and end dates (`dateStart` and `dateEnd` parameters). - `DateStart param.Field[[]Time]` Start of the date range. - `DeviceType param.Field[[]HTTPTimeseriesGroupsV2ParamsDeviceType]` Filters results by device type. - `const HTTPTimeseriesGroupsV2ParamsDeviceTypeDesktop HTTPTimeseriesGroupsV2ParamsDeviceType = "DESKTOP"` - `const HTTPTimeseriesGroupsV2ParamsDeviceTypeMobile HTTPTimeseriesGroupsV2ParamsDeviceType = "MOBILE"` - `const HTTPTimeseriesGroupsV2ParamsDeviceTypeOther HTTPTimeseriesGroupsV2ParamsDeviceType = "OTHER"` - `Format param.Field[HTTPTimeseriesGroupsV2ParamsFormat]` Format in which results will be returned. - `const HTTPTimeseriesGroupsV2ParamsFormatJson HTTPTimeseriesGroupsV2ParamsFormat = "JSON"` - `const HTTPTimeseriesGroupsV2ParamsFormatCsv HTTPTimeseriesGroupsV2ParamsFormat = "CSV"` - `GeoID param.Field[[]string]` Filters results by Geolocation. Specify a comma-separated list of GeoNames IDs. Prefix with `-` to exclude geoIds from results. For example, `-2267056,360689` excludes results from the 2267056 (Lisbon), but includes results from 5128638 (New York). - `HTTPProtocol param.Field[[]HTTPTimeseriesGroupsV2ParamsHTTPProtocol]` Filters results by HTTP protocol (HTTP vs. HTTPS). - `const HTTPTimeseriesGroupsV2ParamsHTTPProtocolHTTP HTTPTimeseriesGroupsV2ParamsHTTPProtocol = "HTTP"` - `const HTTPTimeseriesGroupsV2ParamsHTTPProtocolHTTPS HTTPTimeseriesGroupsV2ParamsHTTPProtocol = "HTTPS"` - `HTTPVersion param.Field[[]HTTPTimeseriesGroupsV2ParamsHTTPVersion]` Filters results by HTTP version. - `const HTTPTimeseriesGroupsV2ParamsHTTPVersionHttPv1 HTTPTimeseriesGroupsV2ParamsHTTPVersion = "HTTPv1"` - `const HTTPTimeseriesGroupsV2ParamsHTTPVersionHttPv2 HTTPTimeseriesGroupsV2ParamsHTTPVersion = "HTTPv2"` - `const HTTPTimeseriesGroupsV2ParamsHTTPVersionHttPv3 HTTPTimeseriesGroupsV2ParamsHTTPVersion = "HTTPv3"` - `IPVersion param.Field[[]HTTPTimeseriesGroupsV2ParamsIPVersion]` Filters results by IP version (Ipv4 vs. IPv6). - `const HTTPTimeseriesGroupsV2ParamsIPVersionIPv4 HTTPTimeseriesGroupsV2ParamsIPVersion = "IPv4"` - `const HTTPTimeseriesGroupsV2ParamsIPVersionIPv6 HTTPTimeseriesGroupsV2ParamsIPVersion = "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. - `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. - `Name param.Field[[]string]` Array of names used to label the series in the response. - `Normalization param.Field[HTTPTimeseriesGroupsV2ParamsNormalization]` Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/). - `const HTTPTimeseriesGroupsV2ParamsNormalizationPercentage HTTPTimeseriesGroupsV2ParamsNormalization = "PERCENTAGE"` - `const HTTPTimeseriesGroupsV2ParamsNormalizationMin0Max HTTPTimeseriesGroupsV2ParamsNormalization = "MIN0_MAX"` - `OS param.Field[[]HTTPTimeseriesGroupsV2ParamsOS]` Filters results by operating system. - `const HTTPTimeseriesGroupsV2ParamsOSWindows HTTPTimeseriesGroupsV2ParamsOS = "WINDOWS"` - `const HTTPTimeseriesGroupsV2ParamsOSMacosx HTTPTimeseriesGroupsV2ParamsOS = "MACOSX"` - `const HTTPTimeseriesGroupsV2ParamsOSIos HTTPTimeseriesGroupsV2ParamsOS = "IOS"` - `const HTTPTimeseriesGroupsV2ParamsOSAndroid HTTPTimeseriesGroupsV2ParamsOS = "ANDROID"` - `const HTTPTimeseriesGroupsV2ParamsOSChromeos HTTPTimeseriesGroupsV2ParamsOS = "CHROMEOS"` - `const HTTPTimeseriesGroupsV2ParamsOSLinux HTTPTimeseriesGroupsV2ParamsOS = "LINUX"` - `const HTTPTimeseriesGroupsV2ParamsOSSmartTv HTTPTimeseriesGroupsV2ParamsOS = "SMART_TV"` - `TLSVersion param.Field[[]HTTPTimeseriesGroupsV2ParamsTLSVersion]` Filters results by TLS version. - `const HTTPTimeseriesGroupsV2ParamsTLSVersionTlSv1_0 HTTPTimeseriesGroupsV2ParamsTLSVersion = "TLSv1_0"` - `const HTTPTimeseriesGroupsV2ParamsTLSVersionTlSv1_1 HTTPTimeseriesGroupsV2ParamsTLSVersion = "TLSv1_1"` - `const HTTPTimeseriesGroupsV2ParamsTLSVersionTlSv1_2 HTTPTimeseriesGroupsV2ParamsTLSVersion = "TLSv1_2"` - `const HTTPTimeseriesGroupsV2ParamsTLSVersionTlSv1_3 HTTPTimeseriesGroupsV2ParamsTLSVersion = "TLSv1_3"` - `const HTTPTimeseriesGroupsV2ParamsTLSVersionTlSvQuic HTTPTimeseriesGroupsV2ParamsTLSVersion = "TLSvQUIC"` ### Returns - `type HTTPTimeseriesGroupsV2Response struct{…}` - `Meta HTTPTimeseriesGroupsV2ResponseMeta` Metadata for the results. - `AggInterval HTTPTimeseriesGroupsV2ResponseMetaAggInterval` Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to [Aggregation intervals](https://developers.cloudflare.com/radar/concepts/aggregation-intervals/). - `const HTTPTimeseriesGroupsV2ResponseMetaAggIntervalFifteenMinutes HTTPTimeseriesGroupsV2ResponseMetaAggInterval = "FIFTEEN_MINUTES"` - `const HTTPTimeseriesGroupsV2ResponseMetaAggIntervalOneHour HTTPTimeseriesGroupsV2ResponseMetaAggInterval = "ONE_HOUR"` - `const HTTPTimeseriesGroupsV2ResponseMetaAggIntervalOneDay HTTPTimeseriesGroupsV2ResponseMetaAggInterval = "ONE_DAY"` - `const HTTPTimeseriesGroupsV2ResponseMetaAggIntervalOneWeek HTTPTimeseriesGroupsV2ResponseMetaAggInterval = "ONE_WEEK"` - `const HTTPTimeseriesGroupsV2ResponseMetaAggIntervalOneMonth HTTPTimeseriesGroupsV2ResponseMetaAggInterval = "ONE_MONTH"` - `ConfidenceInfo HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfo` - `Annotations []HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotation` - `DataSource HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource` Data source for annotations. - `const HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceAll HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"` - `const HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceAIBots HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"` - `const HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"` - `const HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceBGP HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"` - `const HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceBots HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"` - `const HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"` - `const HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceCT HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "CT"` - `const HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceDNS HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"` - `const HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"` - `const HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"` - `const HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceDos HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"` - `const HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"` - `const HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"` - `const HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceFw HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "FW"` - `const HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceFwPg HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"` - `const HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceHTTP HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"` - `const HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"` - `const HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"` - `const HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"` - `const HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceIQI HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"` - `const HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"` - `const HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceNet HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "NET"` - `const HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"` - `const HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceSpeed HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"` - `const HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"` - `Description string` - `EndDate Time` - `EventType HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventType` Event type for annotations. - `const HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventTypeEvent HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"` - `const HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventTypeGeneral HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"` - `const HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventTypeOutage HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"` - `const HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"` - `const HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventTypePipeline HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"` - `const HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly HTTPTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC_ANOMALY"` - `IsInstantaneous bool` Whether event is a single point in time or a time range. - `LinkedURL string` - `StartDate Time` - `Level int64` Provides an indication of how much confidence Cloudflare has in the data. - `DateRange []HTTPTimeseriesGroupsV2ResponseMetaDateRange` - `EndTime Time` Adjusted end of date range. - `StartTime Time` Adjusted start of date range. - `LastUpdated Time` Timestamp of the last dataset update. - `Normalization HTTPTimeseriesGroupsV2ResponseMetaNormalization` Normalization method applied to the results. Refer to [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/). - `const HTTPTimeseriesGroupsV2ResponseMetaNormalizationPercentage HTTPTimeseriesGroupsV2ResponseMetaNormalization = "PERCENTAGE"` - `const HTTPTimeseriesGroupsV2ResponseMetaNormalizationMin0Max HTTPTimeseriesGroupsV2ResponseMetaNormalization = "MIN0_MAX"` - `const HTTPTimeseriesGroupsV2ResponseMetaNormalizationMinMax HTTPTimeseriesGroupsV2ResponseMetaNormalization = "MIN_MAX"` - `const HTTPTimeseriesGroupsV2ResponseMetaNormalizationRawValues HTTPTimeseriesGroupsV2ResponseMetaNormalization = "RAW_VALUES"` - `const HTTPTimeseriesGroupsV2ResponseMetaNormalizationPercentageChange HTTPTimeseriesGroupsV2ResponseMetaNormalization = "PERCENTAGE_CHANGE"` - `const HTTPTimeseriesGroupsV2ResponseMetaNormalizationRollingAverage HTTPTimeseriesGroupsV2ResponseMetaNormalization = "ROLLING_AVERAGE"` - `const HTTPTimeseriesGroupsV2ResponseMetaNormalizationOverlappedPercentage HTTPTimeseriesGroupsV2ResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"` - `const HTTPTimeseriesGroupsV2ResponseMetaNormalizationRatio HTTPTimeseriesGroupsV2ResponseMetaNormalization = "RATIO"` - `Units []HTTPTimeseriesGroupsV2ResponseMetaUnit` Measurement units for the results. - `Name string` - `Value string` - `Serie0 HTTPTimeseriesGroupsV2ResponseSerie0` - `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.HTTP.TimeseriesGroupsV2( context.TODO(), radar.HTTPTimeseriesGroupsV2ParamsDimensionAdm1, radar.HTTPTimeseriesGroupsV2Params{ }, ) 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" } ], "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 } ```