The following table describes runtime metrics provided by guardrails that you can monitor with CloudWatch Metrics.
Runtime metrics
| Metric name | Unit | Description |
|---|---|---|
| Invocations | SampleCount | Number of requests to the ApplyGuardrail API operation |
| InvocationLatency | MilliSeconds | Latency of the invocations |
| InvocationClientErrors | SampleCount | Number of invocations that result in client-side errors |
| InvocationServerErrors | SampleCount | Number of invocations that result in AWS server-side errors |
| InvocationThrottles | SampleCount | Number of invocations that the system throttled. Throttled requests and other invocation errors don't count as either Invocations or Errors. |
| TextUnitCount | SampleCount | Number of text units consumed by the guardrails policies |
| InvocationsIntervened | SampleCount | Number of invocations where the guardrails intervened |
You can view guardrail dimensions in the CloudWatch console based on the table below:
Dimension
| Dimension name | Dimension values | Available for the following metrics |
|---|---|---|
| Operation | ApplyGuardrail |
|
| GuardrailContentSource |
|
|
| GuardrailPolicyType |
|
|
| GuardrailArn, GuardrailVersion |
|
|
Use CloudWatch metrics for guardrails
You can get metrics for guardrails with the AWS Management Console, the AWS CLI, or the CloudWatch API. You can use the CloudWatch API through one of the AWS Software Development Kits (SDKs) or the CloudWatch API tools.
Note
You must have the appropriate CloudWatch permissions to monitor guardrails with CloudWatch.
For more information, see Authentication and Access Control for CloudWatch in the CloudWatch User Guide.
View guardrails metrics in the CloudWatch Console
To view metrics (in the CloudWatch console):
-
Sign in to the AWS Management Console and open the CloudWatch console at https://console.aws.amazon.com/cloudwatch/.
-
Choose the AWS/Bedrock/Guardrails namespace.
