Starter

Shadow SNS

SNS starter-backed shadow traffic support for publishing duplicated requests to SNS.

Artifact
helix-shadow-sns-spring-boot-starter

Usage

build.gradle

Groovy DSL

dependencies {
    implementation helix.shadow.sns.springboot.starter
}

build.gradle.kts

Kotlin DSL

dependencies {
    implementation(helix.shadow.sns.springboot.starter)
}

Configuration

This starter uses the helix.shadow.sns property namespace.

Helix Shadow Traffic configuration for publishing mirrored traffic to AWS SNS.

  • helix.shadow.sns.enabled (Boolean): Enable or disable SNS shadow traffic.
  • helix.shadow.sns.percentage (Integer): Percentage of traffic to shadow (0-100).
  • helix.shadow.sns.inclusion-filters (List): Optional list of inclusion filters. Only requests matching at least one filter will be shadowed.
  • helix.shadow.sns.inclusion-filters[0].uri-pattern (String): Regex pattern matched against the request URI.
  • helix.shadow.sns.inclusion-filters[0].method (String): HTTP method to match (e.g., GET, POST). Use ‘ALL’ to match any method.
  • helix.shadow.sns.service-endpoint (String): Optional custom SNS service endpoint (e.g., for local testing or VPC endpoints).
  • helix.shadow.sns.topic-arn (String): SNS Topic ARN used to publish shadow traffic messages.