README
¶
AWS Application Signals Processor
The AWS AppSignals processor is used to reduce the cardinality of telemetry metrics and traces before exporting them to CloudWatch Logs via EMF and X-Ray respectively.
It reduces the cardinality of metrics/traces via 3 types of actions, keep, drop and replace, which are configured by users. Users can configure these rules through the configurations.
Note: Traces support only replace actions and are implicitly pulled from the logs section of the CWA configuration
| Status | |
|---|---|
| Stability | [beta] |
| Supported pipeline types | metrics, traces |
| Distributions | [contrib] |
Exporter Configuration
The following exporter configuration parameters are supported.
| Name | Description | Default |
|---|---|---|
resolvers |
Platform processor is being configured for. Currently supports EKS. EC2 platform will be supported in the future. | [eks] |
rules |
Custom configuration rules used for filtering metrics/traces. Can be of type drop, keep, replace. |
[] |
rules
The rules section defines the rules (filters) to be applied
| Name | Description | Default |
|---|---|---|
selectors |
List of metrics/traces dimension matchers. | [] |
action |
Action being applied for the specified selector. keep, drop, replace |
"" |
rule_name |
(Optional) Name of rule. | [] |
replacements |
(Optional) List of metrics/traces replacements to be executed. Based on specified selectors. requires action = replace |
[] |
selectors
A selectors section defines a matching against the dimensions of incoming metrics/traces.
| Name | Description | Default |
|---|---|---|
dimension |
Dimension of metrics/traces | "" |
match |
glob used for matching values of dimensions | "" |
replacements
A replacements section defines a matching against the dimensions of incoming metrics/traces for which value replacements will be done. action must be replace
| Name | Description | Default |
|---|---|---|
target_dimension |
Dimension to replace | "" |
value |
Value to replace current dimension value with | "" |
AWS AppSignals Processor Configuration Example
awsapplicationsignals:
resolvers:
- platform: eks
name: test
rules:
- selectors:
- dimension: Operation
match: "POST *"
- dimension: RemoteService
match: "*"
action: keep
rule_name: "keep01"
- selectors:
- dimension: Operation
match: "GET *"
- dimension: RemoteService
match: "*"
action: keep
rule_name: "keep02"
- selectors:
- dimension: Operation
match: "POST *"
action: drop
rule_name: "drop01"
- selectors:
- dimension: Operation
match: "*"
replacements:
- target_dimension: RemoteOperation
value: "This is a test string"
action: replace
rule_name: "replace01"
Documentation
Source Files
Directories