awsapplicationsignalsprocessor

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

Index

• func NewFactory() processor.Factory

Functions

func NewFactory

func NewFactory() processor.Factory

NewFactory returns a new factory for the aws attributes processor.