Group

The Group resource lets you manage AWS XRay Groups for organizing and analyzing traces from your applications.

Minimal Example

Create a basic XRay Group with a specified name and a filter expression.

import AWS from "alchemy/aws/control";

const xrayGroup = await AWS.XRay.Group("myXRayGroup", {
  GroupName: "MyApplicationGroup",
  FilterExpression: "service('MyService')"
});

Advanced Configuration

Configure a group with insights enabled and additional tags.

const insightsGroup = await AWS.XRay.Group("insightsXRayGroup", {
  GroupName: "InsightsEnabledGroup",
  FilterExpression: "service('MyService')",
  InsightsConfiguration: {
    InsightsEnabled: true,
    NotificationsEnabled: false
  },
  Tags: [
    { Key: "Environment", Value: "Production" },
    { Key: "Project", Value: "MyProject" }
  ]
});

Adoption of Existing Resources

Adopt an existing XRay Group instead of failing when the resource already exists.

const existingGroup = await AWS.XRay.Group("existingXRayGroup", {
  GroupName: "ExistingGroup",
  adopt: true
});

Group with Custom Insights Configuration

Define a group with customized insights configuration.

const customInsightsGroup = await AWS.XRay.Group("customInsightsXRayGroup", {
  GroupName: "CustomInsightsGroup",
  InsightsConfiguration: {
    InsightsEnabled: true,
    NotificationsEnabled: true
  }
});