From dbd8a3813f969263624f47129ee76138b69d5bee Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mariana=20Bellor=C3=ADn=20Aguilera?= <89138244+MarianaAguilera@users.noreply.github.com> Date: Fri, 25 Oct 2024 09:07:56 -0300 Subject: [PATCH 01/15] feature: add item in GraphQL features file EN --- .../docs/en/pages/devtools/api-graphql/features/features.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/src/content/docs/en/pages/devtools/api-graphql/features/features.mdx b/src/content/docs/en/pages/devtools/api-graphql/features/features.mdx index 68889c1e35..0cc6bb262f 100644 --- a/src/content/docs/en/pages/devtools/api-graphql/features/features.mdx +++ b/src/content/docs/en/pages/devtools/api-graphql/features/features.mdx @@ -50,6 +50,7 @@ Four datasets are deprecated and were replaced by other datsets: | connectedUsersMetrics | Query the number of users connected to your applications, using [Live Ingest](/en/documentation/products/guides/query-connected-users-data-with-graphql/) | | botManagerMetrics | Query the number of requests evaluated and the actions performed by [Azion Bot Manager](/en/documentation/products/guides/query-bot-manager-data-with-graphql/) (if subscribed) | | botManagerBreakdownMetrics | Query the URLs most impacted by bad bots, according to [Azion Bot Manager](/en/documentation/products/guides/query-bot-manager-breakdown-data-with-graphql/) data (if subscribed) | +| httpBreakdownMetrics | Query [detailed variables](/en/documentation/products/guides/query-httpBreakdownMetrics-data-with-graphql/) related to the processed requests | From 6bdc82678e131aa37ca24b6ac08f8913ce671349 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mariana=20Bellor=C3=ADn=20Aguilera?= <89138244+MarianaAguilera@users.noreply.github.com> Date: Fri, 25 Oct 2024 09:22:20 -0300 Subject: [PATCH 02/15] feature: add table to Metrics Fields file EN --- .../api-graphql/features/metrics-fields.mdx | 25 +++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/src/content/docs/en/pages/devtools/api-graphql/features/metrics-fields.mdx b/src/content/docs/en/pages/devtools/api-graphql/features/metrics-fields.mdx index 2eeec0df5d..884323a03f 100644 --- a/src/content/docs/en/pages/devtools/api-graphql/features/metrics-fields.mdx +++ b/src/content/docs/en/pages/devtools/api-graphql/features/metrics-fields.mdx @@ -312,6 +312,31 @@ When a field results from any kind of calculation, such as a sum, they're consid --- +## httpBreakdownMetrics + +| Field | Description | +|------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `ts` | Timestamp of when the event was created. Example: `2022-10-20T10:10:10` | +| `host` | Host information sent on the request line. Stores: hostname from the request line, or hostname from the Host request header field, or the server name matching a request. Example: `hello.myhost.net` | +| `remoteAddress` | IP address of the origin that generated the request. Example: `127.0.0.1` | +| `requestPath` | Path of the request made by the end user, without the host, protocol, and arguments. Example: `/v1/application` | +| `geolocAsn` | Autonomous System Number (ASN) Allocation queried from the MaxMind table. Example: `AS52580 Azion Technologies Ltda.` | +| `geolocCountryName`| Remote client's country detected via IP address geolocation. Example: `United States`, `Russian Federation` | +| `httpUserAgent` | End user's application, operating system, vendor, and/or version. Value of the User-Agent header. Example: `Mozilla/5.0 (Windows NT 10.0; Win64; x64)` | +| `httpReferer` | Address of the page the user made the request from. Example: `https://example.com` | +| `sentHttpContentType` | Content-Type header sent in the origin's response. Example: `text/html; charset=UTF-8` | +| `upstreamAddr`| Client's IP address and port. It can also store multiple servers or server groups. Example: `192.168.1.1:80`. When the response is `127.0.0.1:1666`, the upstream is Azion Cells Runtime | + +### Calculated fields + +When a field results from any kind of calculation, such as a sum, they're considered as *calculated fields*. + +| Calculated field | Description | +|----------|----------| +| `blockedRequests` | Total amount of blocked requests in the aggregation being used. This field is the result of a sum. Example: `17` | +| `requests` | Total amount of requests in the aggregation being used. This field is the result of a sum. Example: `11` | + +--- ## Deprecated datasets The following datasets were discontinued. It's recommended to use the [new datasets which replaced them](/en/documentation/devtools/graphql-api/features/#datasets). From ac918bfc122d231b4552789da6e2d57229fe073a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mariana=20Bellor=C3=ADn=20Aguilera?= <89138244+MarianaAguilera@users.noreply.github.com> Date: Fri, 25 Oct 2024 10:22:39 -0300 Subject: [PATCH 03/15] feature: add query guide EN --- .../graphql/httpBreakdownMetrics-dataset.mdx | 151 ++++++++++++++++++ 1 file changed, 151 insertions(+) create mode 100644 src/content/docs/en/pages/guides/graphql/httpBreakdownMetrics-dataset.mdx diff --git a/src/content/docs/en/pages/guides/graphql/httpBreakdownMetrics-dataset.mdx b/src/content/docs/en/pages/guides/graphql/httpBreakdownMetrics-dataset.mdx new file mode 100644 index 0000000000..21cd12e616 --- /dev/null +++ b/src/content/docs/en/pages/guides/graphql/httpBreakdownMetrics-dataset.mdx @@ -0,0 +1,151 @@ +--- +title: How to query data from the httpBreakdownMetrics dataset +description: This guide will explain how to query data from the httpBreakdownMetrics dataset using the GraphiQL playground. +meta_tags: graphql, graphql playground, security metrics, edge applications, requests +namespace: docs_guides_query_httpBreakdownMetrics_graphql +permalink: /documentation/products/guides/query-httpBreakdownMetrics-data-with-graphql/ +menu_namespace: graphqlMenu +--- + +The **httpBreakdownMetrics** dataset provides real-time, detailed, aggregated data on HTTP request events blocked. This dataset is part of the Real-Time Metrics GraphQL. + +This data is retained and available for up to *30* days. + +This guide will explain how to query data from the httpBreakdownMetrics dataset using the GraphiQL playground. + +--- + +## Querying data + +This example queries the top 20 blocked `remoteAddress` entries. To know more about the available fields, check the [Real-Time Metrics GraphQL API Fields](https://www.azion.com/en/documentation/devtools/graphql-api/features/gql-real-time-metrics-fields/) documentation. + +1. Access the GraphiQL playground in this link: `https://manager.azion.com/metrics/graphql`. + - You must be logged in to your Azion account. Otherwise, you'll receive an error message. +2. Send a query following this format: + +```graphql +query { + httpBreakdownMetrics( + aggregate: { sum: blockedRequests } + groupBy: [remoteAddress] + orderBy: [sum_DESC], + limit: 20, + filter: { + tsGte: "2024-10-21T11:00:00" + tsLt: "2024-10-21T12:00:00" + } + ) { + remoteAddress + totalBlocked: sum + } +} + +Where: + +| Field | Description | +|----------|----------| +| `sum: blockedRequests` | Returns the total number of requests blocked within the specified time range, after applying any filters | +| `groupBy` | Specifies the fields by which the query results should be grouped. Example: `[remoteAddress]` | +| `orderBy` | Specifies the order in which the results should be returned. Examples: `[sum_DESC]`, for descending order, and `[sum_ASC]`, for ascending order | +| `limit` | Specifies the maximum number of results to return. Example: `20` for retrieving the top 20. System maximum: | +| `filter` | Defines the criteria used to filter the data returned by the query | +| `tsGte` | A subfield of `filter`. Specifies the start time (greater than or equal to) for the data query, ensuring results include records from this timestamp onward. Format: "YYYY-MM-DDTHH:mm:ss"; example: `"2024-10-21T11:00:00"` | +| `tsLt` | A subfield of `filter`. Specifies the end time (less than) for the data query, filtering out any records with timestamps equal to or after this timestamp. Format: "YYYY-MM-DDTHH:mm:ss"; example: `"2024-10-21T12:00:00"` | + +3. You'll receive a response similar to this: + +```graphql +{ + "data": { + "httpBreakdownMetrics": [ + { + "remoteAddress": "192.168.0.1", + "totalBlocked": 6732 + }, + { + "remoteAddress": "10.0.0.2", + "totalBlocked": 5872 + }, + { + "remoteAddress": "172.16.0.3", + "totalBlocked": 3958 + }, + { + "remoteAddress": "192.168.1.4", + "totalBlocked": 3952 + }, + { + "remoteAddress": "10.0.1.5", + "totalBlocked": 3806 + }, + { + "remoteAddress": "172.16.1.6", + "totalBlocked": 3730 + }, + { + "remoteAddress": "192.168.2.7", + "totalBlocked": 3378 + }, + { + "remoteAddress": "10.0.2.8", + "totalBlocked": 3318 + }, + { + "remoteAddress": "172.16.2.9", + "totalBlocked": 3284 + }, + { + "remoteAddress": "192.168.3.10", + "totalBlocked": 3282 + }, + { + "remoteAddress": "10.0.3.11", + "totalBlocked": 2958 + }, + { + "remoteAddress": "172.16.3.12", + "totalBlocked": 2884 + }, + { + "remoteAddress": "192.168.4.13", + "totalBlocked": 2530 + }, + { + "remoteAddress": "10.0.4.14", + "totalBlocked": 2348 + }, + { + "remoteAddress": "172.16.4.15", + "totalBlocked": 2004 + }, + { + "remoteAddress": "192.168.5.16", + "totalBlocked": 1902 + }, + { + "remoteAddress": "10.0.5.17", + "totalBlocked": 1538 + }, + { + "remoteAddress": "172.16.5.18", + "totalBlocked": 1440 + }, + { + "remoteAddress": "192.168.6.19", + "totalBlocked": 1390 + }, + { + "remoteAddress": "10.0.6.20", + "totalBlocked": 1314 + } + ] + } +} +``` + +Where: + +| Field | Description | +|----------|----------| +| `remoteAddress` | Specifies the IP address of the source making the request. Example: `10.0.6.20` | +| `totalBlocked` | Refers to the total number of times request from this IP address has been blocked. This field is the result of a sum. Example: `1314` | \ No newline at end of file From 167b18f1a818a8431d30d6b85720ebcad3723622 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mariana=20Bellor=C3=ADn=20Aguilera?= <89138244+MarianaAguilera@users.noreply.github.com> Date: Fri, 25 Oct 2024 10:25:40 -0300 Subject: [PATCH 04/15] refactor: reorganize order --- .../api-graphql/features/features.mdx | 2 +- .../api-graphql/features/metrics-fields.mdx | 52 +++++++++---------- 2 files changed, 27 insertions(+), 27 deletions(-) diff --git a/src/content/docs/en/pages/devtools/api-graphql/features/features.mdx b/src/content/docs/en/pages/devtools/api-graphql/features/features.mdx index 0cc6bb262f..9b0cd18f0a 100644 --- a/src/content/docs/en/pages/devtools/api-graphql/features/features.mdx +++ b/src/content/docs/en/pages/devtools/api-graphql/features/features.mdx @@ -44,13 +44,13 @@ Four datasets are deprecated and were replaced by other datsets: | dataStreamedMetrics | Sent events of data by [Data Stream](/en/documentation/products/observe/data-stream/) to the clients' endpoint | | edgeFunctionsMetrics | Events executed by [Edge Functions](/en/documentation/products/build/edge-application/edge-functions/) | | httpMetrics | Request events registered by [Edge Application](/en/documentation/products/build/edge-application/) and [Edge Firewall](/en/documentation/products/secure/edge-firewall/) | +| httpBreakdownMetrics | Query real-time, detailed, aggregated data on [HTTP request events blocked](/en/documentation/products/guides/query-httpBreakdownMetrics-data-with-graphql/) | | edgeDnsQueriesMetrics | Query events performed on [Edge DNS](/en/documentation/products/secure/edge-dns/) | | imagesProcessedMetrics | Image processing events by [Image Processor](/en/documentation/products/build/edge-application/image-processor/) | | tieredCacheMetrics | Request events registered by [Tiered Cache](/en/documentation/products/build/edge-application/tiered-cache/) | | connectedUsersMetrics | Query the number of users connected to your applications, using [Live Ingest](/en/documentation/products/guides/query-connected-users-data-with-graphql/) | | botManagerMetrics | Query the number of requests evaluated and the actions performed by [Azion Bot Manager](/en/documentation/products/guides/query-bot-manager-data-with-graphql/) (if subscribed) | | botManagerBreakdownMetrics | Query the URLs most impacted by bad bots, according to [Azion Bot Manager](/en/documentation/products/guides/query-bot-manager-breakdown-data-with-graphql/) data (if subscribed) | -| httpBreakdownMetrics | Query [detailed variables](/en/documentation/products/guides/query-httpBreakdownMetrics-data-with-graphql/) related to the processed requests | diff --git a/src/content/docs/en/pages/devtools/api-graphql/features/metrics-fields.mdx b/src/content/docs/en/pages/devtools/api-graphql/features/metrics-fields.mdx index 884323a03f..e7c1fc2d5c 100644 --- a/src/content/docs/en/pages/devtools/api-graphql/features/metrics-fields.mdx +++ b/src/content/docs/en/pages/devtools/api-graphql/features/metrics-fields.mdx @@ -107,6 +107,32 @@ When a field is a result of any kind of calculation, such as a sum, they're cons --- +## httpBreakdownMetrics + +| Field | Description | +|------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `ts` | Timestamp of when the event was created. Example: `2022-10-20T10:10:10` | +| `host` | Host information sent on the request line. Stores: hostname from the request line, or hostname from the Host request header field, or the server name matching a request. Example: `hello.myhost.net` | +| `remoteAddress` | IP address of the origin that generated the request. Example: `127.0.0.1` | +| `requestPath` | Path of the request made by the end user, without the host, protocol, and arguments. Example: `/v1/application` | +| `geolocAsn` | Autonomous System Number (ASN) Allocation queried from the MaxMind table. Example: `AS52580 Azion Technologies Ltda.` | +| `geolocCountryName`| Remote client's country detected via IP address geolocation. Example: `United States`, `Russian Federation` | +| `httpUserAgent` | End user's application, operating system, vendor, and/or version. Value of the User-Agent header. Example: `Mozilla/5.0 (Windows NT 10.0; Win64; x64)` | +| `httpReferer` | Address of the page the user made the request from. Example: `https://example.com` | +| `sentHttpContentType` | Content-Type header sent in the origin's response. Example: `text/html; charset=UTF-8` | +| `upstreamAddr`| Client's IP address and port. It can also store multiple servers or server groups. Example: `192.168.1.1:80`. When the response is `127.0.0.1:1666`, the upstream is Azion Cells Runtime | + +### Calculated fields + +When a field results from any kind of calculation, such as a sum, they're considered as *calculated fields*. + +| Calculated field | Description | +|----------|----------| +| `blockedRequests` | Total amount of blocked requests in the aggregation being used. This field is the result of a sum. Example: `17` | +| `requests` | Total amount of requests in the aggregation being used. This field is the result of a sum. Example: `11` | + +--- + ## tieredCacheMetrics (Tiered Cache) | Field | Description | @@ -310,32 +336,6 @@ When a field results from any kind of calculation, such as a sum, they're consid | `botRequests` | Total amount of requests classified as bots. This field is the result of a sum. Example: `11` | | `uniqRequestUrl` | Number of unique URLs accessed by bots. This field represents the count of distinct URLs requested by bots. Example: `5` | ---- - -## httpBreakdownMetrics - -| Field | Description | -|------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `ts` | Timestamp of when the event was created. Example: `2022-10-20T10:10:10` | -| `host` | Host information sent on the request line. Stores: hostname from the request line, or hostname from the Host request header field, or the server name matching a request. Example: `hello.myhost.net` | -| `remoteAddress` | IP address of the origin that generated the request. Example: `127.0.0.1` | -| `requestPath` | Path of the request made by the end user, without the host, protocol, and arguments. Example: `/v1/application` | -| `geolocAsn` | Autonomous System Number (ASN) Allocation queried from the MaxMind table. Example: `AS52580 Azion Technologies Ltda.` | -| `geolocCountryName`| Remote client's country detected via IP address geolocation. Example: `United States`, `Russian Federation` | -| `httpUserAgent` | End user's application, operating system, vendor, and/or version. Value of the User-Agent header. Example: `Mozilla/5.0 (Windows NT 10.0; Win64; x64)` | -| `httpReferer` | Address of the page the user made the request from. Example: `https://example.com` | -| `sentHttpContentType` | Content-Type header sent in the origin's response. Example: `text/html; charset=UTF-8` | -| `upstreamAddr`| Client's IP address and port. It can also store multiple servers or server groups. Example: `192.168.1.1:80`. When the response is `127.0.0.1:1666`, the upstream is Azion Cells Runtime | - -### Calculated fields - -When a field results from any kind of calculation, such as a sum, they're considered as *calculated fields*. - -| Calculated field | Description | -|----------|----------| -| `blockedRequests` | Total amount of blocked requests in the aggregation being used. This field is the result of a sum. Example: `17` | -| `requests` | Total amount of requests in the aggregation being used. This field is the result of a sum. Example: `11` | - --- ## Deprecated datasets From 8fa65245f6e24f468751f9b36ead694b118af635 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mariana=20Bellor=C3=ADn=20Aguilera?= <89138244+MarianaAguilera@users.noreply.github.com> Date: Fri, 25 Oct 2024 10:28:47 -0300 Subject: [PATCH 05/15] feature: add link to Guides page and menu --- src/content/docs/en/pages/guides/index.mdx | 1 + src/i18n/en/graphqlMenu.ts | 1 + 2 files changed, 2 insertions(+) diff --git a/src/content/docs/en/pages/guides/index.mdx b/src/content/docs/en/pages/guides/index.mdx index de04cf5715..478563e15c 100644 --- a/src/content/docs/en/pages/guides/index.mdx +++ b/src/content/docs/en/pages/guides/index.mdx @@ -176,6 +176,7 @@ permalink: /documentation/products/guides/ - [How to query Connected Users data with GraphQL API](/en/documentation/products/guides/query-connected-users-data-with-graphql/) - [How to query Bot Manager data with GraphQL API](/en/documentation/products/guides/query-bot-manager-data-with-graphql/) - [How to query the top URLs impacted by bots with GraphQL API](/en/documentation/products/guides/query-bot-manager-breakdown-data-with-graphql/) +- [How to query data from the httpBreakdownMetrics dataset](/en/documentation/products/guides/query-httpBreakdownMetrics-data-with-graphql/) --- diff --git a/src/i18n/en/graphqlMenu.ts b/src/i18n/en/graphqlMenu.ts index 9377238e02..e2505781d9 100644 --- a/src/i18n/en/graphqlMenu.ts +++ b/src/i18n/en/graphqlMenu.ts @@ -39,6 +39,7 @@ { text: 'How to query Connected Users data', slug: '/documentation/products/guides/query-connected-users-data-with-graphql/', key: 'guides/connected-users-graphql' }, { text: 'How to query Bot Manager data', slug: '/documentation/products/guides/query-bot-manager-data-with-graphql/', key: 'guides/bot-data-graphql' }, { text: 'How to query the top URLs impacted by bots', slug: '/documentation/products/guides/query-bot-manager-breakdown-data-with-graphql/', key: 'guides/bot-breakdown-data-graphql' } + { text: 'How to query HTTP request events blocked', slug: '/documentation/products/guides/query-httpBreakdownMetrics-data-with-graphql/', key: 'guides/httpBreakdownMetrics-data' } ] }, From 1ee90df58aa84d7a289575292a0ba3895ce60034 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mariana=20Bellor=C3=ADn=20Aguilera?= <89138244+MarianaAguilera@users.noreply.github.com> Date: Fri, 25 Oct 2024 10:33:15 -0300 Subject: [PATCH 06/15] fix: broken url --- .../en/pages/guides/graphql/httpBreakdownMetrics-dataset.mdx | 2 +- src/content/docs/en/pages/guides/index.mdx | 2 +- src/i18n/en/graphqlMenu.ts | 4 ++-- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/src/content/docs/en/pages/guides/graphql/httpBreakdownMetrics-dataset.mdx b/src/content/docs/en/pages/guides/graphql/httpBreakdownMetrics-dataset.mdx index 21cd12e616..ae251bdf32 100644 --- a/src/content/docs/en/pages/guides/graphql/httpBreakdownMetrics-dataset.mdx +++ b/src/content/docs/en/pages/guides/graphql/httpBreakdownMetrics-dataset.mdx @@ -3,7 +3,7 @@ title: How to query data from the httpBreakdownMetrics dataset description: This guide will explain how to query data from the httpBreakdownMetrics dataset using the GraphiQL playground. meta_tags: graphql, graphql playground, security metrics, edge applications, requests namespace: docs_guides_query_httpBreakdownMetrics_graphql -permalink: /documentation/products/guides/query-httpBreakdownMetrics-data-with-graphql/ +permalink: /documentation/products/guides/query-httpbreakdownmetrics-data-with-graphql/ menu_namespace: graphqlMenu --- diff --git a/src/content/docs/en/pages/guides/index.mdx b/src/content/docs/en/pages/guides/index.mdx index 478563e15c..7833ac359b 100644 --- a/src/content/docs/en/pages/guides/index.mdx +++ b/src/content/docs/en/pages/guides/index.mdx @@ -176,7 +176,7 @@ permalink: /documentation/products/guides/ - [How to query Connected Users data with GraphQL API](/en/documentation/products/guides/query-connected-users-data-with-graphql/) - [How to query Bot Manager data with GraphQL API](/en/documentation/products/guides/query-bot-manager-data-with-graphql/) - [How to query the top URLs impacted by bots with GraphQL API](/en/documentation/products/guides/query-bot-manager-breakdown-data-with-graphql/) -- [How to query data from the httpBreakdownMetrics dataset](/en/documentation/products/guides/query-httpBreakdownMetrics-data-with-graphql/) +- [How to query data from the httpBreakdownMetrics dataset](/en/documentation/products/guides/query-httpbreakdownmetrics-data-with-graphql/) --- diff --git a/src/i18n/en/graphqlMenu.ts b/src/i18n/en/graphqlMenu.ts index e2505781d9..e184433234 100644 --- a/src/i18n/en/graphqlMenu.ts +++ b/src/i18n/en/graphqlMenu.ts @@ -38,8 +38,8 @@ { text: 'How to select Top X queries', slug: '/documentation/products/guides/graphql-top-x-query', key: 'guides/graphql-top-x' }, { text: 'How to query Connected Users data', slug: '/documentation/products/guides/query-connected-users-data-with-graphql/', key: 'guides/connected-users-graphql' }, { text: 'How to query Bot Manager data', slug: '/documentation/products/guides/query-bot-manager-data-with-graphql/', key: 'guides/bot-data-graphql' }, - { text: 'How to query the top URLs impacted by bots', slug: '/documentation/products/guides/query-bot-manager-breakdown-data-with-graphql/', key: 'guides/bot-breakdown-data-graphql' } - { text: 'How to query HTTP request events blocked', slug: '/documentation/products/guides/query-httpBreakdownMetrics-data-with-graphql/', key: 'guides/httpBreakdownMetrics-data' } + { text: 'How to query the top URLs impacted by bots', slug: '/documentation/products/guides/query-bot-manager-breakdown-data-with-graphql/', key: 'guides/bot-breakdown-data-graphql' }, + { text: 'How to query HTTP request events blocked', slug: '/documentation/products/guides/query-httpbreakdownmetrics-data-with-graphql/', key: 'guides/httpbreakdownmetrics-data' } ] }, From 7694d2118cd5a761167d7c66d688264fcc7f501f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mariana=20Bellor=C3=ADn=20Aguilera?= <89138244+MarianaAguilera@users.noreply.github.com> Date: Fri, 25 Oct 2024 10:44:26 -0300 Subject: [PATCH 07/15] feature: add query guide PT --- .../graphql/httpBreakdownMetrics-dataset.mdx | 151 ++++++++++++++++++ 1 file changed, 151 insertions(+) create mode 100644 src/content/docs/pt-br/pages/guias/graphql/httpBreakdownMetrics-dataset.mdx diff --git a/src/content/docs/pt-br/pages/guias/graphql/httpBreakdownMetrics-dataset.mdx b/src/content/docs/pt-br/pages/guias/graphql/httpBreakdownMetrics-dataset.mdx new file mode 100644 index 0000000000..6f2e45a3c6 --- /dev/null +++ b/src/content/docs/pt-br/pages/guias/graphql/httpBreakdownMetrics-dataset.mdx @@ -0,0 +1,151 @@ +--- +title: Como consultar dados do httpBreakdownMetrics dataset +description: Este guia explicará como consultar dados do httpBreakdownMetrics dataset usando o playground GraphiQL. +meta_tags: graphql, graphql playground, métricas de segurança, edge applications, requisições +namespace: docs_guides_query_httpBreakdownMetrics_graphql +permalink: /documentacao/produtos/guias/consultar-dados-httpbreakdownmetrics-com-graphql/ +menu_namespace: graphqlMenu +--- + +O conjunto de dados **httpBreakdownMetrics** fornece dados agregados, detalhados e em tempo real sobre eventos de requisições HTTP bloqueadas. Este conjunto de dados é parte da API GraphQL do Real-Time Metrics. + +Esses dados são retidos e disponíveis por até *30* dias. + +Este guia explicará como consultar dados do httpBreakdownMetrics dataset usando o playground GraphiQL. + +--- + +## Consulte os dados + +Este exemplo consulta as 20 principais entradas de `remoteAddress` bloqueadas. Para saber mais sobre os campos disponíveis, consulte a documentação dos [Campos da API GraphQL do Real-Time Metrics](/pt-br/documentacao/devtools/graphql-api/recursos/campos-gql-real-time-metrics/). + +1. Acesse o GraphiQL playground nesse link: `https://manager.azion.com/metrics/graphql`. + - Você deve estar logado na sua conta Azion. Caso contrário, você receberá uma mensagem de erro. +2. Envie uma query seguindo este formato: + +```graphql +query { + httpBreakdownMetrics( + aggregate: { sum: blockedRequests } + groupBy: [remoteAddress] + orderBy: [sum_DESC], + limit: 20, + filter: { + tsGte: "2024-10-21T11:00:00" + tsLt: "2024-10-21T12:00:00" + } + ) { + remoteAddress + totalBlocked: sum + } +} + +Onde: + +| Campo | Descrição | +|----------|----------| +| `sum: blockedRequests` | Retorna o número total de requisições bloqueadas dentro do intervalo de tempo especificado, após aplicar quaisquer filtros | +| `groupBy` | Especifica os campos pelos quais os resultados da consulta devem ser agrupados. Exemplo: `[remoteAddress]` | +| `orderBy` | Especifica a ordem em que os resultados devem ser retornados. Exemplos: `[sum_DESC]`, para ordem decrescente, e `[sum_ASC]`, para ordem crescente | +| `limit` | Especifica o número máximo de resultados a serem retornados. Exemplo: `20` para recuperar os 20 principais. Máximo do sistema: | +| `filter` | Define os critérios usados para filtrar os dados retornados pela consulta | +| `tsGte` | Um subcampo de `filter`. Especifica o horário de início (maior ou igual a) para a consulta de dados, garantindo que os resultados incluam registros a partir deste timestamp. Formato: "YYYY-MM-DDTHH:mm:ss"; exemplo: `"2024-10-21T11:00:00"` | +| `tsLt` | Um subcampo de `filter`. Especifica o horário de término (menor que) para a consulta de dados, filtrando quaisquer registros com timestamps iguais ou após este timestamp. Formato: "YYYY-MM-DDTHH:mm:ss"; exemplo: `"2024-10-21T12:00:00"` | + +3. Você receberá uma resposta semelhante a esta: + +```graphql +{ + "data": { + "httpBreakdownMetrics": [ + { + "remoteAddress": "192.168.0.1", + "totalBlocked": 6732 + }, + { + "remoteAddress": "10.0.0.2", + "totalBlocked": 5872 + }, + { + "remoteAddress": "172.16.0.3", + "totalBlocked": 3958 + }, + { + "remoteAddress": "192.168.1.4", + "totalBlocked": 3952 + }, + { + "remoteAddress": "10.0.1.5", + "totalBlocked": 3806 + }, + { + "remoteAddress": "172.16.1.6", + "totalBlocked": 3730 + }, + { + "remoteAddress": "192.168.2.7", + "totalBlocked": 3378 + }, + { + "remoteAddress": "10.0.2.8", + "totalBlocked": 3318 + }, + { + "remoteAddress": "172.16.2.9", + "totalBlocked": 3284 + }, + { + "remoteAddress": "192.168.3.10", + "totalBlocked": 3282 + }, + { + "remoteAddress": "10.0.3.11", + "totalBlocked": 2958 + }, + { + "remoteAddress": "172.16.3.12", + "totalBlocked": 2884 + }, + { + "remoteAddress": "192.168.4.13", + "totalBlocked": 2530 + }, + { + "remoteAddress": "10.0.4.14", + "totalBlocked": 2348 + }, + { + "remoteAddress": "172.16.4.15", + "totalBlocked": 2004 + }, + { + "remoteAddress": "192.168.5.16", + "totalBlocked": 1902 + }, + { + "remoteAddress": "10.0.5.17", + "totalBlocked": 1538 + }, + { + "remoteAddress": "172.16.5.18", + "totalBlocked": 1440 + }, + { + "remoteAddress": "192.168.6.19", + "totalBlocked": 1390 + }, + { + "remoteAddress": "10.0.6.20", + "totalBlocked": 1314 + } + ] + } +} +``` + +Onde: + +| Campo | Descrição | +|----------|----------| +| `remoteAddress` | Especifica o endereço IP da fonte que está fazendo a requisição. Exemplo: `10.0.6.20` | +| `totalBlocked` | Refere-se ao número total de vezes que as requisições deste endereço IP foram bloqueadas. Este campo é o resultado de uma soma. Exemplo: `1314` | \ No newline at end of file From 9ece666e39dbaa0aa0cf7e302da119d0a83ce3ce Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mariana=20Bellor=C3=ADn=20Aguilera?= <89138244+MarianaAguilera@users.noreply.github.com> Date: Fri, 25 Oct 2024 10:45:01 -0300 Subject: [PATCH 08/15] Update httpBreakdownMetrics-dataset.mdx --- .../en/pages/guides/graphql/httpBreakdownMetrics-dataset.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/en/pages/guides/graphql/httpBreakdownMetrics-dataset.mdx b/src/content/docs/en/pages/guides/graphql/httpBreakdownMetrics-dataset.mdx index ae251bdf32..9813fb5753 100644 --- a/src/content/docs/en/pages/guides/graphql/httpBreakdownMetrics-dataset.mdx +++ b/src/content/docs/en/pages/guides/graphql/httpBreakdownMetrics-dataset.mdx @@ -17,7 +17,7 @@ This guide will explain how to query data from the httpBreakdownMetrics dataset ## Querying data -This example queries the top 20 blocked `remoteAddress` entries. To know more about the available fields, check the [Real-Time Metrics GraphQL API Fields](https://www.azion.com/en/documentation/devtools/graphql-api/features/gql-real-time-metrics-fields/) documentation. +This example queries the top 20 blocked `remoteAddress` entries. To know more about the available fields, check the [Real-Time Metrics GraphQL API Fields](/en/documentation/devtools/graphql-api/features/gql-real-time-metrics-fields/) documentation. 1. Access the GraphiQL playground in this link: `https://manager.azion.com/metrics/graphql`. - You must be logged in to your Azion account. Otherwise, you'll receive an error message. From 7dcfc27478fced5cede75f8227cad7da76ec5193 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mariana=20Bellor=C3=ADn=20Aguilera?= <89138244+MarianaAguilera@users.noreply.github.com> Date: Fri, 25 Oct 2024 10:46:37 -0300 Subject: [PATCH 09/15] fix: adjust code block --- .../en/pages/guides/graphql/httpBreakdownMetrics-dataset.mdx | 1 + .../pt-br/pages/guias/graphql/httpBreakdownMetrics-dataset.mdx | 1 + 2 files changed, 2 insertions(+) diff --git a/src/content/docs/en/pages/guides/graphql/httpBreakdownMetrics-dataset.mdx b/src/content/docs/en/pages/guides/graphql/httpBreakdownMetrics-dataset.mdx index 9813fb5753..b8476b910a 100644 --- a/src/content/docs/en/pages/guides/graphql/httpBreakdownMetrics-dataset.mdx +++ b/src/content/docs/en/pages/guides/graphql/httpBreakdownMetrics-dataset.mdx @@ -39,6 +39,7 @@ query { totalBlocked: sum } } +``` Where: diff --git a/src/content/docs/pt-br/pages/guias/graphql/httpBreakdownMetrics-dataset.mdx b/src/content/docs/pt-br/pages/guias/graphql/httpBreakdownMetrics-dataset.mdx index 6f2e45a3c6..11fdb259b1 100644 --- a/src/content/docs/pt-br/pages/guias/graphql/httpBreakdownMetrics-dataset.mdx +++ b/src/content/docs/pt-br/pages/guias/graphql/httpBreakdownMetrics-dataset.mdx @@ -39,6 +39,7 @@ query { totalBlocked: sum } } +``` Onde: From b8dc0d95ce444cff092aab0e44861ace2f6a801c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mariana=20Bellor=C3=ADn=20Aguilera?= <89138244+MarianaAguilera@users.noreply.github.com> Date: Fri, 25 Oct 2024 10:53:45 -0300 Subject: [PATCH 10/15] feature: add link to Guides page and menu --- src/content/docs/pt-br/pages/guias/guides.mdx | 1 + src/i18n/pt-br/graphqlMenu.ts | 3 ++- 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/src/content/docs/pt-br/pages/guias/guides.mdx b/src/content/docs/pt-br/pages/guias/guides.mdx index a6b0bf4d75..82b7c68a8e 100644 --- a/src/content/docs/pt-br/pages/guias/guides.mdx +++ b/src/content/docs/pt-br/pages/guias/guides.mdx @@ -176,6 +176,7 @@ permalink: /documentacao/produtos/guias/ - [Como consultar dados de usuários conectados com a GraphQL API](/pt-br/documentacao/produtos/guias/query-dados-connected-users-com-graphql/) - [Como consultar dados do Bot Manager com a GraphQL API](/pt-br/documentacao/produtos/guias/consultar-dados-bot-manager-com-graphql/) - [Como consultar as principais URLs impactadas por bots com a GraphQL API](/pt-br/documentacao/produtos/guias/consultar-dados-bot-manager-breakdown-com-graphql/) +- [Como consultar dados do httpBreakdownMetrics dataset](/pt-br/documentacao/produtos/guias/consultar-dados-httpbreakdownmetrics-com-graphql/) --- diff --git a/src/i18n/pt-br/graphqlMenu.ts b/src/i18n/pt-br/graphqlMenu.ts index 4cdcc61c3b..cf8ddb7733 100644 --- a/src/i18n/pt-br/graphqlMenu.ts +++ b/src/i18n/pt-br/graphqlMenu.ts @@ -39,7 +39,8 @@ { text: 'Como selecionar Top X queries', slug: '/documentacao/produtos/guias/graphql-query-top-x', key: 'guides/graphql-top-x' }, { text: 'Como consultar dados de usuários conectados', slug: '/documentacao/produtos/guias/query-dados-connected-users-com-graphql/', key: 'guides/connected-users-graphql' }, { text: 'Como consultar dados do Bot Manager', slug: '/documentacao/produtos/guias/consultar-dados-bot-manager-com-graphql/', key: 'guides/bot-data-graphql' }, - { text: 'Como consultar as principais URLs impactadas por bots', slug: '/documentacao/produtos/guias/consultar-dados-bot-manager-breakdown-com-graphql/', key: 'guides/bot-breakdown-data-graphql' } + { text: 'Como consultar as principais URLs impactadas por bots', slug: '/documentacao/produtos/guias/consultar-dados-bot-manager-breakdown-com-graphql/', key: 'guides/bot-breakdown-data-graphql' }, + { text: 'Como consultar eventos de requisições HTTP bloqueadas', slug: '/documentacao/produtos/guias/consultar-dados-httpbreakdownmetrics-com-graphql/', key: 'guides/httpbreakdownmetrics-data' } ] }, From ddc1bee3118fea83dde5a4f54ae60a6847159923 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mariana=20Bellor=C3=ADn=20Aguilera?= <89138244+MarianaAguilera@users.noreply.github.com> Date: Fri, 25 Oct 2024 10:57:25 -0300 Subject: [PATCH 11/15] feature: add in GQL features PT --- .../pt-br/pages/devtools/api-graphql/recursos/recursos-gql.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/src/content/docs/pt-br/pages/devtools/api-graphql/recursos/recursos-gql.mdx b/src/content/docs/pt-br/pages/devtools/api-graphql/recursos/recursos-gql.mdx index f4e25f9ee8..3e7f588edd 100644 --- a/src/content/docs/pt-br/pages/devtools/api-graphql/recursos/recursos-gql.mdx +++ b/src/content/docs/pt-br/pages/devtools/api-graphql/recursos/recursos-gql.mdx @@ -42,6 +42,7 @@ Quatro conjuntos de dados foram descontinuados e substituiídos por outros: | dataStreamedMetrics | Registros de envio de dados do [Data Stream](/pt-br/documentacao/produtos/observe/data-stream/) para o endpoint do cliente | | edgeFunctionsMetrics | Eventos de execução do [Edge Functions](/pt-br/documentacao/produtos/build/edge-application/edge-functions/) | | httpMetrics | Eventos de requisições registradas pelo [Edge Application](/pt-br/documentacao/produtos/build/edge-application/) e [Edge Firewall](/pt-br/documentacao/produtos/secure/edge-firewall/) | +| httpBreakdownMetrics | Consulte dados agregados, detalhados e em tempo real sobre [eventos de requisições HTTP bloqueadas](/pt-br/documentacao/produtos/guias/consultar-dados-httpbreakdownmetrics-com-graphql/) | | edgeDnsQueriesMetrics | Eventos de consultas realizadas no [Edge DNS](/pt-br/documentacao/produtos/secure/edge-dns/) | | imagesProcessedMetrics | Eventos de processamento de imagens do [Image Processor](/pt-br/documentacao/produtos/build/edge-application/image-processor/) | | tieredCacheMetrics | Eventos de requisições registradas pelo [Tiered Cache](/pt-br/documentacao/produtos/build/edge-application/tiered-cache/) | From 7ee6df5ec49bbfa55a0fb9f7258657f0a8fcab47 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mariana=20Bellor=C3=ADn=20Aguilera?= <89138244+MarianaAguilera@users.noreply.github.com> Date: Fri, 25 Oct 2024 11:02:44 -0300 Subject: [PATCH 12/15] feature: add table to Metrics Fields file PT --- .../api-graphql/recursos/metrics-campos.mdx | 26 +++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/src/content/docs/pt-br/pages/devtools/api-graphql/recursos/metrics-campos.mdx b/src/content/docs/pt-br/pages/devtools/api-graphql/recursos/metrics-campos.mdx index 1d12b81837..394ca68822 100644 --- a/src/content/docs/pt-br/pages/devtools/api-graphql/recursos/metrics-campos.mdx +++ b/src/content/docs/pt-br/pages/devtools/api-graphql/recursos/metrics-campos.mdx @@ -106,6 +106,32 @@ Quando um campo é o resultado de algum tipo de cálculo, como uma soma, ele é --- +## httpBreakdownMetrics + +| Campo | Descrição | +|------------------------|---------------------| +| `ts` | Timestamp de quando o evento foi criado. Exemplo: `2022-10-20T10:10:10` | +| `host` | Informações do host enviadas na linha da requisição. Armazena: nome do host da linha da requisição, ou nome do host do campo do cabeçalho da requisição Host, ou o nome do servidor correspondente à requisição. Exemplo: `hello.myhost.net` | +| `remoteAddress` | Endereço IP da origem que gerou a requisição. Exemplo: `127.0.0.1` | +| `requestPath` | Caminho da requisição feita pelo usuário final, sem o host, protocolo e argumentos. Exemplo: `/v1/application` | +| `geolocAsn` | Autonomous System Number (ASN) consultado na tabela MaxMind. Exemplo: `AS52580 Azion Technologies Ltda.` | +| `geolocCountryName`| País do cliente remoto detectado via geolocalização do endereço IP. Exemplo: `United States`, `Russian Federation` | +| `httpUserAgent` | Aplicativo do usuário final, sistema operacional, fornecedor e/ou versão. Valor do cabeçalho User-Agent. Exemplo: `Mozilla/5.0 (Windows NT 10.0; Win64; x64)` | +| `httpReferer` | Endereço da página de onde o usuário fez a requisição. Exemplo: `https://example.com` | +| `sentHttpContentType` | Cabeçalho Content-Type enviado na resposta da origem. Exemplo: `text/html; charset=UTF-8` | +| `upstreamAddr`| Endereço IP e porta do cliente. Também pode armazenar múltiplos servidores ou grupos de servidores. Exemplo: `192.168.1.1:80`. Quando a resposta é `127.0.0.1:1666`, o upstream é Azion Cells Runtime | + +### Campos calculados + +Quando um campo resulta de qualquer tipo de cálculo, como uma soma, eles são considerados como *campos calculados*. + +| Campo calculado | Descrição | +|----------|----------| +| `blockedRequests` | Quantidade total de requisições bloqueadas na agregação utilizada. Este campo é o resultado de uma soma. Exemplo: `17` | +| `requests` | Quantidade total de requisições na agregação utilizada. Este campo é o resultado de uma soma. Exemplo: `11` | + +--- + ## tieredCacheMetrics (Tiered Cache) | Campo | Descrição | From f48f3d5fe0902f294e90cceb6d4e4b27ea0947dd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mariana=20Bellor=C3=ADn=20Aguilera?= <89138244+MarianaAguilera@users.noreply.github.com> Date: Fri, 25 Oct 2024 11:26:57 -0300 Subject: [PATCH 13/15] fix: add note and adjust time --- .../pages/guides/graphql/httpBreakdownMetrics-dataset.mdx | 6 +++++- .../pages/guias/graphql/httpBreakdownMetrics-dataset.mdx | 6 +++++- 2 files changed, 10 insertions(+), 2 deletions(-) diff --git a/src/content/docs/en/pages/guides/graphql/httpBreakdownMetrics-dataset.mdx b/src/content/docs/en/pages/guides/graphql/httpBreakdownMetrics-dataset.mdx index b8476b910a..f746b90e9c 100644 --- a/src/content/docs/en/pages/guides/graphql/httpBreakdownMetrics-dataset.mdx +++ b/src/content/docs/en/pages/guides/graphql/httpBreakdownMetrics-dataset.mdx @@ -9,7 +9,7 @@ menu_namespace: graphqlMenu The **httpBreakdownMetrics** dataset provides real-time, detailed, aggregated data on HTTP request events blocked. This dataset is part of the Real-Time Metrics GraphQL. -This data is retained and available for up to *30* days. +This data is retained and available for up to *90* days. This guide will explain how to query data from the httpBreakdownMetrics dataset using the GraphiQL playground. @@ -19,6 +19,10 @@ This guide will explain how to query data from the httpBreakdownMetrics dataset This example queries the top 20 blocked `remoteAddress` entries. To know more about the available fields, check the [Real-Time Metrics GraphQL API Fields](/en/documentation/devtools/graphql-api/features/gql-real-time-metrics-fields/) documentation. +:::note +The dataset is based on a 50% sample of the data, meaning values are approximate. +::: + 1. Access the GraphiQL playground in this link: `https://manager.azion.com/metrics/graphql`. - You must be logged in to your Azion account. Otherwise, you'll receive an error message. 2. Send a query following this format: diff --git a/src/content/docs/pt-br/pages/guias/graphql/httpBreakdownMetrics-dataset.mdx b/src/content/docs/pt-br/pages/guias/graphql/httpBreakdownMetrics-dataset.mdx index 11fdb259b1..a44b3ef6a1 100644 --- a/src/content/docs/pt-br/pages/guias/graphql/httpBreakdownMetrics-dataset.mdx +++ b/src/content/docs/pt-br/pages/guias/graphql/httpBreakdownMetrics-dataset.mdx @@ -9,7 +9,7 @@ menu_namespace: graphqlMenu O conjunto de dados **httpBreakdownMetrics** fornece dados agregados, detalhados e em tempo real sobre eventos de requisições HTTP bloqueadas. Este conjunto de dados é parte da API GraphQL do Real-Time Metrics. -Esses dados são retidos e disponíveis por até *30* dias. +Esses dados são retidos e disponíveis por até *90* dias. Este guia explicará como consultar dados do httpBreakdownMetrics dataset usando o playground GraphiQL. @@ -19,6 +19,10 @@ Este guia explicará como consultar dados do httpBreakdownMetrics dataset usando Este exemplo consulta as 20 principais entradas de `remoteAddress` bloqueadas. Para saber mais sobre os campos disponíveis, consulte a documentação dos [Campos da API GraphQL do Real-Time Metrics](/pt-br/documentacao/devtools/graphql-api/recursos/campos-gql-real-time-metrics/). +:::note +O dataset é baseado em uma amostra de 50% dos dados, portanto, os valores são aproximados. +::: + 1. Acesse o GraphiQL playground nesse link: `https://manager.azion.com/metrics/graphql`. - Você deve estar logado na sua conta Azion. Caso contrário, você receberá uma mensagem de erro. 2. Envie uma query seguindo este formato: From d68a247efd21bd0ef11090e51582a30baa688240 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mariana=20Bellor=C3=ADn=20Aguilera?= <89138244+MarianaAguilera@users.noreply.github.com> Date: Fri, 25 Oct 2024 11:28:03 -0300 Subject: [PATCH 14/15] Update src/content/docs/en/pages/guides/graphql/httpBreakdownMetrics-dataset.mdx --- .../en/pages/guides/graphql/httpBreakdownMetrics-dataset.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/en/pages/guides/graphql/httpBreakdownMetrics-dataset.mdx b/src/content/docs/en/pages/guides/graphql/httpBreakdownMetrics-dataset.mdx index f746b90e9c..bd12013262 100644 --- a/src/content/docs/en/pages/guides/graphql/httpBreakdownMetrics-dataset.mdx +++ b/src/content/docs/en/pages/guides/graphql/httpBreakdownMetrics-dataset.mdx @@ -153,4 +153,4 @@ Where: | Field | Description | |----------|----------| | `remoteAddress` | Specifies the IP address of the source making the request. Example: `10.0.6.20` | -| `totalBlocked` | Refers to the total number of times request from this IP address has been blocked. This field is the result of a sum. Example: `1314` | \ No newline at end of file +| `totalBlocked` | Refers to the total number of times requests from this IP address have been blocked. This field is the result of a sum. Example: `1314` | \ No newline at end of file From 8aaaa27726f05e83971b55ba4ac23520a3ec5c52 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mariana=20Bellor=C3=ADn=20Aguilera?= <89138244+MarianaAguilera@users.noreply.github.com> Date: Wed, 30 Oct 2024 14:47:17 -0300 Subject: [PATCH 15/15] feature: add item to Release Notes page - EN/PT --- .../en/pages/main-menu/release-notes/release-notes.mdx | 10 ++++++++++ .../menu-principal/release-notes/release-notes.mdx | 10 ++++++++++ 2 files changed, 20 insertions(+) diff --git a/src/content/docs/en/pages/main-menu/release-notes/release-notes.mdx b/src/content/docs/en/pages/main-menu/release-notes/release-notes.mdx index 122b95f38d..445e2be561 100644 --- a/src/content/docs/en/pages/main-menu/release-notes/release-notes.mdx +++ b/src/content/docs/en/pages/main-menu/release-notes/release-notes.mdx @@ -9,6 +9,16 @@ permalink: /documentation/products/release-notes/ --- import Tag from 'primevue/tag' +## November 1, 2024 + +### GraphQL API + +The new `httpBreakdownMetrics` dataset is available in the **Real-Time Metrics GraphQL API**. Through this dataset, you can get real-time, detailed, aggregated data on HTTP request events blocked. + +Find out more on [Real⁠-⁠Time Metrics GraphQL API Fields](/en/documentation/devtools/graphql-api/features/gql-real-time-metrics-fields/) and learn [How to query data from the httpBreakdownMetrics dataset](/en/documentation/products/guides/query-httpbreakdownmetrics-data-with-graphql/). + +--- + ## October 30, 2024 ### Real-Time Events diff --git a/src/content/docs/pt-br/pages/menu-principal/release-notes/release-notes.mdx b/src/content/docs/pt-br/pages/menu-principal/release-notes/release-notes.mdx index 9f4eea7d29..dddd8b1e02 100644 --- a/src/content/docs/pt-br/pages/menu-principal/release-notes/release-notes.mdx +++ b/src/content/docs/pt-br/pages/menu-principal/release-notes/release-notes.mdx @@ -9,6 +9,16 @@ permalink: /documentacao/produtos/release-notes/ --- import Tag from 'primevue/tag' +## 1 de novembro, 2024 + +### GraphQL API + +O novo conjunto de dados `httpBreakdownMetrics` está disponível na **Real-Time Metrics GraphQL API**. Através deste conjunto de dados, você pode obter dados agregados, detalhados e em tempo real sobre eventos de requisições HTTP bloqueadas. + +Saiba mais sobre [Real⁠-⁠Time Metrics GraphQL API Fields](/pt-br/documentacao/devtools/graphql-api/recursos/campos-gql-real-time-metrics/) e [Como consultar dados do httpBreakdownMetrics dataset](/pt-br/documentacao/produtos/guias/consultar-dados-httpbreakdownmetrics-com-graphql/). + +--- + ## 30 de outubro, 2024 ### Real-Time Events