/AWS1/CL_XRASAMPLINGRULEUPDATE¶
A document specifying changes to a sampling rule's configuration.
CONSTRUCTOR¶
IMPORTING¶
Optional arguments:¶
iv_rulename TYPE /AWS1/XRARULENAME /AWS1/XRARULENAME¶
The name of the sampling rule. Specify a rule by either name or ARN, but not both.
iv_rulearn TYPE /AWS1/XRASTRING /AWS1/XRASTRING¶
The ARN of the sampling rule. Specify a rule by either name or ARN, but not both.
iv_resourcearn TYPE /AWS1/XRARESOURCEARN /AWS1/XRARESOURCEARN¶
Matches the ARN of the Amazon Web Services resource on which the service runs.
iv_priority TYPE /AWS1/XRANULLABLEINTEGER /AWS1/XRANULLABLEINTEGER¶
The priority of the sampling rule.
iv_fixedrate TYPE /AWS1/RT_DOUBLE_AS_STRING /AWS1/RT_DOUBLE_AS_STRING¶
The percentage of matching requests to instrument, after the reservoir is exhausted.
iv_reservoirsize TYPE /AWS1/XRANULLABLEINTEGER /AWS1/XRANULLABLEINTEGER¶
A fixed number of matching requests to instrument per second, prior to applying the fixed rate. The reservoir is not used directly by services, but applies to all services using the rule collectively.
iv_host TYPE /AWS1/XRAHOST /AWS1/XRAHOST¶
Matches the hostname from a request URL.
iv_servicename TYPE /AWS1/XRASERVICENAME /AWS1/XRASERVICENAME¶
Matches the
namethat the service uses to identify itself in segments.
iv_servicetype TYPE /AWS1/XRASERVICETYPE /AWS1/XRASERVICETYPE¶
Matches the
originthat the service uses to identify its type in segments.
iv_httpmethod TYPE /AWS1/XRAHTTPMETHOD /AWS1/XRAHTTPMETHOD¶
Matches the HTTP method of a request.
iv_urlpath TYPE /AWS1/XRAURLPATH /AWS1/XRAURLPATH¶
Matches the path from a request URL.
it_attributes TYPE /AWS1/CL_XRAATTRIBUTEMAP_W=>TT_ATTRIBUTEMAP TT_ATTRIBUTEMAP¶
Matches attributes derived from the request.
io_samplingrateboost TYPE REF TO /AWS1/CL_XRASAMPLINGRATEBOOST /AWS1/CL_XRASAMPLINGRATEBOOST¶
Specifies the multiplier applied to the base sampling rate. This boost allows you to temporarily increase sampling without changing the rule's configuration.
Queryable Attributes¶
RuleName¶
The name of the sampling rule. Specify a rule by either name or ARN, but not both.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_RULENAME() |
Getter for RULENAME, with configurable default |
ASK_RULENAME() |
Getter for RULENAME w/ exceptions if field has no value |
HAS_RULENAME() |
Determine if RULENAME has a value |
RuleARN¶
The ARN of the sampling rule. Specify a rule by either name or ARN, but not both.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_RULEARN() |
Getter for RULEARN, with configurable default |
ASK_RULEARN() |
Getter for RULEARN w/ exceptions if field has no value |
HAS_RULEARN() |
Determine if RULEARN has a value |
ResourceARN¶
Matches the ARN of the Amazon Web Services resource on which the service runs.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_RESOURCEARN() |
Getter for RESOURCEARN, with configurable default |
ASK_RESOURCEARN() |
Getter for RESOURCEARN w/ exceptions if field has no value |
HAS_RESOURCEARN() |
Determine if RESOURCEARN has a value |
Priority¶
The priority of the sampling rule.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_PRIORITY() |
Getter for PRIORITY, with configurable default |
ASK_PRIORITY() |
Getter for PRIORITY w/ exceptions if field has no value |
HAS_PRIORITY() |
Determine if PRIORITY has a value |
FixedRate¶
The percentage of matching requests to instrument, after the reservoir is exhausted.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_FIXEDRATE() |
Getter for FIXEDRATE, with configurable default |
ASK_FIXEDRATE() |
Getter for FIXEDRATE w/ exceptions if field has no value |
STR_FIXEDRATE() |
String format for FIXEDRATE, with configurable default |
HAS_FIXEDRATE() |
Determine if FIXEDRATE has a value |
ReservoirSize¶
A fixed number of matching requests to instrument per second, prior to applying the fixed rate. The reservoir is not used directly by services, but applies to all services using the rule collectively.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_RESERVOIRSIZE() |
Getter for RESERVOIRSIZE, with configurable default |
ASK_RESERVOIRSIZE() |
Getter for RESERVOIRSIZE w/ exceptions if field has no value |
HAS_RESERVOIRSIZE() |
Determine if RESERVOIRSIZE has a value |
Host¶
Matches the hostname from a request URL.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_HOST() |
Getter for HOST, with configurable default |
ASK_HOST() |
Getter for HOST w/ exceptions if field has no value |
HAS_HOST() |
Determine if HOST has a value |
ServiceName¶
Matches the
namethat the service uses to identify itself in segments.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_SERVICENAME() |
Getter for SERVICENAME, with configurable default |
ASK_SERVICENAME() |
Getter for SERVICENAME w/ exceptions if field has no value |
HAS_SERVICENAME() |
Determine if SERVICENAME has a value |
ServiceType¶
Matches the
originthat the service uses to identify its type in segments.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_SERVICETYPE() |
Getter for SERVICETYPE, with configurable default |
ASK_SERVICETYPE() |
Getter for SERVICETYPE w/ exceptions if field has no value |
HAS_SERVICETYPE() |
Determine if SERVICETYPE has a value |
HTTPMethod¶
Matches the HTTP method of a request.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_HTTPMETHOD() |
Getter for HTTPMETHOD, with configurable default |
ASK_HTTPMETHOD() |
Getter for HTTPMETHOD w/ exceptions if field has no value |
HAS_HTTPMETHOD() |
Determine if HTTPMETHOD has a value |
URLPath¶
Matches the path from a request URL.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_URLPATH() |
Getter for URLPATH, with configurable default |
ASK_URLPATH() |
Getter for URLPATH w/ exceptions if field has no value |
HAS_URLPATH() |
Determine if URLPATH has a value |
Attributes¶
Matches attributes derived from the request.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_ATTRIBUTES() |
Getter for ATTRIBUTES, with configurable default |
ASK_ATTRIBUTES() |
Getter for ATTRIBUTES w/ exceptions if field has no value |
HAS_ATTRIBUTES() |
Determine if ATTRIBUTES has a value |
SamplingRateBoost¶
Specifies the multiplier applied to the base sampling rate. This boost allows you to temporarily increase sampling without changing the rule's configuration.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_SAMPLINGRATEBOOST() |
Getter for SAMPLINGRATEBOOST |