[Aegis] Document available GraphQL analytics (#22300)

* Create new anaytics page and fill in content

* Cross-link with ips-allocation and info on concurrent connections

* Add missing periods

Author: RebeccaTamachiro

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.

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` <Type text="time" />
+    - Timestamp truncated to five minutes. For example, `2025-01-10T00:05:00Z`.
+
+- `popName` <Type text="string" />
+    - The Cloudflare point of presence (PoP). For example, `sjc`.
+
+- `egressIp` <Type text="string" />
+    - Your assigned Aegis IP. For example, `192.0.2.1`.
+
+- `origin` <Type text="string" />
+    - Origin IP and port. For example, `203.0.113.150:443`.
+
+- `popUtilizationKey` <Type text="string" />
+    - 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`.