diff --git a/src/content/docs/aegis/about/ips-allocation.mdx b/src/content/docs/aegis/about/ips-allocation.mdx
index 4b7b462eacb46e9..03dc710e75924f8 100644
--- a/src/content/docs/aegis/about/ips-allocation.mdx
+++ b/src/content/docs/aegis/about/ips-allocation.mdx
@@ -25,6 +25,8 @@ Refer to [connection forwarding](/aegis/about/connection-forwarding/) to underst
Each Aegis IP can support 40,000 concurrent connections per origin IP. For example, if you have one Aegis IP and two origins (A and B), this single Aegis IP can support 40,000 concurrent connections to origin A, while simultaneously supporting 40,000 concurrent connections to origin B.
+[GraphQL Analytics API](/aegis/analytics/) allows you to get visibility over Aegis IP utilization.
+
## Regional services
If you are using [Regional Services](/data-localization/regional-services/), you should take this into consideration when allocating Aegis IPv4. Traffic will egress from the specified locations as long as you have Aegis IPs provisioned in those locations.
\ No newline at end of file
diff --git a/src/content/docs/aegis/analytics.mdx b/src/content/docs/aegis/analytics.mdx
new file mode 100644
index 000000000000000..d78bcf98a64f031
--- /dev/null
+++ b/src/content/docs/aegis/analytics.mdx
@@ -0,0 +1,29 @@
+---
+title: Analytics
+pcx_content_type: reference
+sidebar:
+ order: 7
+---
+
+import { Type } from "~/components";
+
+Use the [GraphQL API](/analytics/graphql-api/) to get aggregate data and monitor your Aegis IPs capacity. As explained in [IPs allocation](/aegis/about/ips-allocation/), each Aegis IP can support 40,000 concurrent connections per origin IP.
+
+Refer to the GraphQL Analytics API documentation to [get started](/analytics/graphql-api/getting-started/). The specific Aegis schema is called `aegisIpUtilizationAdaptiveGroups`.
+
+You can get average (`avg`) or maximum (`max`) utilization values (in percentage), and use the following dimensions:
+
+- `datetimeFiveMinutes`
+ - Timestamp truncated to five minutes. For example, `2025-01-10T00:05:00Z`.
+
+- `popName`
+ - The Cloudflare point of presence (PoP). For example, `sjc`.
+
+- `egressIp`
+ - Your assigned Aegis IP. For example, `192.0.2.1`.
+
+- `origin`
+ - Origin IP and port. For example, `203.0.113.150:443`.
+
+- `popUtilizationKey`
+ - The Cloudflare point of presence (PoP), the Aegis IP, and the origin IP and port. For example, `sjc 192.0.2.1 203.0.113.150:443`.