Skip to content

docs: Add docs for use of alias field#602

Merged
ps863 merged 2 commits intoaws-observability:mainfrom
ps863:aliasDocs
Mar 4, 2025
Merged

docs: Add docs for use of alias field#602
ps863 merged 2 commits intoaws-observability:mainfrom
ps863:aliasDocs

Conversation

@ps863
Copy link
Copy Markdown
Member

@ps863 ps863 commented Mar 3, 2025

This PR adds docs for alias field usage.


By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

| eventPluginsToLoad | [Plugin](examples.md#record-custom-events-using-a-plugin)[] | `[]` | The set of custom plugins to load. See [usage examples](examples.md#record-custom-events-using-a-plugin). |
| guestRoleArn | String | `undefined` | The ARN of the AWS IAM role that will be assumed during anonymous authorization.<br/><br/>When `guestRoleArn` and `identityPoolId` are both set, the web client will use Cognito's [basic (classic) authflow](https://docs.aws.amazon.com/cognito/latest/developerguide/authentication-flow.html).<br/><br/>When only `identityPoolId` is set, the web client will use Cognito's [enhanced (simplified) authflow](https://docs.aws.amazon.com/cognito/latest/developerguide/authentication-flow.html) (recommended). |
| identityPoolId | String | `undefined` | The Amazon Cognito Identity Pool ID that will be used during anonymous authorization.<br/><br/>When `identityPoolId` is set, the web client will use Cognito to retrieve temporary AWS credentials. These credentials authorize the bearer to send data to the CloudWatch RUM app monitor.<br/><br/>When`identityPoolId` is not set, you must either (A) forward credentials to the web client using the `setAwsCredentials` command, or (B) use a proxy and set `signing` to `false`. |
| alias | String | `undefined` | Adds alias to all PutRumEvents requests. This will be compared against the `rum:alias` service context key in the resource based policy attached to a RUM app monitor. To learn more about how to use resource based policies with RUM, see [here](http://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-RUM-resource-policies.html) |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit:

  1. Adds alias to all PutRumEvents requests. -> Adds an alias to all PutRumEvents requests.
  2. please add period at the end of the last sentence.

@williazz
Copy link
Copy Markdown
Collaborator

williazz commented Mar 3, 2025

PMed you a question

@ps863 ps863 merged commit 0108cb6 into aws-observability:main Mar 4, 2025
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants