aws xray create-group

Creates a group resource with a name and a filter expression. AWS CLI reference

1 example 4 options Its page in the AWS CLI reference

Examples

from aws-cli, each command read by CmdID

To create a group

The following create-group example creates a group resource named AdminGroup. The group gets a filter expression that defines the criteria of the group as a segment related to a specific service causing a fault or an error.

aws xray create-group --group-name "AdminGroup" --filter-expression "service(\"mydomain.com\") {fault OR error}"Identify

--group-nameThe case-sensitive name of the new group.

--filter-expressionThe filter expression defining criteria by which to group traces.

Its output

{
    "Group": {
        "GroupName": "AdminGroup",
        "GroupARN": "arn:aws:xray:us-west-2:123456789012:group/AdminGroup/123456789",
        "FilterExpression": "service(\"mydomain.com\") {fault OR error}"
    }
}

For more information, see Configuring Sampling, Groups, and Encryption Settings with the AWS X-Ray API in the AWS X-Ray Developer Guide.

Options

4 in the AWS CLI reference

--filter-expressionThe filter expression defining criteria by which to group traces.

--group-nameThe case-sensitive name of the new group.

--insights-configurationThe structure containing configurations related to insights.

--tagsA map that contains one or more tag keys and tag values to attach to an X-Ray group.