class CfnSamplingRulePropsMixin

Language	Type name
.NET	Amazon.CDK.Mixins.Preview.AWS.XRay.Mixins.CfnSamplingRulePropsMixin
Go	github.com/aws/aws-cdk-go/awscdkmixinspreview/v2/awsxray/mixins#CfnSamplingRulePropsMixin
Java	software.amazon.awscdk.mixins.preview.services.xray.mixins.CfnSamplingRulePropsMixin
Python	aws_cdk.mixins_preview.aws_xray.mixins.CfnSamplingRulePropsMixin
TypeScript	@aws-cdk/mixins-preview » aws_xray » mixins » CfnSamplingRulePropsMixin

Implements IMixin

Extends Mixin

Use the AWS::XRay::SamplingRule resource to specify a sampling rule, which controls sampling behavior for instrumented applications.

Include a SamplingRule entity to create or update a sampling rule.

SamplingRule.Version can only be set when creating a sampling rule. Updating the version will cause the update to fail.

Services retrieve rules with GetSamplingRules , and evaluate each rule in ascending order of priority for each request. If a rule matches, the service records a trace, borrowing it from the reservoir size. After 10 seconds, the service reports back to X-Ray with GetSamplingTargets to get updated versions of each in-use rule. The updated rule contains a trace quota that the service can use instead of borrowing from the reservoir.

See also: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-xray-samplingrule.html

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { mixins } from '@aws-cdk/mixins-preview';
import { mixins as xray_mixins } from '@aws-cdk/mixins-preview/aws-xray';
const cfnSamplingRulePropsMixin = new xray_mixins.CfnSamplingRulePropsMixin({
  ruleName: 'ruleName',
  samplingRule: {
    attributes: {
      attributesKey: 'attributes',
    },
    fixedRate: 123,
    host: 'host',
    httpMethod: 'httpMethod',
    priority: 123,
    reservoirSize: 123,
    resourceArn: 'resourceArn',
    ruleArn: 'ruleArn',
    ruleName: 'ruleName',
    serviceName: 'serviceName',
    serviceType: 'serviceType',
    urlPath: 'urlPath',
    version: 123,
  },
  samplingRuleRecord: {
    createdAt: 'createdAt',
    modifiedAt: 'modifiedAt',
    samplingRule: {
      attributes: {
        attributesKey: 'attributes',
      },
      fixedRate: 123,
      host: 'host',
      httpMethod: 'httpMethod',
      priority: 123,
      reservoirSize: 123,
      resourceArn: 'resourceArn',
      ruleArn: 'ruleArn',
      ruleName: 'ruleName',
      serviceName: 'serviceName',
      serviceType: 'serviceType',
      urlPath: 'urlPath',
      version: 123,
    },
  },
  samplingRuleUpdate: {
    attributes: {
      attributesKey: 'attributes',
    },
    fixedRate: 123,
    host: 'host',
    httpMethod: 'httpMethod',
    priority: 123,
    reservoirSize: 123,
    resourceArn: 'resourceArn',
    ruleArn: 'ruleArn',
    ruleName: 'ruleName',
    serviceName: 'serviceName',
    serviceType: 'serviceType',
    urlPath: 'urlPath',
  },
  tags: [{
    key: 'key',
    value: 'value',
  }],
}, /* all optional props */ {
  strategy: mixins.PropertyMergeStrategy.OVERRIDE,
});

Initializer

new CfnSamplingRulePropsMixin(props: CfnSamplingRuleMixinProps, options?: CfnPropertyMixinOptions)

Parameters

• props CfnSamplingRuleMixinProps — L1 properties to apply.
• options CfnPropertyMixinOptions — Mixin options.

Create a mixin to apply properties to AWS::XRay::SamplingRule.

Properties

Name	Type	Description
props	CfnSamplingRuleMixinProps
strategy	PropertyMergeStrategy
static CFN_PROPERTY_KEYS	string[]

---

props

Type: CfnSamplingRuleMixinProps

---

strategy

Type: PropertyMergeStrategy

---

static CFN_PROPERTY_KEYS

Type: string[]

Methods

Name	Description
applyTo(construct)	Apply the mixin properties to the construct.
supports(construct)	Check if this mixin supports the given construct.

---

applyTo(construct)

public applyTo(construct: IConstruct): IConstruct

Parameters

• construct IConstruct

Returns

• IConstruct

Apply the mixin properties to the construct.

---

supports(construct)

public supports(construct: IConstruct): boolean

Parameters

• construct IConstruct

Returns

• boolean

Check if this mixin supports the given construct.