Updated metrics documentation

Author: maheshwarip

src/content/docs/pipelines/observability/metrics.mdx

@@ -6,15 +6,48 @@ sidebar:
 
 ---
 
-Pipelines metrics are split across three different nodes under `viewer` > `accounts`. Refer to [Explore the GraphQL schema](/analytics/graphql-api/getting-started/explore-graphql-schema/) to learn how to navigate a GraphQL schema and discover which data are available.
+Pipelines expose metrics which allow you to measure data ingested, requests made, and data delivered, across all your Pipelines.
 
-To learn more about the GraphQL Analytics API, refer to [GraphQL Analytics API](/analytics/graphql-api/).
+The metrics displayed in the [Cloudflare dashboard](https://dash.cloudflare.com/) are queried from Cloudflare’s [GraphQL Analytics API](/analytics/graphql-api/). You can access the metrics [programmatically](#query-via-the-graphql-api) via GraphQL or HTTP client.
 
-You can use the GraphQL API to measure metrics for data ingested, as well as data delivered.
+## Metrics
+### Ingestion
+Pipelines export the below metrics within the `pipelinesIngestionAdaptiveGroups` dataset.
 
-## Write GraphQL queries
+| Metric                 | GraphQL Field Name        | Description 																										|
+| ---------------------- | ------------------------- | ---------------------------------------------------------------|
+| Ingestion Events       | `count`        					 | Number of ingestion events, or requests made, to a pipeline. 	|
+| Ingested Bytes       	 | `ingestedBytes`        	 | Total number of bytes ingested 																|
+| Ingested Records       | `ingestedRecords`         | Total number of records ingested 															|
 
-Examples of how to explore your Pipelines metrics.
+The `pipelinesIngestionAdaptiveGroups` dataset provides the following dimensions for filtering and grouping queries:
+* `pipelineId` - ID of the pipeline
+* `datetime` - Timestamp of the ingestion event
+* `date` - Timestamp of the ingestion event, truncated to the start of a day
+* `datetimeHour` - Timestamp of the ingestion event, truncated to the start of an hour
+* `datetimeMinute` - Timestamp of the ingestion event, truncated to the start of a minute
+
+### Delivery
+Pipelines export the below metrics within the `pipelinesDeliveryAdaptiveGroups` dataset.
+
+| Metric                 | GraphQL Field Name        | Description 																										|
+| ---------------------- | ------------------------- | ---------------------------------------------------------------|
+| Ingestion Events       | `count`        					 | Number of delivery events to an R2 bucket 											|
+| Delivered Bytes        | `deliveredBytes`        	 | Total number of bytes ingested 																|
+
+The `pipelinesDeliverynAdaptiveGroups` dataset provides the following dimensions for filtering and grouping queries:
+* `pipelineId` - ID of the pipeline
+* `datetime` - Timestamp of the delivery event
+* `date` - Timestamp of the delivery event, truncated to the start of a day
+* `datetimeHour` - Timestamp of the delivery event, truncated to the start of an hour
+* `datetimeMinute` - Timestamp of the delivery event, truncated to the start of a minute
+
+
+## Query via the GraphQL API
+
+You can programmatically query analytics for your Workflows via the [GraphQL Analytics API](/analytics/graphql-api/). This API queries the same datasets as the Cloudflare dashboard, and supports GraphQL [introspection](/analytics/graphql-api/features/discovery/introspection/).
+
+Pipelines GraphQL datasets require an `accountTag` filter, with your Cloudflare account ID.
 
 ### Measure total bytes & records ingested over time period
 
@@ -45,13 +78,13 @@ query PipelineIngestion($accountTag: string!, $pipelineId: string!, $datetimeSta
 ### Measure volume of data delivered
 
 ```graphql
-query PipelineDelivery($accountTag: string!, $queueId: string!, $datetimeStart: Time!, $datetimeEnd: Time!) {
+query PipelineDelivery($accountTag: string!, $pipelineId: string!, $datetimeStart: Time!, $datetimeEnd: Time!) {
   viewer {
     accounts(filter: {accountTag: $accountTag}) {
       pipelinesDeliveryAdaptiveGroups(
         limit: 10000
         filter: {
-          pipelineId: $queueId
+          pipelineId: $pipelineId
           datetime_geq: $datetimeStart
           datetime_leq: $datetimeEnd
         }

src/content/docs/workers/wrangler/commands.mdx

@@ -2019,7 +2019,7 @@ Pipelines is currently in open beta. Report Pipelines bugs in [GitHub](https://g
 
 :::
 
-Manage your [Pipelines](/pipelines/) configurations.
+Manage your [Pipelines](/pipelines/).
 
 ### `create`
 
@@ -2029,24 +2029,32 @@ Create a new pipeline
 wrangler pipelines create <name> --r2 <r2-bucket-name> [OPTIONS]
 ```
 
-- `name` string required
+- `name` <Type text="string" /> <MetaInfo text="required" />
 	- The name of the pipeline to create
-- `--r2` string required
+- `--source` <Type text="array" /> <MetaInfo text="optional" />
+	- List of alowed sources. Options: 'http' or 'worker'
+- `--require-http-auth` <Type text="boolean" /> <MetaInfo text="optional" />
+	- Require Cloudflare API token to authenticate with the HTTPS endpoint. Defaults to false.
+- `--cors-origins` <Type text="array" /> <MetaInfo text="optional" />
+	- CORS Origin allowlist for HTTP endpoint. Allows `*`. Defaults to an empty array.
+- `--batch-max-mb` <Type text="number" /> <MetaInfo text="optional" />
+	- The maximum size a batch before data is written, in megabytes. Defaults to 100. Must be between 0.001 and 100.
+- `--batch-max-rows` <Type text="number" /> <MetaInfo text="optional" />
+	- The maximum number of rows in a batch before data is written. Defaults to 10000000. Must be between 1 and 10000000.
+- `--batch-max-seconds` <Type text="number" /> <MetaInfo text="optional" />
+	- The maximum duration of a batch before data is written, in seconds. Defaults to 300. Must be between 1 and 300.
+- `--r2-bucket` <Type text="string" /> <MetaInfo text="required" />
 	- The name of the R2 bucket used as the destination to store the data.
-- `--batch-max-mb` number optional
-	- The maximum size a batch before data is written, in megabytes. Default 10 MB, maximum 100 MB.
-- `--batch-max-rows` number optional
-	- The maximum number of rows in a batch before data is written. Default, and maximum, 10,000.
-- `--batch-max-seconds` number optional
-	- The maximum duration of a batch before data is written, in seconds. Default 15s. Maximum of 600s.
-- `--compression` string optional
+- `--r2-bucket-access-key-id` <Type text="string" /> <MetaInfo text="optional" />
+	- Access key ID used to authenticate with R2. Leave empty for oauth confirmation.
+- `--r2-bucket-secret-access-key` <Type text="string" /> <MetaInfo text="optional" />
+	- Secret access key ID used to authenticate with R2. Leave empty for oauth confirmation.
+- `--r2-prefix` <Type text="string" /> <MetaInfo text="optional" />
+	- Prefix for storing files in the destination bucket.
+- `--compression` <Type text="string" /> <MetaInfo text="optional" />
 	- Type of compression to apply to output files. Choices: "none", "gzip", "deflate"
-- `--prefix` string optional
-	- Optional base path to store files in the destination bucket.
-- `--filepath` string optional
-	- The path to store partitioned files in the destination bucket. Defaults to `event_date=${date}/hr=${hr}`
-- `--filename` string optional
-	- The name of the file in the bucket. Must contain `${slug}`. File extension is optional. Defaults to `${slug}${extension}`
+- `--shard-count` <Type text="number" /> <MetaInfo text="optional" />
+	- Number of pipeline shards. More shards handle higher request volume; fewer shards produce larger output files. Defaults to 2. Must be between 1 and 15.
 
 ### `update`
 
@@ -2056,24 +2064,43 @@ Update an existing pipeline
 wrangler pipelines update <name> [OPTIONS]
 ```
 
-- `name` string required
-	- The name of the pipeline to update
-- `--r2` string required
+- `name` <Type text="string" /> <MetaInfo text="required" />
+	- The name of the pipeline to create
+- `--source` <Type text="array" /> <MetaInfo text="optional" />
+	- List of alowed sources. Options: 'http' or 'worker'
+- `--require-http-auth` <Type text="boolean" /> <MetaInfo text="optional" />
+	- Require Cloudflare API token to authenticate with the HTTPS endpoint. Defaults to false.
+- `--cors-origins` <Type text="array" /> <MetaInfo text="optional" />
+	- CORS Origin allowlist for HTTP endpoint. Allows `*`. Defaults to an empty array.
+- `--batch-max-mb` <Type text="number" /> <MetaInfo text="optional" />
+	- The maximum size a batch before data is written, in megabytes. Defaults to 100. Must be between 0.001 and 100.
+- `--batch-max-rows` <Type text="number" /> <MetaInfo text="optional" />
+	- The maximum number of rows in a batch before data is written. Defaults to 10000000. Must be between 1 and 10000000.
+- `--batch-max-seconds` <Type text="number" /> <MetaInfo text="optional" />
+	- The maximum duration of a batch before data is written, in seconds. Defaults to 300. Must be between 1 and 300.
+- `--r2-bucket` <Type text="string" /> <MetaInfo text="required" />
 	- The name of the R2 bucket used as the destination to store the data.
-- `--batch-max-mb` number optional
-	- The maximum size a batch before data is written, in megabytes. Default 10 MB, maximum 100 MB.
-- `--batch-max-rows` number optional
-	- The maximum number of rows in a batch before data is written. Default, and maximum, 10,000.
-- `--batch-max-seconds` number optional
-	- The maximum duration of a batch before data is written, in seconds. Default 15s. Maximum of 600s.
-- `--compression` string optional
+- `--r2-bucket-access-key-id` <Type text="string" /> <MetaInfo text="optional" />
+	- Access key ID used to authenticate with R2. Leave empty for oauth confirmation.
+- `--r2-bucket-secret-access-key` <Type text="string" /> <MetaInfo text="optional" />
+	- Secret access key ID used to authenticate with R2. Leave empty for oauth confirmation.
+- `--r2-prefix` <Type text="string" /> <MetaInfo text="optional" />
+	- Prefix for storing files in the destination bucket.
+- `--compression` <Type text="string" /> <MetaInfo text="optional" />
 	- Type of compression to apply to output files. Choices: "none", "gzip", "deflate"
-- `--prefix` string optional
-	- Optional base path to store files in the destination bucket.
-- `--filepath` string optional
-	- The path to store partitioned files in the destination bucket. Defaults to `event_date=${date}/hr=${hr}`
-- `--filename` string optional
-	- The name of the file in the bucket. Must contain `${slug}`. File extension is optional. Defaults to `${slug}${extension}`
+- `--shard-count` <Type text="number" /> <MetaInfo text="optional" />
+	- Number of pipeline shards. More shards handle higher request volume; fewer shards produce larger output files. Defaults to 2. Must be between 1 and 15.
+
+### `get`
+
+Get the configuration for an existing pipeline.
+
+```txt
+wrangler pipelines get <name> [OPTIONS]
+```
+
+- `name` <Type text="string" /> <MetaInfo text="required" />
+	- The name of the pipeline to inspect
 
 ### `delete`
 
@@ -2083,7 +2110,7 @@ Deletes an existing pipeline
 wrangler pipelines delete <name> [OPTIONS]
 ```
 
-- `name` string required
+- `name` <Type text="string" /> <MetaInfo text="required" />
 	- The name of the pipeline to delete
 
 ### `list`