now function returns the fixed time value stored in c.

take consumes quota from reservoir, if any remains, then returns true. False otherwise.

2025-05-07: Begin Amazon modification. appliesTo performs a matching against rule properties to see if a given rule does match with any of the rule se

wildcardMatch returns true if text matches pattern at the given case-sensitivity; returns false otherwise.

Sample uses sampling targets of a given rule to decide which sampling should be done and returns a SamplingResult.

MatchAgainstManifestRules returns a Rule and boolean flag set as true if rule has been match against span attributes, otherwise nil and false.

RefreshManifestRules writes sampling rule properties to the manifest object.

getSamplingRules calls the collector(aws proxy enabled) for sampling rules.

getSamplingTargets calls the collector(aws proxy enabled) for sampling targets.

take consumes quota from reservoir, if any remains, then returns true. False otherwise.

NewFallbackSampler returns a FallbackSampler which samples 1 req/sec and additional 5% of requests using traceIDRatioBasedSampler.

End of Amazon modification. attributeMatching performs a match on attributes set by users on AWS X-Ray console.

deepCopy copies the m to another manifest object.

minimumPollingInterval finds the minimum polling interval for all the targets of m's Rules.

newClient returns an HTTP client with proxy endpoint.

RefreshManifestTargets updates sampling targets (statistics) for each rule.

Stop shuts down the UDP Exporter.

WithEndpoint sets custom proxy endpoint. If this option is not provided the default endpoint used will be http://127.0.0.1:2000.

WithSamplingRulesPollingInterval sets polling interval for sampling rules. If this option is not provided the default samplingRulesPollingInterval use

refreshQuotaBalanceLocked refreshes the quotaBalance. If borrowed is true then add to the quota balance 1 by every second, otherwise add to the quota

snapshots takes a snapshot of sampling statistics from all rules, resetting statistics counters in the process.

stale checks if targets (sampling stats) for a given rule is expired or not.

expired returns true if current time is past expiration timestamp. Otherwise, false is returned if no quota remains.

refreshManifest refreshes the manifest retrieved via getSamplingRules API.

sort sorts the Rules of m first by priority and then by name.

Expired returns true if the manifest has not been successfully refreshed in manifestTTL seconds.

NewClient creates a new OTLP UDP trace client.

ShouldSample matches span attributes with retrieved sampling rules and returns a sampling result. If the sampling parameters do not match or the manif

Start does nothing in an OTLP UDP client.

UploadTraces sends a batch of spans to the UDP Exporter.

WithEndpoint sets custom daemon endpoint. If this option is not provided, a default endpoint will be used.

c returns a channel that receives when the ticker fires.

generateClientID generates random client ID.

newTicker creates a new Ticker that will send the current time on its channel with the passed jitter.

snapshot takes a snapshot of the sampling statistics counters, returning samplingStatisticsDocument. It also resets statistics counters.

Description returns description of the sampler being used.

Description returns description of the sampler being used.

NewManifest return manifest object configured the passed with logging and an xrayClient configured to address addr.

NewSpanExporter constructs a new X-Ray UDP Span Exporter and starts it.

ShouldSample implements the logic of borrowing 1 req/sec and then use traceIDRatioBasedSampler to sample 5% of additional requests.

import "github.com/aws-observability/aws-otel-go/samplers/aws/xray" End of Amazon modification. Version is the current release version of the AWS XRay

WithLogger sets custom logging for remote sampling implementation. If this option is not provided the default logger used will be go-logr/stdr (https:

refreshQuotaBalanceLocked refreshes the quotaBalance considering elapsedTime. It is assumed the lock is held when calling this.

refreshTarget refreshes the sampling targets in manifest retrieved via getSamplingTargets API.

startPoller starts the rule and target poller in a single go routine which runs periodically to refresh the manifest and targets.

NewRemoteSampler returns a sampler which decides to sample a given request or not based on the sampling rules set by users on AWS X-Ray console. Sampl

SemVersion is the semantic version to be supplied to tracer/meter creation. Deprecated: Use [Version] instead.

assert early exit when rule properties retrieved from AWS X-Ray console does not match with span attributes.

assert that when attribute has http.url is empty, uses http.target wildcard matching.

2025-05-07: Begin Amazon modification.

assert that matching will not happen when rules has all the HTTP attrs set as non '*' values and span has no HTTP attributes.

assert that matching will not happen when rules has some HTTP attrs set as non '*' values and span has no HTTP attributes.

End of Amazon modification. assert that matching will happen when rules has all the HTTP attrs set as '*' and span has any attribute values.

assert that matching will happen when rules has all the HTTP attrs set as '*' values and span has no HTTP attributes.

assert that matching will not happen when rule and span ServiceType attr value is different.

assert that if rules has attribute and span has those attribute with same value then matching will happen.

assert that if rules has no attributes then matching will happen.

assert that wildcard attributes will match.

assert that borrow only 1 req/sec.

assert that we only borrow 1 req/sec.

assert that when elapsedTime is high quotaBalance should still be close to 1.

assert that when reservoir is expired we consume from quota is 1 and then when reservoir is not expired consume from assigned quota by X-Ray service.

assert that we can still borrowing from reservoir is possible since assigned quota is available to consume and it will increase used count.

assert that reservoir is not expired, quota is available so consuming from quota.

assert that deep copy creates a new manifest object with new address space.

assert that when user did not provide values are then config would be picked up from default values.

Validate Rules are NOT preserved when a rule is updated with a different ruleProperties with the same RuleName.

assert that manifest is expired.