Rate
Hold each log pattern, and each service, to a budget per window, on the forwarder, before that volume is billed downstream. Lines over a budget take the service's action; error-class lines keep a fixed count per pattern, and a pattern an operator lists in the mute file follows its own entry instead of the cap.
The rate regulator watches each container's recent volume and acts on any one pattern that spends more than the cap set for that container. That pattern is the same value, in the field symbolMessageField names (message_pattern in the shipped configuration), that a Reporter attributes cost to, so a top spender maps straight to what gets regulated. No cap ships by default, so nothing is regulated until an operator sets one.
The cap
The cap is a budget for one pattern in one container over one window (resetIntervalMs, default 4 minutes). The regulator counts it in unit: bytes, the UTF-8 size of each event as the forwarder hands it to the Receiver, the whole record and not only the message, or events, one per line, for analyzers that bill per event such as Datadog. The cap and total files are written in the same unit. The cap resolves per event: the container's row in the cap file, then the file's * row, then the fleet-wide absoluteCap. All three default to none, and a resolved cap of 0 means keep everything, so protection is opt-in.
Windows start at each multiple of resetIntervalMs since the Unix epoch, so every node's windows line up with the clock: with the default of 4 minutes they run from :00 to :04, :04 to :08 and on through the hour, the same windows for all patterns and services. The first window after the engine starts is partial and ends at the next multiple. A policy file reload does not start a new window.
At or below the cap every line is kept. Above it a line is held and takes the container's action, with three exceptions: the first baselineCount lines of every pattern each window (default 5), the error-class lines in keepCounts, and the optional share guard.
With the shipped settings, the most one pattern in one container passes per window is the larger of its cap and the 5-line sample, plus 50 lines for an error-class pattern. The window is recent rather than all-time, so a pattern that spikes during a deploy and then goes quiet stops being held on its own.
The share guard is off by default (minSharePercent: 0). Set above 0, it keeps a pattern over its cap while the pattern is below that share of its container's volume, (pattern units + event) / (container units + event) over the window.
Service totals
An optional total file bounds what each service passes per window on this node, across all its patterns. New patterns from a deploy each bring a full per-pattern cap, so a service without a total can send many times its budget until its caps are rewritten. Two rules apply once a service has a total:
- Largest first. When the service's caps alone let more than its total through in the previous window, every pattern's cap scales by total / that amount for the whole window, or by what they let through so far this window once that is larger. The service's largest patterns reach the scaled cap first and are held, and its small ones keep passing. The scale follows the previous window, so the window after a storm is scaled by the storm for its whole length and recovers the window after. The first window after a quiet one fills its total in arrival order before the scale applies. A service whose first lines of this window and of the last window it sent in are two window lengths or more apart scales by total / its units so far this window instead.
- Hard bound. Once the lines the service passed reach its total, every further line takes the service's action.
The baseline sample counts toward the total like any line. Once the total is spent, the service passes at most baselineMaxOverTotal more sample lines in the window (default 50, counted in lines whatever the unit), and the rest of its samples take the service's action. The error-class lines in keepCounts count toward the total the same way, and once it is spent the service passes at most keepMaxOverTotal more of them in the window (default 500, counted in lines), so with the shipped settings a burst of new error patterns exceeds the total by at most 550 lines. The lines a mute entry passes always pass and count toward the total, so the service's other patterns give way first. Each regulator instance holds its own total; the MCP's budget run (log10x_setup_recurring) divides a fleet budget across instances, and a node added between runs enforces its own total until the next run.
File format, CSV with a header row, keyed by the containerField value, read through totalLookupFile (TOTAL_LOOKUP_FILE):
container,total
<container>,<total>[:<untilEpochSec>][:<reason>]
*,<total>[:<untilEpochSec>][:<reason>]
totalis the service's total per window on this instance, inunit.0exempts the service.*sets the total for every service without a row of its own; a*row of0gives them none.untilEpochSecexpires the entry, which then self-heals to a no-op.reasonis free text for audit. Must not contain commas (would break CSV parsing).
A missing total file loads as an empty table, so no service has a total until a row names it. Totals apply to containers with a cap, in the regulators that read the cap file.
Error-class lines
Error-class lines are never held to zero. keepCounts passes a fixed number of lines per pattern per window for each listed level, once the pattern is over its cap or its service is over its total, and under an active mute entry. The shipped list is ERROR=50, CRITICAL=50 and FATAL=50; the lines past the count take the container's action. The count is per pattern, per container, per node, per window, so it bounds what an error storm adds to the bill. With a cap file, keepCountSlices (default 4) releases the count through the window: the allowance grows by a quarter each minute of a 4-minute window, 12, 25, 37 and 50 lines in all for ERROR=50, so a sustained storm passes 12 or 13 lines every minute. Lines a minute leaves unused carry to the next, so a burst late in the window passes more than one early in it, never more than the count, and lines under a mute entry share the same count.
ERROR, CRITICAL and FATAL always keep a count, 50 unless keepCounts sets another: the module sets the three itself and entries merge by level, so changing one means setting it. Any other level not in keepCounts, and a level set to -1 there, follows severityFloors, the fraction of a held pattern's lines kept at random. The shipped floors are 0 for every level, and any level with no floor of its own takes minRetentionThreshold (0). Both lists read the severity the level enrichment produced, so they apply whatever field the original log used. A config without keepCounts therefore still keeps them; severityFloors must stay set, since an empty or missing list stops the launch.
Warmup
An optional warmupMs leaves a container unregulated for that long after this regulator instance first sees its events. The default is 0, so a container is capped from its first line. Set it for slow-ramping JVMs or workloads with long init phases whose first minutes should not be capped.
"First sees" is per regulator instance, not per container birth. A container that has been running for hours but whose events have only just started flowing through this regulator, after a regulator restart or a forwarder reconnect, restarts the warmup window. With a warmup set, a daemonset rolling restart therefore disables the cap for warmupMs per node as it cycles.
Protection list
An optional mute file overrides the regulator for patterns an operator has declared. A listed, active pattern is decided by its entry, so the human declaration wins and the regulator is skipped for it; every other pattern is handled by the cap. The two run together rather than as separate modes.
File format, CSV with a header row, keyed by the joined fieldNames:
sampleRateretains that fraction:1is never sampled,0is a full mute.untilEpochSecexpires the entry, which then self-heals to a no-op.reasonis free text for audit.
The error-class levels in keepCounts still pass their count per pattern per window before the sample rate applies, so a 0 mute never silences ERROR, CRITICAL or FATAL. The file is typically committed to a repo and pulled via gitops, or read directly from a Kubernetes ConfigMap via the @kubernetes launch macro, so each change carries a diff, a review, and a merge. Both lanes hot-reload via atomic rename; a plain volume-mounted ConfigMap does not, because the swap is a symlink rename.
Per-container caps
An optional cap file sets a cap for a specific container in priority over the fleet-wide absoluteCap. Listed containers get their own row; unlisted containers get the * row, and with no * row they fall back to absoluteCap (or to no cap, when absoluteCap is 0).
File format, CSV with a header row, keyed by the containerField value (k8s container name by default):
capis the per-pattern per-window cap for the container, inunit.0exempts the container from every cap, the*row andabsoluteCapincluded.*sets the cap for every container without a row of its own; a*row of0exempts them all,absoluteCapincluded.untilEpochSecexpires the entry, which then self-heals to a no-op.reasonis free text for audit. Must not contain commas (would break CSV parsing).
The cap value changes; the baseline sample, the keep counts and the service total still apply. The Log10x MCP writes the file: its budget run (log10x_setup_recurring) writes it to the policy ConfigMap or commits it to the policy branch, and a log10x_configure_engine call derives caps from a target percent or a monthly dollar budget and delivers them as its delivery says: a PR against the gitops repo, a write to the policy ConfigMap, or no write (stdout_only).
Same hot-reload rule as the mute file: both launch-macro lanes reload, a plain volume-mounted ConfigMap does not.
From a policy repo, the GitHub lane in pipelines/gitops/config.yaml pulls log10x/policy/*.csv and mirrors it into ${GH_DEST} (default ${java.io.tmpdir}/tenx/github). With GH_ENABLED=true, GH_REPO, GH_BRANCH and GH_TOKEN set, the cap, action, total and config-generation files default to those copies, and each sync rewrites them in place. The folder must exist in the repo and hold caps.csv when the engine starts, and a sync refreshes only the files the first pull found. With the ConfigMap lane (K8S_ENABLED=true) also on, the GitHub copies win for these four files, so enable one lane.
Actions
An optional action file decides what happens to the lines the cap or the service total holds. Without it, or for a container with neither its own row nor a * row, the held lines take rateReceiverDefaultAction, pass unless set.
File format, CSV with a header row, keyed by the same containerField value as the cap file:
container,action
<container>,<action>[:<untilEpochSec>][:<reason>]
*,<action>[:<untilEpochSec>][:<reason>]
actionis one ofpass,offload,tier_down,compact,sample, ordrop.*sets the action for every container without a row of its own; a container with neither takesrateReceiverDefaultAction,passunless set.untilEpochSecexpires the entry, which then self-heals to a no-op.reasonis free text for audit. Must not contain commas (would break CSV parsing).
The action is set per service and applies to every held line in that service. Here a service is a container. Per-pattern thinning comes from the mute file, not from this file.
The event keeps flowing either way. The action lands on the event as its routeState, and the output streams and the forwarder recipe act on that, so offload and tier_down reach their destinations instead of being discarded at the regulator. The cap and the total decide which lines are held; the action only decides where they go.
The action and total files are siblings of the cap file in the same ConfigMap, and hot-reload on the same rule.
Containers
Share is scoped per container, named by containerField (default the k8s container name). That name is stable across replicas, so scaling from one pod to ten does not bypass the cap, and a sidecar never spends the application container's share. Use container, never pod.
Outside Kubernetes, or when no container field is present, the regulator falls back to a single node-wide bucket and caps each pattern across the node.
Savings
Held lines are measured, not estimated. The receive-stage aggregators tally every event by pattern and container both before and after regulation, so the saving for a pattern is the volume seen minus the volume emitted. A dropped event still counts as seen, so the figure reflects exactly what the regulator removed.
Config-version stamp
When the receiver runs the MCP closed loop, the control plane (log10x_configure_engine) writes a config-generation.csv next to the cap file in the same ConfigMap, a one-row key,value CSV whose generation is a hash of the cap policy. Point configGeneration.file at it (or set the CONFIG_GENERATION_FILE env) and the receiver stamps that value on every event as tenx_config_version and publishes it as one series per generation, config_generation_summaryBytes_total{tenx_config_version=...}, so the running engine advertises which config generation it loaded. The per-pattern counters do not carry the label, so a policy write does not restart their series. The MCP then confirms the policy it wrote is actually live by comparing the label to the hash of the current caps, the config-generation closed loop.
It is opt-in and decoupled from caps: unset by default, so a regulator managed by GitOps without the MCP emits no tenx_config_version label and never depends on the file existing. Hot-reloaded like the cap file, so a new generation goes live without an engine restart (this is the stale → live transition the verifier observes).
Wiring
rateReceiver:
fieldNames:
- message_pattern # the pattern identity, the field symbolMessageField names
containerField: container # scopes the cap denominator
unit: bytes # or events, for analyzers that bill per event
absoluteCap: 10485760 # 10 MB per pattern per container per window (optional; 0 = no fleet-wide cap)
minSharePercent: 0 # share guard, off
keepCounts: # error-class lines kept per pattern per window once held
- ERROR=50
- CRITICAL=50
- FATAL=50
keepCountSlices: 4 # slices of the window through which the keep count accumulates; 1 = all at the window start
severityFloors: # random share kept for the other levels once held
- TRACE=0
- DEBUG=0
- INFO=0
- WARN=0
- ERROR=0
- CRITICAL=0
- FATAL=0
warmupMs: 0 # per-instance grace before capping; 0 caps from the first line
baselineCount: 5
baselineMaxOverTotal: 50 # sample lines a service passes per window once over its total; 0 = no bound
keepMaxOverTotal: 500 # keep-count lines a service passes per window once over its total; 0 = no bound
capLookup:
# file: $=path("data/caps") + "/caps.csv" # optional per-container caps, with a * row
retain: $=parseDuration("10m")
# actionLookupFile: $=path("data/caps") + "/actions.csv" # optional per-container action for held lines; default pass
# totalLookupFile: $=path("data/caps") + "/totals.csv" # optional per-service total per window
configGeneration:
# file: $=TenXEnv.get("CONFIG_GENERATION_FILE", "") # MCP config-version stamp; opt-in, sibling of caps.csv
Tune these values in this config block, not via container environment variables. Any rateReceiver: key set here resolves to a launch argument at engine init and shadows a same-named env var, so env-only overrides are silently ignored. Edit the config (via a gitops PR) to change a value at runtime.
Config Files
To configure the rate receiver module, Edit these files.
Below is the default configuration from: rate/config.yaml.
ewogICJ0eXBlIiA6ICJvYmplY3QiLAogICJwcm9wZXJ0aWVzIiA6IHsKICAgICJpbmNsdWRlIiA6IHsKICAgICAgInR5cGUiIDogInN0cmluZyIKICAgIH0sCiAgICAidGVueCIgOiB7CiAgICAgICJ0eXBlIiA6ICJzdHJpbmciCiAgICB9LAogICAgInJhdGVSZWNlaXZlciIgOiB7CiAgICAgICJ0eXBlIiA6ICJvYmplY3QiLAogICAgICAiYWRkaXRpb25hbFByb3BlcnRpZXMiIDogZmFsc2UsCiAgICAgICJwcm9wZXJ0aWVzIiA6IHsKICAgICAgICAiZmllbGROYW1lcyIgOiB7CiAgICAgICAgICAidHlwZSIgOiBbCiAgICAgICAgICAgICJhcnJheSIsCiAgICAgICAgICAgICJzdHJpbmciLAogICAgICAgICAgICAibnVsbCIKICAgICAgICAgIF0sCiAgICAgICAgICAibWFya2Rvd25EZXNjcmlwdGlvbiIgOiAiTGlzdCBvZiBUZW5YT2JqZWN0IGZpZWxkcyB0byBpZGVudGlmeSByYXRlIGNvdW50ZXIgYnVja2V0c1xuXG5EZWZpbmVzIHRoZSBsaXN0IG9mIFRlblhPYmplY3QgZmllbGQgbmFtZXMgZXh0cmFjdGVkIHRvIGlkZW50aWZ5IHdoaWNoIHJhdGUgY291bnRlciBidWNrZXQgYW4gZXZlbnQgYmVsb25ncyB0by4gVGhlIGxpc3QgdXN1YWxseSBjb250YWlucyB0aGUgcGF0dGVybiBmaWVsZCB0aGUgW21lc3NhZ2UgZW5yaWNobWVudF0oaHR0cHM6Ly9kb2MubG9nMTB4LmNvbS9ydW4vaW5pdGlhbGl6ZS9tZXNzYWdlLykgbW9kdWxlIHdyaXRlcywgbmFtZWQgYnkgYHN5bWJvbE1lc3NhZ2VGaWVsZGA6IGBtZXNzYWdlX3BhdHRlcm5gIGluIHRoZSBzaGlwcGVkIGNvbmZpZ3VyYXRpb24sIGBzeW1ib2xNZXNzYWdlYCBhdCB0aGF0IG9wdGlvbidzIGRlZmF1bHQuIEl0IGNhbiBpbmNsdWRlIGFkZGl0aW9uYWwgZmllbGRzIGxpa2UgW0dlb0lQXShodHRwczovL2RvYy5sb2cxMHguY29tL3J1bi9pbml0aWFsaXplL2dlb0lQLyksIFtIVFRQIGNvZGVdKGh0dHBzOi8vZG9jLmxvZzEweC5jb20vcnVuL2luaXRpYWxpemUvaHR0cENvZGUvKSwgW2s4cyBjb250YWluZXIgbmFtZV0oaHR0cHM6Ly9kb2MubG9nMTB4LmNvbS9ydW4vaW5pdGlhbGl6ZS9rOHMvKSwgb3IgY3VzdG9tIGVucmljaG1lbnRzIGZvciBtdWx0aS1kaW1lbnNpb25hbCByYXRlIHRyYWNraW5nLiAgKipDb21tb24gVXNlIENhc2VzOioqICAqKlNpbmdsZS1hcHAgcmVjZWl2aW5nIChwZXIgZXZlbnQgdHlwZSk6KiogYGBgeWFtbCByYXRlUmVjZWl2ZXJGaWVsZE5hbWVzOiAgIC0gbWVzc2FnZV9wYXR0ZXJuIGBgYCAgKipNdWx0aS1kaW1lbnNpb25hbCB0cmFja2luZyAoZXZlbnQgdHlwZSArIGdlb2dyYXBoeSArIEhUVFAgc3RhdHVzKToqKiBgYGB5YW1sIHJhdGVSZWNlaXZlckZpZWxkTmFtZXM6ICAgLSBtZXNzYWdlX3BhdHRlcm4gICAtIGNvdW50cnkgICAtIGh0dHBDb2RlIGBgYCAgKipNdWx0aS1hcHAgcmVjZWl2aW5nIGluIEt1YmVybmV0ZXM6KiogICpPcHRpb24gQTogQ2FwIHRvdGFsIHNwZW5kIHBlciBhcHAgKGFsbCBldmVudCB0eXBlcyBjb21iaW5lZCk6KiBgYGB5YW1sIHJhdGVSZWNlaXZlckZpZWxkTmFtZXM6ICAgLSBjb250YWluZXIgICMgQWdncmVnYXRlcyBhbGwgZXZlbnQgdHlwZXMgZm9yIGVhY2ggYXBwIGBgYCBFYWNoIGFwcCdzIHRvdGFsIHNwZW5kIChhY3Jvc3MgYWxsIGV2ZW50IHR5cGVzIGFuZCBwb2RzKSBnZXRzIG9uZSBjYXAuIFNpbXBsZSBidXQgbG9zZXMgZXZlbnQtdHlwZSBpbnRlbGxpZ2VuY2UuICAqT3B0aW9uIEI6IENhcCBzcGVuZCBwZXIgZXZlbnQgdHlwZSBwZXIgYXBwOiogYGBgeWFtbCByYXRlUmVjZWl2ZXJGaWVsZE5hbWVzOiAgIC0gbWVzc2FnZV9wYXR0ZXJuICAjIEV2ZW50IHR5cGUgICAtIGNvbnRhaW5lciAgICAgICMgQXBwIGlkZW50aWZpZXIgKHNhbWUgYWNyb3NzIGFsbCBwb2RzKSBgYGAgRWFjaCAoZXZlbnQgdHlwZSDDlyBhcHApIGNvbWJvIGdldHMgaXRzIG93biBjYXAuIFByb3ZpZGVzIGZhaXJuZXNzIHdpdGhpbiBhcHBzIGJ1dCBhbGxvd3MgYXBwcyB3aXRoIG1hbnkgZXZlbnQgdHlwZXMgdG8gcG90ZW50aWFsbHkgZXhjZWVkIG9uZSB0b3RhbCBjYXAuICBUaGUgY29udGFpbmVyIGlzIGNvbmZpZ3VyZWQgc2VwYXJhdGVseSB2aWEgYHJhdGVSZWNlaXZlckNvbnRhaW5lckZpZWxkYCAoaXQgc2NvcGVzIHRoZSBzaGFyZSBkZW5vbWluYXRvciksIHNvIGBmaWVsZE5hbWVzYCBpZGVudGlmaWVzIG9ubHkgdGhlIGxvZyBwYXR0ZXJuIGl0c2VsZi4gKERlZmF1bHQ6IFtcInN5bWJvbE1lc3NhZ2VcIl0pIiwKICAgICAgICAgICJpdGVtcyIgOiB7CiAgICAgICAgICAgICJ0eXBlIiA6ICJzdHJpbmciCiAgICAgICAgICB9LAogICAgICAgICAgImRlZmF1bHQiIDogWwogICAgICAgICAgICAic3ltYm9sTWVzc2FnZSIKICAgICAgICAgIF0KICAgICAgICB9LAogICAgICAgICJjb250YWluZXJGaWVsZCIgOiB7CiAgICAgICAgICAidHlwZSIgOiBbCiAgICAgICAgICAgICJzdHJpbmciLAogICAgICAgICAgICAibnVsbCIKICAgICAgICAgIF0sCiAgICAgICAgICAibWFya2Rvd25EZXNjcmlwdGlvbiIgOiAiRmllbGQgd2hvc2UgdmFsdWUgc2NvcGVzIHRoZSBwZXItY29udGFpbmVyIHNoYXJlIGRlbm9taW5hdG9yXG5cbk5hbWVzIHRoZSBmaWVsZCB3aG9zZSB2YWx1ZSBzY29wZXMgdGhlIHNoYXJlIGRlbm9taW5hdG9yICh0aGUgcGVyLWNvbnRhaW5lciB0b3RhbCkuIEEgcGF0dGVybidzIHNoYXJlIGlzIG1lYXN1cmVkIGFnYWluc3QgdGhlIHRvdGFsIHZvbHVtZSBvZiB0aGUgY29udGFpbmVyIGl0IGJlbG9uZ3MgdG8sIHNvIHRoZSBjYXAgaXMgZW5mb3JjZWQgcGVyIGAocGF0dGVybiwgY29udGFpbmVyKWAuICBEZWZhdWx0cyB0byB0aGUgW2s4cyBjb250YWluZXIgbmFtZV0oaHR0cHM6Ly9kb2MubG9nMTB4LmNvbS9ydW4vaW5pdGlhbGl6ZS9rOHMvKSwgd2hpY2ggaXMgc3RhYmxlIGFjcm9zcyBwb2QgcmVwbGljYXMsIHNvIHBvZHMgb2Ygb25lIGNvbnRhaW5lciBvbiB0aGUgc2FtZSBub2RlIHNoYXJlIHRoZSBjYXAsIGFuZCBhIHNpZGVjYXIgbmV2ZXIgY29uc3VtZXMgdGhlIGFwcGxpY2F0aW9uIGNvbnRhaW5lcidzIGFsbG93YW5jZS4gRWFjaCByZWd1bGF0b3IgaW5zdGFuY2UgY291bnRzIGl0cyBvd24sIHNvIHBvZHMgc3ByZWFkIGFjcm9zcyB0ZW4gbm9kZXMgZ2V0IHRlbiBjYXBzLiBVc2UgYGNvbnRhaW5lcmAsIG5ldmVyIGBwb2RgLiAgV2hlbiB0aGUgZmllbGQgaXMgYWJzZW50IG9uIGFuIGV2ZW50IChub24tazhzIGlucHV0LCBvciBubyBrOHMgZXh0cmFjdG9yIGNvbmZpZ3VyZWQpLCB0aGUgcmVndWxhdG9yIGZhbGxzIGJhY2sgdG8gYSBzaW5nbGUgbm9kZS13aWRlIGJ1Y2tldCBhbmQgZW5mb3JjZXMgdGhlIGNhcCBwZXIgcGF0dGVybiBhY3Jvc3MgdGhlIG5vZGUuIChEZWZhdWx0OiApIiwKICAgICAgICAgICJkZWZhdWx0IiA6ICIiCiAgICAgICAgfSwKICAgICAgICAicmVzZXRJbnRlcnZhbE1zIiA6IHsKICAgICAgICAgICJ0eXBlIiA6IFsKICAgICAgICAgICAgIm51bWJlciIsCiAgICAgICAgICAgICJzdHJpbmciLAogICAgICAgICAgICAibnVsbCIKICAgICAgICAgIF0sCiAgICAgICAgICAibWFya2Rvd25EZXNjcmlwdGlvbiIgOiAiUmVzZXQgaW50ZXJ2YWwgZm9yIHJhdGUgY291bnRlcnMgaW4gbWlsbGlzZWNvbmRzXG5cbkRlZmluZXMgdGhlIHdpbmRvdyBpbiBtaWxsaXNlY29uZHMgb3ZlciB3aGljaCBhIHBhdHRlcm4ncyByZWNlbnQgc2hhcmUgaXMgbWVhc3VyZWQuIFRoZSBjb3VudGVycyByZXNldCBldmVyeSBpbnRlcnZhbCwgc28gc2hhcmUgcmVmbGVjdHMgcmVjZW50IHZvbHVtZSByYXRoZXIgdGhhbiBhbGwtdGltZSB0b3RhbHMuIFdpbmRvd3Mgc3RhcnQgYXQgZWFjaCBtdWx0aXBsZSBvZiB0aGUgaW50ZXJ2YWwgc2luY2UgdGhlIFVuaXggZXBvY2gsIHNvIGV2ZXJ5IG5vZGUncyB3aW5kb3dzIGxpbmUgdXAgd2l0aCB0aGUgY2xvY2ssIHRoZSBzYW1lIHdpbmRvd3MgZm9yIGFsbCBwYXR0ZXJucyBhbmQgc2VydmljZXMuIFRoZSBmaXJzdCB3aW5kb3cgYWZ0ZXIgYSBzdGFydCBpcyBwYXJ0aWFsLCBhbmQgYSBwb2xpY3kgZmlsZSByZWxvYWQgZG9lcyBub3Qgc3RhcnQgYSBuZXcgd2luZG93LiAgU2hvcnRlciB3aW5kb3dzIChlLmcuLCAxIG1pbnV0ZSkgYXJlIG1vcmUgcmVhY3RpdmUgYnV0IG5vaXNpZXI7IGxvbmdlciB3aW5kb3dzIGFyZSBzbW9vdGhlciBidXQgc2xvd2VyIHRvIGFkYXB0LiBUaGUgZGVmYXVsdCBvZiA0IG1pbnV0ZXMgYmFsYW5jZXMgdGhlIHR3by4gICoqVmFsaWRhdGlvbjoqKiBNdXN0IGJlIGF0IGxlYXN0IDYwMDAwIG1pbGxpc2Vjb25kcyAoMSBtaW51dGUpLiAoQWNjZXB0cyBudW1iZXIgb3Igc3RyaW5nIHdpdGggJD0gcHJlZml4IGZvciBydW50aW1lIGV2YWx1YXRpb24pIChEZWZhdWx0OiAyNDAwMDApIiwKICAgICAgICAgICJkZWZhdWx0IiA6IDI0MDAwMAogICAgICAgIH0sCiAgICAgICAgInVuaXQiIDogewogICAgICAgICAgInR5cGUiIDogWwogICAgICAgICAgICAic3RyaW5nIiwKICAgICAgICAgICAgIm51bGwiCiAgICAgICAgICBdLAogICAgICAgICAgIm1hcmtkb3duRGVzY3JpcHRpb24iIDogIldoYXQgdGhlIGNhcHMsIHRoZSB0b3RhbHMgYW5kIHRoZSBzaGFyZSBndWFyZCBjb3VudCwgYGJ5dGVzYCBvciBgZXZlbnRzYFxuXG5EZWZpbmVzIHdoYXQgdGhlIHJlZ3VsYXRvciBjb3VudHMgYWdhaW5zdCBgcmF0ZVJlY2VpdmVyQWJzb2x1dGVDYXBgLCB0aGUgY2FwIGZpbGUgKGByYXRlUmVjZWl2ZXJDYXBMb29rdXBGaWxlYCksIHRoZSB0b3RhbCBmaWxlIChgcmF0ZVJlY2VpdmVyVG90YWxMb29rdXBGaWxlYCkgYW5kIHRoZSBzaGFyZSBndWFyZDogYGJ5dGVzYCBjb3VudHMgdGhlIFVURi04IHNpemUgb2YgZWFjaCBldmVudCBhcyB0aGUgZm9yd2FyZGVyIHNlbmRzIGl0LCB0aGUgd2hvbGUgcmVjb3JkIGFuZCBub3Qgb25seSB0aGUgbWVzc2FnZSwgYGV2ZW50c2AgY291bnRzIGVhY2ggbGluZSBhcyAxLiAgVXNlIGBldmVudHNgIHdoZXJlIHRoZSBhbmFseXplciBiaWxscyBwZXIgZXZlbnQgKERhdGFkb2cgaW5kZXhlcyBsb2dzIHBlciBldmVudCkgYW5kIGBieXRlc2Agd2hlcmUgaXQgYmlsbHMgcGVyIEdCLiBXcml0ZSB0aGUgY2FwIGFuZCB0b3RhbCBmaWxlcyBpbiB0aGUgc2FtZSB1bml0LiAgKipWYWxpZGF0aW9uOioqIG11c3QgYmUgYGJ5dGVzYCBvciBgZXZlbnRzYDsgYW55IG90aGVyIHZhbHVlIHN0b3BzIHRoZSBsYXVuY2guIChEZWZhdWx0OiBieXRlcykiLAogICAgICAgICAgImRlZmF1bHQiIDogImJ5dGVzIgogICAgICAgIH0sCiAgICAgICAgIm1pblJldGVudGlvblRocmVzaG9sZCIgOiB7CiAgICAgICAgICAidHlwZSIgOiBbCiAgICAgICAgICAgICJudW1iZXIiLAogICAgICAgICAgICAic3RyaW5nIiwKICAgICAgICAgICAgIm51bGwiCiAgICAgICAgICBdLAogICAgICAgICAgIm1hcmtkb3duRGVzY3JpcHRpb24iIDogIkRlZmF1bHQgcmV0ZW50aW9uIGZsb29yIGZvciBzZXZlcml0eSBsZXZlbHMgbm90IGxpc3RlZCBpbiBzZXZlcml0eUZsb29yc1xuXG5EZWZpbmVzIHRoZSByZXRlbnRpb24gZmxvb3IgKDAuMCB0byAxLjApIHVzZWQgZm9yIGFueSBzZXZlcml0eSBsZXZlbCBub3QgcHJlc2VudCBpbiBgcmF0ZVJlY2VpdmVyU2V2ZXJpdHlGbG9vcnNgOiB0aGUgZnJhY3Rpb24gb2YgYSBoZWxkIHBhdHRlcm4ncyBsaW5lcyBvZiB0aGF0IGxldmVsIGtlcHQgYXQgcmFuZG9tLiBgMGAga2VlcHMgbm9uZSwgc28gdGhlIGNhcCBob2xkcy4gKEFjY2VwdHMgbnVtYmVyIG9yIHN0cmluZyB3aXRoICQ9IHByZWZpeCBmb3IgcnVudGltZSBldmFsdWF0aW9uKSAoRGVmYXVsdDogMCkiLAogICAgICAgICAgImRlZmF1bHQiIDogMAogICAgICAgIH0sCiAgICAgICAgInNldmVyaXR5Rmxvb3JzIiA6IHsKICAgICAgICAgICJ0eXBlIiA6IFsKICAgICAgICAgICAgImFycmF5IiwKICAgICAgICAgICAgInN0cmluZyIsCiAgICAgICAgICAgICJudWxsIgogICAgICAgICAgXSwKICAgICAgICAgICJtYXJrZG93bkRlc2NyaXB0aW9uIiA6ICJGcmFjdGlvbiBvZiBlYWNoIHNldmVyaXR5IGxldmVsIGtlcHQgYXQgcmFuZG9tIG9uY2UgYSBwYXR0ZXJuIGlzIGhlbGRcblxuRGVmaW5lcyBhIG1hcCBvZiBbc2V2ZXJpdHkgbGV2ZWxzXShodHRwczovL2RvYy5sb2cxMHguY29tL3J1bi9pbml0aWFsaXplL2xldmVsLykgdG8gdGhlIGZyYWN0aW9uICgwLjAgdG8gMS4wKSBvZiBhIGhlbGQgcGF0dGVybidzIGxpbmVzIGtlcHQgYXQgcmFuZG9tLCBmb3IgbGV2ZWxzIG5vdCBsaXN0ZWQgaW4gYHJhdGVSZWNlaXZlcktlZXBDb3VudHNgLiBUaGUgc2hpcHBlZCBjb25maWd1cmF0aW9uIHNldHMgZXZlcnkgbGV2ZWwgdG8gYDBgLCBzbyBhIGNhcCBob2xkcyBhbmQgZXJyb3ItY2xhc3MgbGV2ZWxzIHBhc3MgYnkgY291bnQgaW5zdGVhZC4gIFRoZSBmbG9vciBhbHNvIGFwcGxpZXMgdW5kZXIgYSBtdXRlLWZpbGUgZW50cnk6IGFuIGFjdGl2ZSBlbnRyeSBrZWVwcyB0aGUgbGFyZ2VyIG9mIGl0cyBzYW1wbGUgcmF0ZSBhbmQgdGhlIGZsb29yLiAgRmxvb3ItbWFwIGtleXMgbXVzdCBtYXRjaCB0aGUgbGV2ZWwgdm9jYWJ1bGFyeSBlbWl0dGVkIGJ5IHRoZSBsZXZlbCBlbnJpY2htZW50LiBBbnkgbGV2ZWwgbm90IGxpc3RlZCB1c2VzIGByYXRlUmVjZWl2ZXJNaW5SZXRlbnRpb25UaHJlc2hvbGRgLiAgRm9yIGV4YW1wbGU6ICBgYGAgeWFtbCBzZXZlcml0eUZsb29yczogICAtIFRSQUNFPTAgICAtIERFQlVHPTAgICAtIElORk89MCAgIC0gV0FSTj0wICAgLSBFUlJPUj0wICAgLSBDUklUSUNBTD0wICAgLSBGQVRBTD0wIGBgYCIsCiAgICAgICAgICAiaXRlbXMiIDogewogICAgICAgICAgICAidHlwZSIgOiAic3RyaW5nIgogICAgICAgICAgfQogICAgICAgIH0sCiAgICAgICAgImtlZXBDb3VudHMiIDogewogICAgICAgICAgInR5cGUiIDogWwogICAgICAgICAgICAiYXJyYXkiLAogICAgICAgICAgICAic3RyaW5nIiwKICAgICAgICAgICAgIm51bGwiCiAgICAgICAgICBdLAogICAgICAgICAgIm1hcmtkb3duRGVzY3JpcHRpb24iIDogIkxpbmVzIHBlciBwYXR0ZXJuIHBlciB3aW5kb3cgdGhhdCBwYXNzIGZvciBhIGxldmVsIG9uY2UgdGhlIHBhdHRlcm4gaXMgaGVsZFxuXG5EZWZpbmVzIGEgbWFwIG9mIFtzZXZlcml0eSBsZXZlbHNdKGh0dHBzOi8vZG9jLmxvZzEweC5jb20vcnVuL2luaXRpYWxpemUvbGV2ZWwvKSB0byBhIGNvdW50OiB0aGUgbnVtYmVyIG9mIGxpbmVzIG9mIGVhY2ggcGF0dGVybiBvZiB0aGF0IGxldmVsIHRoYXQgcGFzcyBwZXIgd2luZG93IG9uY2UgdGhlIHBhdHRlcm4gaXMgb3ZlciBpdHMgY2FwIG9yIGl0cyBjb250YWluZXIgaXMgb3ZlciBpdHMgdG90YWwgKGByYXRlUmVjZWl2ZXJUb3RhbExvb2t1cEZpbGVgKSwgYW5kIHVuZGVyIGFuIGFjdGl2ZSBtdXRlLWZpbGUgZW50cnkuIExpbmVzIHBhc3QgdGhlIGNvdW50IHRha2UgdGhlIGNvbnRhaW5lcidzIGFjdGlvbiwgb3IgdGhlIG11dGUncyBzYW1wbGUgcmF0ZSB1bmRlciBhIG11dGUuIEEgbGlzdGVkIGxldmVsIHNraXBzIGl0cyBgcmF0ZVJlY2VpdmVyU2V2ZXJpdHlGbG9vcnNgIGRyYXcuICBUaGUgY291bnQgaXMgcGVyIHBhdHRlcm4sIHBlciBjb250YWluZXIsIHBlciByZWd1bGF0b3IgaW5zdGFuY2UgKG9uZSBwZXIgbm9kZSksIHBlciB3aW5kb3cgKGByYXRlUmVjZWl2ZXJSZXNldEludGVydmFsTXNgKS4gVGhlIGxpbmVzIGl0IHBhc3NlcyBjb3VudCB0b3dhcmQgdGhlIGNvbnRhaW5lcidzIHRvdGFsLCBhbmQgb25jZSB0aGUgdG90YWwgaXMgc3BlbnQgdGhlIGNvbnRhaW5lciBwYXNzZXMgYXQgbW9zdCBgcmF0ZVJlY2VpdmVyS2VlcE1heE92ZXJUb3RhbGAgbW9yZSBvZiB0aGVtIGluIHRoZSB3aW5kb3cuICBLZXlzIG11c3QgbWF0Y2ggdGhlIGxldmVsIHZvY2FidWxhcnkgZW1pdHRlZCBieSB0aGUgbGV2ZWwgZW5yaWNobWVudC4gVGhlIG1vZHVsZSdzIHNldHRpbmdzIHNldCBgRVJST1I9NTBgLCBgQ1JJVElDQUw9NTBgIGFuZCBgRkFUQUw9NTBgLCBhbmQgZW50cmllcyBtZXJnZSBieSBsZXZlbCwgc28gdGhvc2UgdGhyZWUgbGV2ZWxzIGFsd2F5cyBrZWVwIGEgY291bnQgKDUwIHVubGVzcyBzZXQpOyBhbiBlbnRyeSBmb3Igb25lIG9mIHRoZW0gaW4gdGhlIGNvbmZpZyBvciBvbiB0aGUgY29tbWFuZCBsaW5lIGNvbWVzIGxhdGVyIGFuZCB3aW5zLCBhbmQgYC0xYCBnaXZlcyBpdCBpdHMgZmxvb3IgaW5zdGVhZC4gQW55IG90aGVyIGxldmVsIG5vdCBsaXN0ZWQgZm9sbG93cyBpdHMgZmxvb3IuICBGb3IgZXhhbXBsZTogIGBgYCB5YW1sIGtlZXBDb3VudHM6ICAgLSBFUlJPUj01MCAgIC0gQ1JJVElDQUw9NTAgICAtIEZBVEFMPTUwIGBgYCIsCiAgICAgICAgICAiaXRlbXMiIDogewogICAgICAgICAgICAidHlwZSIgOiAic3RyaW5nIgogICAgICAgICAgfQogICAgICAgIH0sCiAgICAgICAgImtlZXBDb3VudFNsaWNlcyIgOiB7CiAgICAgICAgICAidHlwZSIgOiBbCiAgICAgICAgICAgICJudW1iZXIiLAogICAgICAgICAgICAic3RyaW5nIiwKICAgICAgICAgICAgIm51bGwiCiAgICAgICAgICBdLAogICAgICAgICAgIm1hcmtkb3duRGVzY3JpcHRpb24iIDogIkVxdWFsIHNsaWNlcyBvZiB0aGUgd2luZG93IHRocm91Z2ggd2hpY2ggZWFjaCBwYXR0ZXJuJ3Mga2VlcCBjb3VudCBpcyByZWxlYXNlZFxuXG5EZWZpbmVzIGhvdyBtYW55IGVxdWFsIHNsaWNlcyBvZiB0aGUgd2luZG93IChgcmF0ZVJlY2VpdmVyUmVzZXRJbnRlcnZhbE1zYCkgcmVsZWFzZSB0aGUgYHJhdGVSZWNlaXZlcktlZXBDb3VudHNgIGxpbmVzIG9mIGEgcGF0dGVybiBvbmNlIGl0IGlzIG92ZXIgaXRzIGNhcCBvciBpdHMgY29udGFpbmVyIGlzIG92ZXIgaXRzIHRvdGFsLiBUaGUgYWxsb3dhbmNlIGFjY3VtdWxhdGVzIHRocm91Z2ggdGhlIHdpbmRvdzogYnkgdGhlIGVuZCBvZiB0aGUgZmlyc3Qgb2YgUyBzbGljZXMgdGhlIHBhdHRlcm4gbWF5IGhhdmUgcGFzc2VkIHRoZSBjb3VudCB4IDEgLyBTIGxpbmVzLCBieSB0aGUgZW5kIG9mIHRoZSBzZWNvbmQgdGhlIGNvdW50IHggMiAvIFMsIHJvdW5kZWQgZG93biwgYW5kIHRoZSB3aG9sZSBjb3VudCBpbiB0aGUgbGFzdCwgc28gd2l0aCBgRVJST1I9NTBgLCA0IHNsaWNlcyBhbmQgdGhlIDQtbWludXRlIHdpbmRvdyBhIHN1c3RhaW5lZCBzdG9ybSBwYXNzZXMgMTIsIDEzLCAxMiBhbmQgMTMgbGluZXMgaW4gdGhlIHdpbmRvdydzIGZvdXIgbWludXRlcyBhbmQgcmVhY2hlcyB0aGUgZGVzdGluYXRpb24gaW4gZXZlcnkgb25lIG9mIHRoZW0uIExpbmVzIGEgc2xpY2UgbGVhdmVzIHVudXNlZCBjYXJyeSB0byB0aGUgbmV4dCwgc28gYSBidXJzdCBsYXRlIGluIHRoZSB3aW5kb3cgcGFzc2VzIG1vcmUgdGhhbiBvbmUgZWFybHkgaW4gaXQsIG5ldmVyIG1vcmUgdGhhbiB0aGUgY291bnQuIExpbmVzIGFuIGFjdGl2ZSBtdXRlLWZpbGUgZW50cnkgcGFzc2VzIGFuZCB0aGUgbGluZXMgcmVsZWFzZWQgaGVyZSBzaGFyZSBvbmUgY291bnQgcGVyIHdpbmRvdy4gU2xpY2VzIHN0YXJ0IG9uIHRoZSBjbG9jayBsaWtlIHdpbmRvd3MsIHNvIHdpdGggdGhlIGRlZmF1bHRzIGVhY2ggc2xpY2UgaXMgb25lIGNsb2NrIG1pbnV0ZS4gYDFgIHJlbGVhc2VzIHRoZSB3aG9sZSBjb3VudCBhdCB0aGUgc3RhcnQgb2YgdGhlIHdpbmRvdzsgYSB2YWx1ZSBiZWxvdyAxIG9yIG5vdCBhIG51bWJlciBhY3RzIGFzIDEsIGFuZCBhIGZyYWN0aW9uIGlzIHJvdW5kZWQgZG93bi4gUGFzdCB0aGUgY29udGFpbmVyJ3MgdG90YWwgZXZlcnkga2VlcC1jb3VudCBsaW5lIGNvdW50cyB0b3dhcmQgYHJhdGVSZWNlaXZlcktlZXBNYXhPdmVyVG90YWxgLiBSZWFkIGJ5IHRoZSBjYXAtZmlsZSByZWd1bGF0b3JzLiAoQWNjZXB0cyBudW1iZXIgb3Igc3RyaW5nIHdpdGggJD0gcHJlZml4IGZvciBydW50aW1lIGV2YWx1YXRpb24pIChEZWZhdWx0OiA0KSIsCiAgICAgICAgICAiZGVmYXVsdCIgOiA0CiAgICAgICAgfSwKICAgICAgICAibG9va3VwIiA6IHsKICAgICAgICAgICJ0eXBlIiA6ICJvYmplY3QiLAogICAgICAgICAgImFkZGl0aW9uYWxQcm9wZXJ0aWVzIiA6IGZhbHNlLAogICAgICAgICAgInByb3BlcnRpZXMiIDogewogICAgICAgICAgICAiZmlsZSIgOiB7CiAgICAgICAgICAgICAgInR5cGUiIDogWwogICAgICAgICAgICAgICAgInN0cmluZyIsCiAgICAgICAgICAgICAgICAibnVsbCIKICAgICAgICAgICAgICBdLAogICAgICAgICAgICAgICJtYXJrZG93bkRlc2NyaXB0aW9uIiA6ICJEZWNsYXJhdGl2ZSBtdXRlIGZpbGUga2V5ZWQgYnkgZmllbGQtc2V0XG5cbkRlZmluZXMgdGhlIHBhdGggdG8gYSBkZWNsYXJhdGl2ZSAqKm11dGUgZmlsZSoqIHRoYXQgY2FwcyBzcGVjaWZpYyBsb2cgcGF0dGVybnMgYnkgdGhlIGpvaW5lZCBmaWVsZC1zZXQgZGVmaW5lZCBpbiBgcmF0ZVJlY2VpdmVyRmllbGROYW1lc2AgKGUuZy4gYG1lc3NhZ2VfcGF0dGVybmAsIGBjb250YWluZXJgLCBgaHR0cENvZGVgKS4gVGhlIGtleSBmb3JtYXQgaXMgdGhlIHNhbWUgb25lIHRoZSBsb2NhbCByZWNlaXZlciB1c2VzIGZvciBwZXItbm9kZSBjb3VudGVycy4gIFdoZW4gdGhpcyBvcHRpb24gaXMgc2V0LCB0aGUgbXV0ZSBmaWxlICoqY29tcG9zZXMgd2l0aCoqIHRoZSByZWd1bGF0b3IgcmF0aGVyIHRoYW4gcmVwbGFjaW5nIGl0OiBhIGxpc3RlZCwgYWN0aXZlIHBhdHRlcm4gaXMgZGVjaWRlZCBieSBpdHMgZmlsZSBlbnRyeSAodGhlIGh1bWFuIGRlY2xhcmF0aW9uIHdpbnMsIGFuZCB0aGUgcmVndWxhdG9yIGlzIHNraXBwZWQgZm9yIHRoYXQgZXZlbnQpLCB3aGlsZSBldmVyeSBvdGhlciBwYXR0ZXJuIGlzIGhhbmRsZWQgYnkgdGhlIHJlZ3VsYXRvcidzIGNhcC4gICoqRmlsZSBmb3JtYXQqKiAoQ1NWOyBoZWFkZXIgcm93ICsgb25lIGNvbW1hLXNlcGFyYXRlZCBlbnRyeSBwZXIgcm93KTogIGBgYCBmaWVsZFNldCx2YWx1ZSA8ZmllbGRTZXRLZXk+LDxzYW1wbGVSYXRlPjo8dW50aWxFcG9jaFNlYz5bOjxyZWFzb24+XSBgYGAgIC0gYGZpZWxkU2V0S2V5YCwgdGhlIGpvaW5lZCB2YWx1ZXMgb2YgdGhlIGZpZWxkcyBuYW1lZCBpbiBgcmF0ZVJlY2VpdmVyRmllbGROYW1lc2AsICAgc2VwYXJhdGVkIGJ5IGBfYC4gV2l0aCBgcmF0ZVJlY2VpdmVyRmllbGROYW1lczogW21lc3NhZ2VfcGF0dGVybl1gIHRoZSBrZXkgaXMganVzdCAgIHRoZSBwYXR0ZXJuIChlLmcuIGBFcnJvcl9zeW5jaW5nX3BvZGApLiBXaXRoIGBbbWVzc2FnZV9wYXR0ZXJuLCBjb250YWluZXJdYCAgIHRoZSBrZXkgaXMgYG1lc3NhZ2VfcGF0dGVybl9jb250YWluZXJgIChlLmcuIGBoZWFydGJlYXRfZGVidWdfZnJvbnRlbmRgKS4gLSBgc2FtcGxlUmF0ZWAsIHByb2JhYmlsaXR5IGluIGBbMCwgMS4wXWAgdGhhdCBhIG1hdGNoaW5nIGV2ZW50IGlzIHJldGFpbmVkLiAgIGAwYCA9IGZ1bGwgbXV0ZTsgYDAuMWAgPSBrZWVwIDEwJTsgYDEuMGAgPSBuby1vcC4gLSBgdW50aWxFcG9jaFNlY2AsIG11dGUgZXhwaXJlcyBhdCB0aGlzIFVuaXggZXBvY2ggKHNlY29uZHMpLiBQYXN0IHRoYXQsIHRoZSAgIGVudHJ5IGJlY29tZXMgYSBuby1vcCB1bnRpbCBzb21lb25lIGVkaXRzIG9yIHJlbW92ZXMgaXQuIFNlbGYtaGVhbGluZyBieSBkZXNpZ24uIC0gYHJlYXNvbmAsIG9wdGlvbmFsIGZyZWUtdGV4dCBzdHJpbmcgZm9yIGF1ZGl0LiBOb3QgdXNlZCBhdCBydW50aW1lLiBNdXN0IG5vdCAgIGNvbnRhaW4gY29tbWFzICh3b3VsZCBicmVhayBDU1YgcGFyc2luZykuICAqKkV4YW1wbGUqKiAod2l0aCBgcmF0ZVJlY2VpdmVyRmllbGROYW1lczogW21lc3NhZ2VfcGF0dGVybl1gKTogIGBgYCBmaWVsZFNldCx2YWx1ZSBFcnJvcl9zeW5jaW5nX3BvZCwwLjEwOjE3NDQ4NDgwMDA6cG9kIGVycm9yIHNwYW0gT1BTLTQ4MjEgaGVhcnRiZWF0X2RlYnVnLDA6MTc0NDQxNjAwMDprOHMgbGl2ZW5lc3MgMjAwcyBqd3RfdmFsaWRhdGVkLDAuMjU6MTc0NDUwMjQwMDphdXRoIGZsb29kIGFmdGVyIGRlcGxveSBgYGAgIFRoZSBmaWxlIGlzIGhvdC1yZWxvYWRlZCBvbiBpbi1wbGFjZSB3cml0ZXMgKHRoZSBnaXRvcHMgcGF0dGVybik7IGEgS3ViZXJuZXRlcyBgQ29uZmlnTWFwYCBtb3VudCB3b24ndCByZWxvYWQgYmVjYXVzZSB0aGUgQ00gc3dhcCBpcyBhIHN5bWxpbmsgcmVuYW1lLCBub3QgYW4gaW4tcGxhY2Ugd3JpdGUuICAqKldoeSB0aGlzIHNoYXBlOioqICAtICoqRmllbGQtc2V0IGtleWVkKiosIG5vdCByZWdleCBrZXllZCDihpIgbXV0ZSBrZXlzIGFyZSB0aGUgZXhhY3QgaWRlbnRpZmllcnMgdGhlICAgUmVwb3J0ZXIgYXR0cmlidXRlcyBjb3N0IHRvIChzYW1lIGByYXRlUmVjZWl2ZXJGaWVsZE5hbWVzYCBvbiBib3RoIHNpZGVzKSwgc28gYSAgIFwidG9wIHNwZW5kZXJcIiBpbiB0aGUgUmVwb3J0ZXIgbWFwcyAxOjEgdG8gYSBtdXRlIGVudHJ5LiAtICoqR2l0LWZyaWVuZGx5Kio6IHRoZSBmaWxlIGlzIGEgaHVtYW4tcmVhZGFibGUgZGVjbGFyYXRpb24gdGhhdCBjYW4gbGl2ZSBpbiBhICAgY29uZmlnIHJlcG8sIHJldmlld2VkIHZpYSBQUiwgYGdpdCBibGFtZWAtZCBmb3Igd2hvL3doeS4gLSAqKlNlbGYtaGVhbGluZyoqOiBldmVyeSBtdXRlIGhhcyBhbiBleHBsaWNpdCBleHBpcnksIHNvIGZvcmdvdHRlbiBlbnRyaWVzICAgZXZlbnR1YWxseSBzdG9wIGZpbHRlcmluZyBpbnN0ZWFkIG9mIHNpbGVudGx5IGRyb3BwaW5nIHByb2R1Y3Rpb24gZGF0YSBmb3JldmVyLiAtICoqQUktZWRpdGFibGUqKjogYW4gb3BlcmF0b3IgY2FuIGFzayBhbiBhc3Npc3RhbnQgKGUuZy4sIENsYXVkZSBDb2RlIHZpYSB0aGUgICBMb2cxMHggTUNQKSB0byBcIm11dGUgYEVycm9yX3N5bmNpbmdfcG9kYCBmb3IgMjQgaG91cnMgYXQgMTAlXCIsIHRoZSBhc3Npc3RhbnQgICByZWFkcyB0aGUgUmVwb3J0ZXIncyBjb3N0IGF0dHJpYnV0aW9uLCBhcHBlbmRzIHRoZSBlbnRyeSwgYW5kIG9wZW5zIGEgUFIgb3IgICBwdXNoZXMgdGhlIGNoYW5nZSwgYXMgdGhlIHJlcG8gaXMgc2V0IHVwLiBUaGUgbXV0ZSBmaWxlIGlzIHRoZSBpbnRlcmZhY2UuICAqKkVycm9yLWNsYXNzIGxpbmVzIHN0aWxsIHBhc3MgYnkgY291bnQuKiogVW5kZXIgYW4gYWN0aXZlIGVudHJ5LCB0aGUgbGV2ZWxzIGluIGByYXRlUmVjZWl2ZXJLZWVwQ291bnRzYCBwYXNzIHRoZWlyIGZpcnN0IGxpbmVzIHBlciBwYXR0ZXJuIHBlciB3aW5kb3cgYmVmb3JlIHRoZSBzYW1wbGUgcmF0ZSBhcHBsaWVzLCBzbyBhIGAwLjBgIG11dGUgbmV2ZXIgc2lsZW5jZXMgRVJST1IvQ1JJVElDQUwvRkFUQUwgdHJhZmZpYy4gICoqTGluZXMgYSBtdXRlIHBhc3NlcyBzdGlsbCBjb3VudC4qKiBJbiBhIGNvbnRhaW5lciB3aXRoIGEgY2FwIGZpbGUgcm93LCB0aGUgbGluZXMgYW4gYWN0aXZlIGVudHJ5IHBhc3NlcyBjb3VudCB0b3dhcmQgdGhlIHNlcnZpY2UncyB0b3RhbCAoYHJhdGVSZWNlaXZlclRvdGFsTG9va3VwRmlsZWApLCBzbyB0aGUgc2VydmljZSdzIG90aGVyIHBhdHRlcm5zIGFyZSBoZWxkIGZpcnN0IG9uY2UgdGhlIHRvdGFsIGlzIHJlYWNoZWQuICBXaGVuIGByYXRlUmVjZWl2ZXJMb29rdXBGaWxlYCBpcyAqKnVuc2V0KiosIHRoZSByZWd1bGF0b3IgcnVucyBhbG9uZSBvbiBldmVyeSBwYXR0ZXJuLiAoRGVmYXVsdDogKSIsCiAgICAgICAgICAgICAgImRlZmF1bHQiIDogIiIKICAgICAgICAgICAgfSwKICAgICAgICAgICAgInJldGFpbiIgOiB7CiAgICAgICAgICAgICAgInR5cGUiIDogWwogICAgICAgICAgICAgICAgIm51bWJlciIsCiAgICAgICAgICAgICAgICAic3RyaW5nIiwKICAgICAgICAgICAgICAgICJudWxsIgogICAgICAgICAgICAgIF0sCiAgICAgICAgICAgICAgIm1hcmtkb3duRGVzY3JpcHRpb24iIDogIlJldGVudGlvbiBwZXJpb2QgZm9yIHRoZSBsb29rdXAgZmlsZSBjb250YWluaW5nIGdsb2JhbCBldmVudCB0eXBlIHJhdGVzXG5cbkRlZmluZXMgdGhlIHJldGVudGlvbiBwZXJpb2QgZm9yIHRoZSBsb29rdXAgZmlsZSBjb250YWluaW5nIGdsb2JhbCBldmVudCB0eXBlIGZyZXF1ZW5jeSBkYXRhLiBJZiB0aGUgZmlsZSdzIGxhc3QgbW9kaWZpZWQgdGltZSBpcyBvbGRlciB0aGFuIHRoaXMgcGVyaW9kLCB0aGUgbG9va3VwIGlzIGNvbnNpZGVyZWQgc3RhbGUsIGFuZCBsb2NhbCBjb3VudGVyIHJhdGVzIGFyZSB1c2VkLiBVc2VkIHRvIG1ha2Ugc2FtcGxpbmcgZGVjaXNpb25zIGJhc2VkIG9uIGNsdXN0ZXItd2lkZSBldmVudCBwYXR0ZXJucy4gICoqVmFsaWRhdGlvbjoqKiBNdXN0IGJlIGdyZWF0ZXIgdGhhbiA2MDAwMCBtaWxsaXNlY29uZHMuIChBY2NlcHRzIG51bWJlciBvciBzdHJpbmcgd2l0aCAkPSBwcmVmaXggZm9yIHJ1bnRpbWUgZXZhbHVhdGlvbikgKERlZmF1bHQ6IDMwMDAwMCkiLAogICAgICAgICAgICAgICJkZWZhdWx0IiA6IDMwMDAwMAogICAgICAgICAgICB9CiAgICAgICAgICB9CiAgICAgICAgfSwKICAgICAgICAiYWN0aW9uTG9va3VwRmlsZSIgOiB7CiAgICAgICAgICAidHlwZSIgOiBbCiAgICAgICAgICAgICJzdHJpbmciLAogICAgICAgICAgICAibnVsbCIKICAgICAgICAgIF0sCiAgICAgICAgICAibWFya2Rvd25EZXNjcmlwdGlvbiIgOiAiRGVjbGFyYXRpdmUgcGVyLXNlcnZpY2UgYWN0aW9uIGZpbGUsIGtleWVkIGJ5IHRoZSBgcmF0ZVJlY2VpdmVyQ29udGFpbmVyRmllbGRgIHZhbHVlOyBkZWNpZGVzIHRoZSBkaXNwb3NpdGlvbiBvZiBlYWNoIHNlcnZpY2UncyByZWd1bGF0b3IgZXhjZXNzXG5cbkRlZmluZXMgdGhlIHBhdGggdG8gYSBkZWNsYXJhdGl2ZSAqKnBlci1zZXJ2aWNlIGFjdGlvbiBmaWxlKiogKHNpYmxpbmcgdG8gdGhlIGNhcCBmaWxlKS4gRWFjaCBlbnRyeSBhc3NpZ25zIHRoZSBkaXNwb3NpdGlvbiBvZiBhIHNlcnZpY2UncyBoZWxkIGxpbmVzOiBgcGFzc2AgKGRlZmF1bHQpLCBgb2ZmbG9hZGAgKHRvIGN1c3RvbWVyIFMzKSwgYHRpZXJfZG93bmAgKGFuYWx5emVyIGNoZWFwIHRpZXIpLCBgY29tcGFjdGAgKGxvc3NsZXNzIGVuY29kZSksIGBzYW1wbGVgLCBvciBgZHJvcGAuIFRoZSBjYXAgKGByYXRlUmVjZWl2ZXJDYXBMb29rdXBGaWxlYCkgYW5kIHRoZSB0b3RhbCAoYHJhdGVSZWNlaXZlclRvdGFsTG9va3VwRmlsZWApIGRlY2lkZSB3aGljaCBsaW5lcyBhcmUgaGVsZDsgdGhlIGFjdGlvbiBvbmx5IGRlY2lkZXMgd2hhdCBoYXBwZW5zIHRvIHRoZW0uIEEgcm93IGtleWVkIGAqYCBhcHBsaWVzIHRvIGV2ZXJ5IHNlcnZpY2Ugd2l0aG91dCBhIHJvdyBvZiBpdHMgb3duOyBhIHNlcnZpY2Ugd2l0aCBuZWl0aGVyIHRha2VzIGByYXRlUmVjZWl2ZXJEZWZhdWx0QWN0aW9uYCAoYHBhc3NgIHVubGVzcyBzZXQpLCBhbmQgYSBjYXAgZmlsZSB3aXRoIG5vIGFjdGlvbnMgZmlsZSBsb2FkcyBhbiBlbXB0eSB0YWJsZS4gUmVhZCBieSB0aGUgY2FwLXZhcmlhbnQgcmVndWxhdG9yIGNsYXNzZXMsIHdoaWNoIGNhbGwgYHJvdXRlKGFjdGlvbilgIGF0IHRoZSBvdmVyLWJ1ZGdldCBkZWNpc2lvbiBwb2ludC4gICoqRmlsZSBmb3JtYXQqKiAoQ1NWOyBoZWFkZXIgcm93ICsgb25lIGNvbW1hLXNlcGFyYXRlZCBlbnRyeSBwZXIgcm93KTogIGBgYCBjb250YWluZXIsYWN0aW9uIDxjb250YWluZXI+LDxhY3Rpb24+Wzo8dW50aWxFcG9jaFNlYz5dWzo8cmVhc29uPl0gKiw8YWN0aW9uPls6PHVudGlsRXBvY2hTZWM+XVs6PHJlYXNvbj5dIGBgYCAgLSBgY29udGFpbmVyYCwgdmFsdWUgb2YgYHJhdGVSZWNlaXZlckNvbnRhaW5lckZpZWxkYCAodGhlIGs4cyBjb250YWluZXIgPSB0aGUgc2VydmljZSksIG9yICAgYCpgIGZvciBldmVyeSBzZXJ2aWNlIHdpdGhvdXQgYSByb3cgb2YgaXRzIG93bi4gLSBgYWN0aW9uYCwgb25lIG9mIGBkcm9wYCAvIGBvZmZsb2FkYCAvIGB0aWVyX2Rvd25gIC8gYGNvbXBhY3RgIC8gYHNhbXBsZWAgLyBgcGFzc2AuIC0gYHVudGlsRXBvY2hTZWNgLCBvcHRpb25hbCBVbml4LWVwb2NoIChzZWNvbmRzKSBleHBpcnk7IHBhc3QgaXQgdGhlIGVudHJ5IGlzIGEgbm8tb3AuIC0gYHJlYXNvbmAsIG9wdGlvbmFsIGZyZWUtdGV4dCBmb3IgYXVkaXQuIE11c3Qgbm90IGNvbnRhaW4gY29tbWFzICh3b3VsZCBicmVhayBDU1YgcGFyc2luZykuICBJbnRlbmRlZCB0byBiZSBtYW5hZ2VkIHZpYSBHaXRPcHMgKyB0aGUgYGxvZzEweF9jb25maWd1cmVfZW5naW5lYCBNQ1AgdG9vbCwgd2hpY2ggZGVyaXZlcyBwZXItc2VydmljZSBhY3Rpb25zIGZyb20gdGhlIHBlci1wYXR0ZXJuIGFjdGlvbiBwbGFuIGl0IGFscmVhZHkgY29tcHV0ZXMuICAqKkZyb20gYSBwb2xpY3kgcmVwby4qKiBXaXRoIGBHSF9FTkFCTEVEPXRydWVgLCB0aGUgZGVmYXVsdCBpcyB0aGUgR2l0SHViIHBvbGljeSBsYW5lJ3MgbWlycm9yZWQgY29weSBvZiB0aGUgcmVwbydzIGBsb2cxMHgvcG9saWN5L2FjdGlvbnMuY3N2YDogYCR7R0hfREVTVH0vbG9nMTB4L3BvbGljeS9hY3Rpb25zLmNzdmAsIHdpdGggYEdIX0RFU1RgIGRlZmF1bHRpbmcgdG8gYCR7amF2YS5pby50bXBkaXJ9L3RlbngvZ2l0aHViYCAoYHBpcGVsaW5lcy9naXRvcHMvY29uZmlnLnlhbWxgKS4gRWFjaCBzeW5jIHJld3JpdGVzIHRoZSBjb3B5IGluIHBsYWNlLCBzbyB0aGUgbG9va3VwIGhvdC1yZWxvYWRzLiBgR0hfRU5BQkxFRGAgdHVybnMgb24gd2l0aCBgdHJ1ZWAsIGBUcnVlYCBvciBgVFJVRWAsIGFzIHRoZSBsYW5lIHJlYWRzIGl0LCBhbmQgd2l0aCB0aGUgS3ViZXJuZXRlcyBDb25maWdNYXAgbGFuZSBhbHNvIG9uIHRoZSBHaXRIdWIgY29weSB3aW5zOiBlbmFibGUgb25lIGxhbmUuIgogICAgICAgIH0sCiAgICAgICAgImRlZmF1bHRBY3Rpb24iIDogewogICAgICAgICAgInR5cGUiIDogWwogICAgICAgICAgICAic3RyaW5nIiwKICAgICAgICAgICAgIm51bGwiCiAgICAgICAgICBdLAogICAgICAgICAgIm1hcmtkb3duRGVzY3JpcHRpb24iIDogIlRoZSBhY3Rpb24gYSBjb250YWluZXIgd2l0aCBubyBgcmF0ZVJlY2VpdmVyQWN0aW9uTG9va3VwRmlsZWAgcm93IHRha2VzIGZvciBpdHMgb3Zlci1jYXAgZXhjZXNzXG5cbkRlZmluZXMgd2hhdCB0aGUgaGVsZCBsaW5lcyBvZiBhIGNvbnRhaW5lciB3aXRoIG5laXRoZXIgaXRzIG93biByb3cgbm9yIGEgYCpgIHJvdyBpbiBgcmF0ZVJlY2VpdmVyQWN0aW9uTG9va3VwRmlsZWAgZG86IG9uZSBvZiBgcGFzc2AsIGBvZmZsb2FkYCwgYHRpZXJfZG93bmAsIGBjb21wYWN0YCwgYHNhbXBsZWAgb3IgYGRyb3BgLiBgcGFzc2AgbGVhdmVzIHRoZW0gd2hlcmUgdGhleSB3ZXJlLCBzbyBvbmx5IHRoZSBjb250YWluZXJzIHRoZSBhY3Rpb25zIGZpbGUgY292ZXJzIGFjdCBvbiB0aGVpcnMuIEFuIGV4cGxpY2l0IHJvdywgYW5kIHRoZW4gdGhlIGAqYCByb3csIHN0aWxsIHdpbi4gIFNldCBpdCBiZXNpZGUgYHJhdGVSZWNlaXZlckFic29sdXRlQ2FwYCBzbyB0aGUgZmxlZXQtd2lkZSBjYXAgYWN0cyBvbiBzZXJ2aWNlcyBub2JvZHkgbGlzdGVkLiBSZWFkIGJ5IHRoZSBjYXAtZmlsZSByZWd1bGF0b3IgY2xhc3NlcywgdGhlIG9uZXMgdGhhdCBjb25zdWx0IHRoZSBhY3Rpb25zIGZpbGUuIEEgdmFsdWUgb3V0c2lkZSB0aGUgc2l4IGxvZ3MgYSB3YXJuaW5nIGF0IGxvYWQgYW5kIHRoZSByZWd1bGF0b3IgdXNlcyBgcGFzc2AuIChEZWZhdWx0OiBwYXNzKSIsCiAgICAgICAgICAiZGVmYXVsdCIgOiAicGFzcyIKICAgICAgICB9LAogICAgICAgICJjYXBMb29rdXAiIDogewogICAgICAgICAgInR5cGUiIDogIm9iamVjdCIsCiAgICAgICAgICAiYWRkaXRpb25hbFByb3BlcnRpZXMiIDogZmFsc2UsCiAgICAgICAgICAicHJvcGVydGllcyIgOiB7CiAgICAgICAgICAgICJmaWxlIiA6IHsKICAgICAgICAgICAgICAidHlwZSIgOiBbCiAgICAgICAgICAgICAgICAic3RyaW5nIiwKICAgICAgICAgICAgICAgICJudWxsIgogICAgICAgICAgICAgIF0sCiAgICAgICAgICAgICAgIm1hcmtkb3duRGVzY3JpcHRpb24iIDogIkRlY2xhcmF0aXZlIHBlci1jb250YWluZXIgY2FwIGZpbGUsIGtleWVkIGJ5IHRoZSBgcmF0ZVJlY2VpdmVyQ29udGFpbmVyRmllbGRgIHZhbHVlXG5cbkRlZmluZXMgdGhlIHBhdGggdG8gYSBkZWNsYXJhdGl2ZSAqKnBlci1jb250YWluZXIgY2FwIGZpbGUqKi4gRWFjaCBlbnRyeSBhc3NpZ25zIGEgY2FwLCBpbiBgcmF0ZVJlY2VpdmVyVW5pdGAsIHRvIGEgc3BlY2lmaWMgY29udGFpbmVyICh0aGUgdmFsdWUgb2YgYHJhdGVSZWNlaXZlckNvbnRhaW5lckZpZWxkYCwgd2hpY2ggZGVmYXVsdHMgdG8gdGhlIGs4cyBjb250YWluZXIgbmFtZSkuIFRoZSBmaWxlJ3MgY2FwIHdpbnMgcGVyLWV2ZW50IG92ZXIgYHJhdGVSZWNlaXZlckFic29sdXRlQ2FwYDogYSBsaXN0ZWQgY29udGFpbmVyIGdldHMgaXRzIG93biByb3csIGFuIHVubGlzdGVkIG9uZSBnZXRzIHRoZSByb3cga2V5ZWQgYCpgLCBhbmQgYSBjb250YWluZXIgd2l0aCBuZWl0aGVyIGZhbGxzIGJhY2sgdG8gdGhlIGZsZWV0LXdpZGUgY2FwIChvciB0byBubyBjYXAsIGlmIGByYXRlUmVjZWl2ZXJBYnNvbHV0ZUNhcGAgaXMgYDBgKS4gICoqRmlsZSBmb3JtYXQqKiAoQ1NWOyBoZWFkZXIgcm93ICsgb25lIGNvbW1hLXNlcGFyYXRlZCBlbnRyeSBwZXIgcm93KTogIGBgYCBjb250YWluZXIsY2FwIDxjb250YWluZXI+LDxjYXA+Wzo8dW50aWxFcG9jaFNlYz5dWzo8cmVhc29uPl0gKiw8Y2FwPls6PHVudGlsRXBvY2hTZWM+XVs6PHJlYXNvbj5dIGBgYCAgLSBgY29udGFpbmVyYCwgdmFsdWUgb2YgYHJhdGVSZWNlaXZlckNvbnRhaW5lckZpZWxkYCBmb3IgdGhlIGV2ZW50cyB0byBjYXAuIEluIGs4cyB0aGlzIGlzICAgdGhlIGs4cyBjb250YWluZXIgbmFtZSwgc3RhYmxlIGFjcm9zcyBwb2QgcmVwbGljYXMuIGAqYCBjYXBzIGV2ZXJ5IGNvbnRhaW5lciB3aXRob3V0IGEgICByb3cgb2YgaXRzIG93bi4gLSBgY2FwYCwgdGhlIGNhcCBwZXIgcGF0dGVybiBwZXIgY29udGFpbmVyIHBlciB3aW5kb3csIGluIGByYXRlUmVjZWl2ZXJVbml0YC4gYDBgIGV4ZW1wdHMgICB0aGUgY29udGFpbmVyIGZyb20gZXZlcnkgY2FwLCB0aGUgYCpgIHJvdyBhbmQgYHJhdGVSZWNlaXZlckFic29sdXRlQ2FwYCBpbmNsdWRlZCAodGhlICAgb3Zlci1jYXAgYnJhbmNoIGlzIHNraXBwZWQgZm9yIGl0KS4gQSBgKmAgcm93IG9mIGAwYCBleGVtcHRzIGV2ZXJ5IGNvbnRhaW5lciB3aXRob3V0IGEgICByb3cgb2YgaXRzIG93biwgc28gYHJhdGVSZWNlaXZlckFic29sdXRlQ2FwYCB0aGVuIGFwcGxpZXMgdG8gbm9uZSBvZiB0aGVtLiAtIGB1bnRpbEVwb2NoU2VjYCwgb3B0aW9uYWwgVW5peC1lcG9jaCAoc2Vjb25kcykgZXhwaXJ5LiBQYXN0IHRoYXQsIHRoZSBlbnRyeSBiZWNvbWVzIGEgICBuby1vcCBhbmQgdGhlIGZhbGxiYWNrIGNhcCBhcHBsaWVzLiAtIGByZWFzb25gLCBvcHRpb25hbCBmcmVlLXRleHQgc3RyaW5nIGZvciBhdWRpdC4gTm90IHVzZWQgYXQgcnVudGltZS4gTXVzdCBub3QgY29udGFpbiAgIGNvbW1hcyAod291bGQgYnJlYWsgQ1NWIHBhcnNpbmcpLiAgKipFeGFtcGxlKio6ICBgYGAgY29udGFpbmVyLGNhcCBwYXltZW50LXNlcnZpY2UsNDE5NDMwNDoxNzM1Njg5NjAwOmFubnVhbCBidWRnZXQgcHJvdGVjdGlvbiBQQVktMTAxIGF1dGgtc2VydmljZSwyMDk3MTUyIGlzdGlvLXByb3h5LDA6MTczNTY4OTYwMDpleGVtcHQgcGxhdGZvcm0gc2lkZWNhciBQTEFULTQyIGBgYCAgKipXaHkgdGhpcyBzaGFwZSoqOiAgLSAqKkNvbnRhaW5lci1rZXllZCoqLCBtYXRjaGluZyB0aGUgcmVndWxhdG9yJ3MgY29udGFpbmVyIGF4aXMuIFRoZSBmaWxlJ3Mga2V5IGlzIHRoZSBzYW1lICAgdmFsdWUgdGhlIHJlZ3VsYXRvcidzIGNvdW50ZXJzIGFyZSBidWNrZXRlZCBieSwgc28gbGlzdGVkIGNhcHMgbWFwIDE6MSB0byBjb3VudGVycyB3aXRob3V0ICAgdHJhbnNsYXRpb24uIC0gKipHaXQtZnJpZW5kbHkqKjogYSBodW1hbi1yZWFkYWJsZSBkZWNsYXJhdGlvbiB0aGF0IGxpdmVzIGluIGEgY29uZmlnIHJlcG8sIHJldmlld2VkIHZpYSAgIFBSLCBgZ2l0IGJsYW1lYC1kIGZvciB3aG8vd2h5LiAtICoqU2VsZi1oZWFsaW5nKio6IGV2ZXJ5IGVudHJ5IGNhbiBjYXJyeSBhbiBleHBsaWNpdCBleHBpcnksIHNvIGZvcmdvdHRlbiBjYXBzIGV2ZW50dWFsbHkgICBzdG9wIGZpbHRlcmluZyBpbnN0ZWFkIG9mIHNpbGVudGx5IGRyb3BwaW5nIHByb2R1Y3Rpb24gZGF0YSBmb3JldmVyLiAtICoqQUktZWRpdGFibGUqKjogdGhlIExvZzEweCBNQ1Agd3JpdGVzIGl0LiBJdHMgYnVkZ2V0IHJ1biAoYGxvZzEweF9zZXR1cF9yZWN1cnJpbmdgKSAgIHdyaXRlcyB0aGUgZmlsZSB0byB0aGUgcG9saWN5IENvbmZpZ01hcCBvciBjb21taXRzIGl0IHRvIHRoZSBwb2xpY3kgYnJhbmNoLiBBICAgYGxvZzEweF9jb25maWd1cmVfZW5naW5lYCBjYWxsIGRlcml2ZXMgY2FwcyBmcm9tIGEgdGFyZ2V0IHBlcmNlbnQgb3IgYSBtb250aGx5IGRvbGxhciAgIGJ1ZGdldCBhbmQgZGVsaXZlcnMgdGhlbSBhcyBpdHMgYGRlbGl2ZXJ5YCBzYXlzOiBhIFBSIGFnYWluc3QgdGhlIGdpdG9wcyByZXBvLCBhIHdyaXRlICAgdG8gdGhlIHBvbGljeSBDb25maWdNYXAsIG9yIG5vIHdyaXRlIChgc3Rkb3V0X29ubHlgKS4gVGhlIGNhcCBmaWxlIGlzIHRoZSBpbnRlcmZhY2UuICAqKkVycm9yLWNsYXNzIGxpbmVzIHN0aWxsIHBhc3MgYnkgY291bnQuKiogUGFzdCB0aGUgY2FwLCB0aGUgbGV2ZWxzIGluIGByYXRlUmVjZWl2ZXJLZWVwQ291bnRzYCBwYXNzIHRoYXQgbWFueSBsaW5lcyBwZXIgcGF0dGVybiBwZXIgd2luZG93LCBzbyBhIHRpZ2h0IGNhcCBuZXZlciBmdWxseSBzaWxlbmNlcyBFUlJPUi9DUklUSUNBTCB0cmFmZmljLiAgV2hlbiBgcmF0ZVJlY2VpdmVyQ2FwTG9va3VwRmlsZWAgaXMgKip1bnNldCoqLCBldmVyeSBjb250YWluZXIgZmFsbHMgYmFjayB0byBgcmF0ZVJlY2VpdmVyQWJzb2x1dGVDYXBgICh3aGljaCBpdHNlbGYgZGVmYXVsdHMgdG8gYDBgID0gZGlzYWJsZWQpLiAgKipGcm9tIGEgcG9saWN5IHJlcG8uKiogV2l0aCBgR0hfRU5BQkxFRD10cnVlYCwgdGhlIGRlZmF1bHQgaXMgdGhlIEdpdEh1YiBwb2xpY3kgbGFuZSdzIG1pcnJvcmVkIGNvcHkgb2YgdGhlIHJlcG8ncyBgbG9nMTB4L3BvbGljeS9jYXBzLmNzdmA6IGAke0dIX0RFU1R9L2xvZzEweC9wb2xpY3kvY2Fwcy5jc3ZgLCB3aXRoIGBHSF9ERVNUYCBkZWZhdWx0aW5nIHRvIGAke2phdmEuaW8udG1wZGlyfS90ZW54L2dpdGh1YmAgKGBwaXBlbGluZXMvZ2l0b3BzL2NvbmZpZy55YW1sYCkuIEVhY2ggc3luYyByZXdyaXRlcyB0aGUgY29weSBpbiBwbGFjZSwgc28gdGhlIGxvb2t1cCBob3QtcmVsb2Fkcy4gYEdIX0VOQUJMRURgIHR1cm5zIG9uIHdpdGggYHRydWVgLCBgVHJ1ZWAgb3IgYFRSVUVgLCBhcyB0aGUgbGFuZSByZWFkcyBpdCwgYW5kIHdpdGggdGhlIEt1YmVybmV0ZXMgQ29uZmlnTWFwIGxhbmUgYWxzbyBvbiB0aGUgR2l0SHViIGNvcHkgd2luczogZW5hYmxlIG9uZSBsYW5lLiBUaGUgcG9saWN5IGZvbGRlciBtdXN0IGhvbGQgYGNhcHMuY3N2YCB3aGVuIHRoZSBlbmdpbmUgc3RhcnRzLiAgVGhlIGZpbGUgaXMgaG90LXJlbG9hZGVkIG9uIGluLXBsYWNlIHdyaXRlcyAodGhlIGdpdG9wcyBwYXR0ZXJuKTsgYSBLdWJlcm5ldGVzIGBDb25maWdNYXBgIG1vdW50IHdvbid0IHJlbG9hZCBiZWNhdXNlIHRoZSBDTSBzd2FwIGlzIGEgc3ltbGluayByZW5hbWUsIG5vdCBhbiBpbi1wbGFjZSB3cml0ZS4gKERlZmF1bHQ6ICkiLAogICAgICAgICAgICAgICJkZWZhdWx0IiA6ICIiCiAgICAgICAgICAgIH0sCiAgICAgICAgICAgICJyZXRhaW4iIDogewogICAgICAgICAgICAgICJ0eXBlIiA6IFsKICAgICAgICAgICAgICAgICJudW1iZXIiLAogICAgICAgICAgICAgICAgInN0cmluZyIsCiAgICAgICAgICAgICAgICAibnVsbCIKICAgICAgICAgICAgICBdLAogICAgICAgICAgICAgICJtYXJrZG93bkRlc2NyaXB0aW9uIiA6ICJSZXRlbnRpb24gcGVyaW9kIGZvciB0aGUgcGVyLWNvbnRhaW5lciBjYXAgZmlsZSBiZWZvcmUgaXQgaXMgY29uc2lkZXJlZCBzdGFsZVxuXG5EZWZpbmVzIHRoZSByZXRlbnRpb24gcGVyaW9kIChpbiBtaWxsaXNlY29uZHMpIGZvciB0aGUgY2FwIGZpbGUgKGByYXRlUmVjZWl2ZXJDYXBMb29rdXBGaWxlYCkuIElmIHRoZSBmaWxlJ3MgbGFzdCBtb2RpZmllZCB0aW1lIGlzIG9sZGVyIHRoYW4gdGhpcyBwZXJpb2QsIGEgd2FybmluZyBpcyBsb2dnZWQuIFRoZSBjYXAgZW50cmllcyBjb250aW51ZSB0byBhcHBseTsgdGhlIHN0YWxlbmVzcyBjaGVjayBpcyBhZHZpc29yeSBzbyBvcGVyYXRvcnMgbm90aWNlIHdoZW4gYW4gYXV0b21hdGVkIHRvb2xpbmcgcGlwZWxpbmUgaGFzIHN0b3BwZWQgdXBkYXRpbmcgdGhlIGZpbGUuICAqKlZhbGlkYXRpb246KiogTXVzdCBiZSBncmVhdGVyIHRoYW4gNjAwMDAgbWlsbGlzZWNvbmRzLiAoQWNjZXB0cyBudW1iZXIgb3Igc3RyaW5nIHdpdGggJD0gcHJlZml4IGZvciBydW50aW1lIGV2YWx1YXRpb24pIChEZWZhdWx0OiAzMDAwMDApIiwKICAgICAgICAgICAgICAiZGVmYXVsdCIgOiAzMDAwMDAKICAgICAgICAgICAgfQogICAgICAgICAgfQogICAgICAgIH0sCiAgICAgICAgInRvdGFsTG9va3VwRmlsZSIgOiB7CiAgICAgICAgICAidHlwZSIgOiBbCiAgICAgICAgICAgICJzdHJpbmciLAogICAgICAgICAgICAibnVsbCIKICAgICAgICAgIF0sCiAgICAgICAgICAibWFya2Rvd25EZXNjcmlwdGlvbiIgOiAiRGVjbGFyYXRpdmUgcGVyLXNlcnZpY2UgdG90YWwgZmlsZSwga2V5ZWQgYnkgdGhlIGByYXRlUmVjZWl2ZXJDb250YWluZXJGaWVsZGAgdmFsdWU7IGJvdW5kcyB3aGF0IGVhY2ggY2FwcGVkIHNlcnZpY2UgcGFzc2VzIHBlciB3aW5kb3dcblxuRGVmaW5lcyB0aGUgcGF0aCB0byBhIGRlY2xhcmF0aXZlICoqcGVyLXNlcnZpY2UgdG90YWwgZmlsZSoqIChzaWJsaW5nIHRvIHRoZSBjYXAgZmlsZSkuIEVhY2ggZW50cnkgYm91bmRzIHdoYXQgYSBzZXJ2aWNlIHBhc3NlcyBwZXIgd2luZG93IChgcmF0ZVJlY2VpdmVyUmVzZXRJbnRlcnZhbE1zYCkgb24gdGhpcyByZWd1bGF0b3IgaW5zdGFuY2UsIGluIGByYXRlUmVjZWl2ZXJVbml0YC4gUmVhZCBieSB0aGUgY2FwLWZpbGUgcmVndWxhdG9yIGNsYXNzZXMsIGZvciBjb250YWluZXJzIHdpdGggYSByZXNvbHZlZCBjYXAuICBUd28gcnVsZXMgYXBwbHkgb25jZSBhIHNlcnZpY2UgaGFzIGEgdG90YWw6ICAtICoqTGFyZ2VzdCBmaXJzdC4qKiBXaGVuIHRoZSBzZXJ2aWNlJ3MgY2FwcyBhbG9uZSBsZXQgbW9yZSB0aGFuIGl0cyB0b3RhbCB0aHJvdWdoIGluIHRoZSAgIHByZXZpb3VzIHdpbmRvdywgZXZlcnkgcGF0dGVybidzIGNhcCBzY2FsZXMgYnkgdG90YWwgLyB0aGF0IGFtb3VudCBmb3IgdGhlIHdob2xlIHdpbmRvdywgICBvciBieSB3aGF0IHRoZXkgbGV0IHRocm91Z2ggc28gZmFyIHRoaXMgd2luZG93IG9uY2UgdGhhdCBpcyBsYXJnZXIsIHNvIHRoZSBzZXJ2aWNlJ3MgICBsYXJnZXN0IHBhdHRlcm5zIGFyZSBoZWxkIGZpcnN0IGFuZCBpdHMgc21hbGwgb25lcyBrZWVwIHBhc3NpbmcuIFRoZSBzY2FsZSBmb2xsb3dzIHRoZSAgIHByZXZpb3VzIHdpbmRvdywgc28gdGhlIHdpbmRvdyBhZnRlciBhIHN0b3JtIGlzIHNjYWxlZCBieSB0aGUgc3Rvcm0gZm9yIGl0cyB3aG9sZSBsZW5ndGggICBhbmQgcmVjb3ZlcnMgdGhlIHdpbmRvdyBhZnRlci4gVGhlIGZpcnN0IHdpbmRvdyBhZnRlciBhIHF1aWV0IG9uZSBmaWxscyBpdHMgdG90YWwgaW4gICBhcnJpdmFsIG9yZGVyIGJlZm9yZSB0aGUgc2NhbGUgYXBwbGllcy4gQSBzZXJ2aWNlIHdob3NlIGZpcnN0IGxpbmVzIG9mIHRoaXMgd2luZG93IGFuZCAgIG9mIHRoZSBsYXN0IHdpbmRvdyBpdCBzZW50IGluIGFyZSB0d28gd2luZG93IGxlbmd0aHMgb3IgbW9yZSBhcGFydCBzY2FsZXMgYnkgdG90YWwgLyBpdHMgICB1bml0cyBzbyBmYXIgdGhpcyB3aW5kb3cgaW5zdGVhZC4gLSAqKkhhcmQgYm91bmQuKiogT25jZSB0aGUgbGluZXMgdGhlIHNlcnZpY2UgcGFzc2VkIHJlYWNoIGl0cyB0b3RhbCwgZXZlcnkgZnVydGhlciBsaW5lIHRha2VzICAgdGhlIHNlcnZpY2UncyBhY3Rpb24gKGByYXRlUmVjZWl2ZXJBY3Rpb25Mb29rdXBGaWxlYCkuICBUaGUgYHJhdGVSZWNlaXZlckJhc2VsaW5lQ291bnRgIHNhbXBsZSBjb3VudHMgdG93YXJkIHRoZSB0b3RhbCBsaWtlIGFueSBsaW5lLCBhbmQgb25jZSB0aGUgdG90YWwgaXMgc3BlbnQgdGhlIHNlcnZpY2UgcGFzc2VzIGF0IG1vc3QgYHJhdGVSZWNlaXZlckJhc2VsaW5lTWF4T3ZlclRvdGFsYCBtb3JlIHNhbXBsZSBsaW5lcyBpbiB0aGUgd2luZG93LiBUaGUgYHJhdGVSZWNlaXZlcktlZXBDb3VudHNgIGxpbmVzIGNvdW50IHRvd2FyZCB0aGUgdG90YWwgdGhlIHNhbWUgd2F5LCBhbmQgb25jZSBpdCBpcyBzcGVudCB0aGUgc2VydmljZSBwYXNzZXMgYXQgbW9zdCBgcmF0ZVJlY2VpdmVyS2VlcE1heE92ZXJUb3RhbGAgbW9yZSBvZiB0aGVtIGluIHRoZSB3aW5kb3cuIFRoZSBsaW5lcyBhbiBhY3RpdmUgbXV0ZSBlbnRyeSBwYXNzZXMgYWx3YXlzIHBhc3MgYW5kIGNvdW50IHRvd2FyZCB0aGUgdG90YWwsIHNvIGEgbXV0ZWQgcGF0dGVybiBjYW4gZXhjZWVkIGl0IGJ5IHRoYXQgbXVjaC4gICoqRmlsZSBmb3JtYXQqKiAoQ1NWOyBoZWFkZXIgcm93ICsgb25lIGNvbW1hLXNlcGFyYXRlZCBlbnRyeSBwZXIgcm93KTogIGBgYCBjb250YWluZXIsdG90YWwgPGNvbnRhaW5lcj4sPHRvdGFsPls6PHVudGlsRXBvY2hTZWM+XVs6PHJlYXNvbj5dICosPHRvdGFsPls6PHVudGlsRXBvY2hTZWM+XVs6PHJlYXNvbj5dIGBgYCAgLSBgY29udGFpbmVyYCwgdmFsdWUgb2YgYHJhdGVSZWNlaXZlckNvbnRhaW5lckZpZWxkYCAodGhlIGs4cyBjb250YWluZXIgPSB0aGUgc2VydmljZSksIG9yICAgYCpgIGZvciBldmVyeSBzZXJ2aWNlIHdpdGhvdXQgYSByb3cgb2YgaXRzIG93bi4gLSBgdG90YWxgLCB0aGUgc2VydmljZSdzIHRvdGFsIHBlciB3aW5kb3cgb24gdGhpcyBpbnN0YW5jZSwgaW4gYHJhdGVSZWNlaXZlclVuaXRgLiBgMGAgICBleGVtcHRzIHRoZSBzZXJ2aWNlOyBhIGAqYCByb3cgb2YgYDBgIGdpdmVzIGV2ZXJ5IHNlcnZpY2Ugd2l0aG91dCBhIHJvdyBvZiBpdHMgb3duIG5vICAgdG90YWwuIC0gYHVudGlsRXBvY2hTZWNgLCBvcHRpb25hbCBVbml4LWVwb2NoIChzZWNvbmRzKSBleHBpcnk7IHBhc3QgaXQgdGhlIGVudHJ5IGlzIGEgbm8tb3AuIC0gYHJlYXNvbmAsIG9wdGlvbmFsIGZyZWUtdGV4dCBmb3IgYXVkaXQuIE11c3Qgbm90IGNvbnRhaW4gY29tbWFzICh3b3VsZCBicmVhayBDU1YgcGFyc2luZykuICBBIG1pc3NpbmcgZmlsZSBsb2FkcyBhcyBhbiBlbXB0eSB0YWJsZSwgc28gbm8gc2VydmljZSBoYXMgYSB0b3RhbCB1bnRpbCBhIHJvdyBuYW1lcyBpdC4gRWFjaCByZWd1bGF0b3IgaW5zdGFuY2UgaG9sZHMgaXRzIG93biB0b3RhbDsgdGhlIE1DUCdzIGJ1ZGdldCBydW4gKGBsb2cxMHhfc2V0dXBfcmVjdXJyaW5nYCkgZGl2aWRlcyBhIGZsZWV0IHRvdGFsIGFjcm9zcyBpbnN0YW5jZXMuICAqKkZyb20gYSBwb2xpY3kgcmVwby4qKiBXaXRoIGBHSF9FTkFCTEVEPXRydWVgLCB0aGUgZGVmYXVsdCBpcyB0aGUgR2l0SHViIHBvbGljeSBsYW5lJ3MgbWlycm9yZWQgY29weSBvZiB0aGUgcmVwbydzIGBsb2cxMHgvcG9saWN5L3RvdGFscy5jc3ZgOiBgJHtHSF9ERVNUfS9sb2cxMHgvcG9saWN5L3RvdGFscy5jc3ZgLCB3aXRoIGBHSF9ERVNUYCBkZWZhdWx0aW5nIHRvIGAke2phdmEuaW8udG1wZGlyfS90ZW54L2dpdGh1YmAgKGBwaXBlbGluZXMvZ2l0b3BzL2NvbmZpZy55YW1sYCkuIEVhY2ggc3luYyByZXdyaXRlcyB0aGUgY29weSBpbiBwbGFjZSwgc28gdGhlIGxvb2t1cCBob3QtcmVsb2Fkcy4gYEdIX0VOQUJMRURgIHR1cm5zIG9uIHdpdGggYHRydWVgLCBgVHJ1ZWAgb3IgYFRSVUVgLCBhcyB0aGUgbGFuZSByZWFkcyBpdCwgYW5kIHdpdGggdGhlIEt1YmVybmV0ZXMgQ29uZmlnTWFwIGxhbmUgYWxzbyBvbiB0aGUgR2l0SHViIGNvcHkgd2luczogZW5hYmxlIG9uZSBsYW5lLiAoRGVmYXVsdDogKSIsCiAgICAgICAgICAiZGVmYXVsdCIgOiAiIgogICAgICAgIH0sCiAgICAgICAgImNvbmZpZ0dlbmVyYXRpb25GaWxlIiA6IHsKICAgICAgICAgICJ0eXBlIiA6IFsKICAgICAgICAgICAgInN0cmluZyIsCiAgICAgICAgICAgICJudWxsIgogICAgICAgICAgXSwKICAgICAgICAgICJtYXJrZG93bkRlc2NyaXB0aW9uIiA6ICJPcHRpb25hbCBjb25maWctZ2VuZXJhdGlvbiBmaWxlIHdob3NlIGBnZW5lcmF0aW9uYCB2YWx1ZSBpcyBzdGFtcGVkIGFzIHRoZSBgdGVueF9jb25maWdfdmVyc2lvbmAgbWV0cmljIGxhYmVsXG5cbkRlZmluZXMgdGhlIHBhdGggdG8gdGhlICoqY29uZmlnLWdlbmVyYXRpb24gZmlsZSoqIHRoZSBNQ1AgY29udHJvbCBwbGFuZSAoYGxvZzEweF9jb25maWd1cmVfZW5naW5lYCkgd3JpdGVzIGFzIGEgU0lCTElORyBvZiB0aGUgY2FwIGZpbGUgaW4gdGhlIGNhcCBDb25maWdNYXAuIEl0IGlzIGEgdHdvLWNvbHVtbiBDU1YgKGBrZXksdmFsdWVgKSB3aXRoIG9uZSByb3csIGBnZW5lcmF0aW9uLDxoYXNoLW9mLWNhcHM+YCwgd2hlcmUgdGhlIGdlbmVyYXRpb24gaXMgYSBkZXRlcm1pbmlzdGljIGhhc2ggb2YgdGhlIGNhcCBwb2xpY3kuIFRoZSByZWNlaXZlcidzIGNvbmZpZy1nZW5lcmF0aW9uIG9iamVjdCByZWFkcyB0aGF0IHZhbHVlIGFuZCBzdGFtcHMgaXQgb24gZXZlcnkgZXZlbnQgYXMgYHRlbnhfY29uZmlnX3ZlcnNpb25gIChkZWNsYXJlZCBpbiB0aGlzIG1vZHVsZSdzIGBtZXRyaWNUYWdGaWVsZHNgKTsgdGhlIHJlY2VpdmVyJ3MgYGNvbmZpZ19nZW5lcmF0aW9uYCBhZ2dyZWdhdG9yIHB1Ymxpc2hlcyBpdCBhcyBvbmUgc2VyaWVzIHBlciBnZW5lcmF0aW9uLCBzbyB0aGUgcnVubmluZyBlbmdpbmUgYWR2ZXJ0aXNlcyB3aGljaCBjb25maWcgZ2VuZXJhdGlvbiBpdCBsb2FkZWQsIGFuZCB0aGUgcGVyLXBhdHRlcm4gY291bnRlcnMgZG8gbm90IGNhcnJ5IGl0LiBUaGUgTUNQIHRoZW4gdmVyaWZpZXMgdGhlIHBvbGljeSBpdCB3cm90ZSBpcyBhY3R1YWxseSBsaXZlIGJ5IGNvbXBhcmluZyB0aGUgbGFiZWwgdG8gYGhhc2goY3VycmVudCBjYXBzKWAsIHRoZSBjb25maWctZ2VuZXJhdGlvbiBjbG9zZWQgbG9vcC4gICoqT3B0LWluLCBhbmQgZGVjb3VwbGVkIGZyb20gY2Fwcy4qKiBVbnNldCBieSBkZWZhdWx0IChgXCJcImApOyB0aGUgYHRlbnhfY29uZmlnX3ZlcnNpb25gIHN0YW1wIGlzIGVtaXR0ZWQgb25seSB3aGVuIHRoaXMgcG9pbnRzIGF0IGEgZmlsZS4gQSByZWNlaXZlciBydW5uaW5nIHRoZSByYXRlIHJlZ3VsYXRvciBXSVRIT1VUIHRoZSBNQ1AgY2xvc2VkIGxvb3AgKGUuZy4gR2l0T3BzLW1hbmFnZWQgY2FwcykgbGVhdmVzIGl0IHVuc2V0IGFuZCBlbWl0cyBubyBgdGVueF9jb25maWdfdmVyc2lvbmAgbGFiZWwuIEl0IG5ldmVyIGRlcGVuZHMgb24gdGhlIGZpbGUgZXhpc3RpbmcsIHNvIGl0IGNhbid0IGZhaWwgaW5pdCBvbiBhIG1pc3NpbmcgZmlsZS4gU2V0IGl0IG9ubHkgd2hlcmUgdGhlIE1DUCB3cml0ZXMgdGhlIGZpbGUgKHZpYSB0aGUgYENPTkZJR19HRU5FUkFUSU9OX0ZJTEVgIGVudiBvciBgY29uZmlnR2VuZXJhdGlvbi5maWxlYCBpbiBjb25maWcueWFtbCkuICAqKkZpbGUgZm9ybWF0KiogKENTVjsgaGVhZGVyIHJvdyArIG9uZSByb3cpOiAgYGBgIGtleSx2YWx1ZSBnZW5lcmF0aW9uLDwxMi1jaGFyIGhhc2ggb2YgY2Fwcy5jc3Y+IGBgYCAgSG90LXJlbG9hZGVkIGxpa2UgdGhlIGNhcCBmaWxlLCBzbyBhIG5ldyBnZW5lcmF0aW9uIHdyaXR0ZW4gYnkgYGNvbmZpZ3VyZV9lbmdpbmVgIGdvZXMgbGl2ZSB3aXRob3V0IGFuIGVuZ2luZSByZXN0YXJ0LiBUaGlzIGlzIGV4YWN0bHkgd2hhdCB0aGUgdmVyaWZpZXIgb2JzZXJ2ZXMgYXMgdGhlIHN0YWxlIC0+IGxpdmUgdHJhbnNpdGlvbi4gICoqRnJvbSBhIHBvbGljeSByZXBvLioqIFdpdGggYEdIX0VOQUJMRUQ9dHJ1ZWAsIHRoZSBkZWZhdWx0IGlzIHRoZSBHaXRIdWIgcG9saWN5IGxhbmUncyBtaXJyb3JlZCBjb3B5IG9mIHRoZSByZXBvJ3MgYGxvZzEweC9wb2xpY3kvY29uZmlnLWdlbmVyYXRpb24uY3N2YDogYCR7R0hfREVTVH0vbG9nMTB4L3BvbGljeS9jb25maWctZ2VuZXJhdGlvbi5jc3ZgLCB3aXRoIGBHSF9ERVNUYCBkZWZhdWx0aW5nIHRvIGAke2phdmEuaW8udG1wZGlyfS90ZW54L2dpdGh1YmAgKGBwaXBlbGluZXMvZ2l0b3BzL2NvbmZpZy55YW1sYCkuIEVhY2ggc3luYyByZXdyaXRlcyB0aGUgY29weSBpbiBwbGFjZSwgc28gdGhlIGxvb2t1cCBob3QtcmVsb2Fkcy4gYEdIX0VOQUJMRURgIHR1cm5zIG9uIHdpdGggYHRydWVgLCBgVHJ1ZWAgb3IgYFRSVUVgLCBhcyB0aGUgbGFuZSByZWFkcyBpdCwgYW5kIHdpdGggdGhlIEt1YmVybmV0ZXMgQ29uZmlnTWFwIGxhbmUgYWxzbyBvbiB0aGUgR2l0SHViIGNvcHkgd2luczogZW5hYmxlIG9uZSBsYW5lLiAoRGVmYXVsdDogKSIsCiAgICAgICAgICAiZGVmYXVsdCIgOiAiIgogICAgICAgIH0sCiAgICAgICAgIndhcm11cE1zIiA6IHsKICAgICAgICAgICJ0eXBlIiA6IFsKICAgICAgICAgICAgIm51bWJlciIsCiAgICAgICAgICAgICJzdHJpbmciLAogICAgICAgICAgICAibnVsbCIKICAgICAgICAgIF0sCiAgICAgICAgICAibWFya2Rvd25EZXNjcmlwdGlvbiIgOiAiUGVyLWNvbnRhaW5lciBncmFjZSBwZXJpb2QgYmVmb3JlIHRoaXMgcmVndWxhdG9yIGluc3RhbmNlIHN0YXJ0cyBjYXBwaW5nXG5cbkRlZmluZXMgYW4gb3B0aW9uYWwgcGVyLWNvbnRhaW5lciBncmFjZSBwZXJpb2QgaW4gbWlsbGlzZWNvbmRzLiBBIGNvbnRhaW5lciBpcyBsZWZ0IHVucmVndWxhdGVkIGZvciB0aGlzIGxvbmcgYWZ0ZXIgdGhpcyByZWd1bGF0b3IgaW5zdGFuY2UgZmlyc3Qgc2VlcyBpdHMgZXZlbnRzLiBUaGUgZGVmYXVsdCBpcyBgMGA6IGEgY29udGFpbmVyIGlzIGNhcHBlZCBmcm9tIGl0cyBmaXJzdCBsaW5lLCB3aGljaCBpcyB3aGF0IGEgY2FwIG1lYW50IGFzIGEgYnVkZ2V0IG5lZWRzLiAgQSBwb3NpdGl2ZSB2YWx1ZSBkZWZlcnMgY2FwIGRlY2lzaW9ucyB3aGlsZSB0aGUgcGVyLXBhdHRlcm4gY291bnRzIGZpbGwuIFRoaXMgaXMgYSAqKmRlbGF5IG9ubHkqKjsgbm8gbGVhcm5lZCBiYXNlbGluZSBpcyBidWlsdCwgYW5kIHRoZSBvbmx5IHN0YXRlIHRoYXQgc3Vydml2ZXMgaXMgdGhlIGNvbnRhaW5lcidzIGZpcnN0LXNlZW4gdGltZXN0YW1wLiAgXCJGaXJzdCBzZWVzXCIgaXMgcGVyIHJlZ3VsYXRvciBpbnN0YW5jZSwgbm90IHBlciBjb250YWluZXIgYmlydGguIEEgY29udGFpbmVyIHRoYXQgaGFzIGJlZW4gcnVubmluZyBmb3IgaG91cnMgYnV0IHdob3NlIGV2ZW50cyBoYXZlIG9ubHkganVzdCBzdGFydGVkIGZsb3dpbmcgdGhyb3VnaCB0aGlzIHJlZ3VsYXRvciAoZS5nLiBhZnRlciBhIHJlZ3VsYXRvciByZXN0YXJ0IG9yIGZvcndhcmRlciByZWNvbm5lY3QpIHJlc3RhcnRzIHRoZSB3YXJtdXAgd2luZG93LiBPbiBhIGRhZW1vbnNldCByb2xsaW5nIHJlc3RhcnQgdGhlIGNhcCBpcyB0aGVyZWZvcmUgZGlzYWJsZWQgZm9yIGB3YXJtdXBNc2AgcGVyIG5vZGUgYXMgaXQgY3ljbGVzLiAgU2V0IGl0IGZvciBzbG93LXJhbXBpbmcgSlZNcyBvciB3b3JrbG9hZHMgd2l0aCBsb25nIGluaXQgcGhhc2VzIHdob3NlIGZpcnN0IG1pbnV0ZXMgc2hvdWxkIG5vdCBiZSBjYXBwZWQuIFBhdHRlcm5zIHRoYXQgYXJlIGxlZ2l0aW1hdGVseSBkb21pbmFudCBpbiBzdGVhZHkgc3RhdGUgYmVsb25nIG9uIHRoZSBtdXRlIGZpbGUsIG5vdCBpbiBhIHdhcm11cC4gKEFjY2VwdHMgbnVtYmVyIG9yIHN0cmluZyB3aXRoICQ9IHByZWZpeCBmb3IgcnVudGltZSBldmFsdWF0aW9uKSAoRGVmYXVsdDogMCkiLAogICAgICAgICAgImRlZmF1bHQiIDogMAogICAgICAgIH0sCiAgICAgICAgImJhc2VsaW5lQ291bnQiIDogewogICAgICAgICAgInR5cGUiIDogWwogICAgICAgICAgICAibnVtYmVyIiwKICAgICAgICAgICAgInN0cmluZyIsCiAgICAgICAgICAgICJudWxsIgogICAgICAgICAgXSwKICAgICAgICAgICJtYXJrZG93bkRlc2NyaXB0aW9uIiA6ICJFdmVudHMgcGVyIHBhdHRlcm4ga2VwdCBlYWNoIHdpbmRvdyByZWdhcmRsZXNzIG9mIHNoYXJlXG5cbkRlZmluZXMgaG93IG1hbnkgZXZlbnRzIG9mIGVhY2ggYChwYXR0ZXJuLCBjb250YWluZXIpYCBhcmUga2VwdCBwZXIgd2luZG93IHJlZ2FyZGxlc3Mgb2YgdGhlIGNhcCBhbmQgdGhlIHNoYXJlLCBzbyBldmVuIGEgaGVhdmlseS1jYXBwZWQgcGF0dGVybiBsZWF2ZXMgYSBzbWFsbCBmb3JlbnNpYyBzYW1wbGUgdG8gaW5zcGVjdCBkdXJpbmcgYW4gaW5jaWRlbnQuIEluIGEgc2VydmljZSB3aXRoIGEgdG90YWwgKGByYXRlUmVjZWl2ZXJUb3RhbExvb2t1cEZpbGVgKSB0aGUgc2FtcGxlIGNvdW50cyB0b3dhcmQgaXQsIGFuZCBvbmNlIHRoZSB0b3RhbCBpcyBzcGVudCB0aGUgc2VydmljZSBwYXNzZXMgYXQgbW9zdCBgcmF0ZVJlY2VpdmVyQmFzZWxpbmVNYXhPdmVyVG90YWxgIG1vcmUgc2FtcGxlIGxpbmVzIGluIHRoZSB3aW5kb3cuIChBY2NlcHRzIG51bWJlciBvciBzdHJpbmcgd2l0aCAkPSBwcmVmaXggZm9yIHJ1bnRpbWUgZXZhbHVhdGlvbikgKERlZmF1bHQ6IDUpIiwKICAgICAgICAgICJkZWZhdWx0IiA6IDUKICAgICAgICB9LAogICAgICAgICJiYXNlbGluZU1heE92ZXJUb3RhbCIgOiB7CiAgICAgICAgICAidHlwZSIgOiBbCiAgICAgICAgICAgICJudW1iZXIiLAogICAgICAgICAgICAic3RyaW5nIiwKICAgICAgICAgICAgIm51bGwiCiAgICAgICAgICBdLAogICAgICAgICAgIm1hcmtkb3duRGVzY3JpcHRpb24iIDogIlNhbXBsZSBsaW5lcyBhIHNlcnZpY2UgcGFzc2VzIHBlciB3aW5kb3cgb25jZSBpdCBoYXMgcGFzc2VkIGl0cyB0b3RhbFxuXG5EZWZpbmVzIGhvdyBtYW55IGByYXRlUmVjZWl2ZXJCYXNlbGluZUNvdW50YCBzYW1wbGUgbGluZXMgYSBzZXJ2aWNlIHBhc3NlcyBwZXIgd2luZG93IG9uIHRoaXMgcmVndWxhdG9yIGluc3RhbmNlIG9uY2UgaXQgaGFzIHBhc3NlZCBpdHMgdG90YWwgKGByYXRlUmVjZWl2ZXJUb3RhbExvb2t1cEZpbGVgKS4gV2l0aGluIHRoZSB0b3RhbCB0aGUgc2FtcGxlIHBhc3NlcyBsaWtlIGFueSBsaW5lLiBQYXN0IGl0LCBzYW1wbGUgbGluZXMgcGFzcyB1cCB0byB0aGlzIGNvdW50LCBhbmQgdGhlIHJlc3QgdGFrZSB0aGUgcmVndWxhciBwYXRoOiB0aGUga2VlcCBjb3VudCBmb3IgdGhlIGxldmVscyBpbiBgcmF0ZVJlY2VpdmVyS2VlcENvdW50c2AsIHRoZW4gdGhlIHNlcnZpY2UncyBhY3Rpb24uIFRoaXMgYm91bmRzIGEgc2VydmljZSB0aGF0IHByaW50cyBtYW55IG5ldyBwYXR0ZXJucyBpbiBvbmUgd2luZG93LCBlYWNoIG9mIHdoaWNoIHdvdWxkIG90aGVyd2lzZSBwYXNzIGl0cyBzYW1wbGUgb3ZlciB0aGUgdG90YWwuICBUaGUgY291bnQgaXMgaW4gbGluZXMgd2hhdGV2ZXIgYHJhdGVSZWNlaXZlclVuaXRgIGlzLCBsaWtlIHRoZSBzYW1wbGUgYW5kIHRoZSBrZWVwIGNvdW50cywgc28gdW5kZXIgYGJ5dGVzYCBhIHNlcnZpY2UgY2FuIGV4Y2VlZCBpdHMgdG90YWwgYnkgdGhpcyBtYW55IG9mIGl0cyBvd24gbGluZXMuIGAwYCByZW1vdmVzIHRoZSBib3VuZCwgc28gZXZlcnkgc2FtcGxlIGxpbmUgcGFzc2VzLiBSZWFkIGJ5IHRoZSBjYXAtZmlsZSByZWd1bGF0b3JzLCBmb3Igc2VydmljZXMgd2l0aCBhIHRvdGFsLiAoQWNjZXB0cyBudW1iZXIgb3Igc3RyaW5nIHdpdGggJD0gcHJlZml4IGZvciBydW50aW1lIGV2YWx1YXRpb24pIChEZWZhdWx0OiA1MCkiLAogICAgICAgICAgImRlZmF1bHQiIDogNTAKICAgICAgICB9LAogICAgICAgICJrZWVwTWF4T3ZlclRvdGFsIiA6IHsKICAgICAgICAgICJ0eXBlIiA6IFsKICAgICAgICAgICAgIm51bWJlciIsCiAgICAgICAgICAgICJzdHJpbmciLAogICAgICAgICAgICAibnVsbCIKICAgICAgICAgIF0sCiAgICAgICAgICAibWFya2Rvd25EZXNjcmlwdGlvbiIgOiAiS2VlcC1jb3VudCBsaW5lcyBhIHNlcnZpY2UgcGFzc2VzIHBlciB3aW5kb3cgb25jZSBpdCBoYXMgcGFzc2VkIGl0cyB0b3RhbFxuXG5EZWZpbmVzIGhvdyBtYW55IGByYXRlUmVjZWl2ZXJLZWVwQ291bnRzYCBsaW5lcyBhIHNlcnZpY2UgcGFzc2VzIHBlciB3aW5kb3cgb24gdGhpcyByZWd1bGF0b3IgaW5zdGFuY2Ugb25jZSBpdCBoYXMgcGFzc2VkIGl0cyB0b3RhbCAoYHJhdGVSZWNlaXZlclRvdGFsTG9va3VwRmlsZWApLiBXaXRoaW4gdGhlIHRvdGFsIGEga2VlcC1jb3VudCBsaW5lIHBhc3NlcyBsaWtlIGFueSBsaW5lLiBQYXN0IGl0LCBrZWVwLWNvdW50IGxpbmVzIHBhc3MgdXAgdG8gdGhpcyBjb3VudCwgYW5kIHRoZSByZXN0IHRha2UgdGhlIHNlcnZpY2UncyBhY3Rpb24uIFRoaXMgYm91bmRzIGEgc2VydmljZSB0aGF0IHByaW50cyBtYW55IG5ldyBlcnJvciBwYXR0ZXJucyBpbiBvbmUgd2luZG93LCBlYWNoIG9mIHdoaWNoIHdvdWxkIG90aGVyd2lzZSBwYXNzIGl0cyBrZWVwIGNvdW50IG92ZXIgdGhlIHRvdGFsLiAgVGhlIGNvdW50IGlzIGluIGxpbmVzIHdoYXRldmVyIGByYXRlUmVjZWl2ZXJVbml0YCBpcywgbGlrZSB0aGUga2VlcCBjb3VudHMsIHNvIHVuZGVyIGBieXRlc2AgYSBzZXJ2aWNlIGNhbiBleGNlZWQgaXRzIHRvdGFsIGJ5IHRoaXMgbWFueSBvZiBpdHMgb3duIGxpbmVzLiBgMGAgcmVtb3ZlcyB0aGUgYm91bmQsIHNvIGV2ZXJ5IGtlZXAtY291bnQgbGluZSBwYXNzZXMuIFRoZSBsaW5lcyBhbiBhY3RpdmUgbXV0ZSBlbnRyeSBwYXNzZXMgZm9sbG93IHRoZSBlbnRyeSBhbmQgYXJlIG5vdCBjb3VudGVkIGhlcmUuIFJlYWQgYnkgdGhlIGNhcC1maWxlIHJlZ3VsYXRvcnMsIGZvciBzZXJ2aWNlcyB3aXRoIGEgdG90YWwuIChBY2NlcHRzIG51bWJlciBvciBzdHJpbmcgd2l0aCAkPSBwcmVmaXggZm9yIHJ1bnRpbWUgZXZhbHVhdGlvbikgKERlZmF1bHQ6IDUwMCkiLAogICAgICAgICAgImRlZmF1bHQiIDogNTAwCiAgICAgICAgfSwKICAgICAgICAiYWJzb2x1dGVDYXAiIDogewogICAgICAgICAgInR5cGUiIDogWwogICAgICAgICAgICAibnVtYmVyIiwKICAgICAgICAgICAgInN0cmluZyIsCiAgICAgICAgICAgICJudWxsIgogICAgICAgICAgXSwKICAgICAgICAgICJtYXJrZG93bkRlc2NyaXB0aW9uIiA6ICJGbGVldC13aWRlIGNhcCBwZXIgcGF0dGVybiBwZXIgY29udGFpbmVyIHBlciB3aW5kb3c7IGAwYCAoZGVmYXVsdCkgZGlzYWJsZXMgdGhlIGNhcCB1bmxlc3Mgb3ZlcnJpZGRlbiBwZXItY29udGFpbmVyIHZpYSBgcmF0ZVJlY2VpdmVyQ2FwTG9va3VwRmlsZWBcblxuRGVmaW5lcyBhICoqZmxlZXQtd2lkZSoqIGNhcCwgaW4gYHJhdGVSZWNlaXZlclVuaXRgOiB0aGUgYnVkZ2V0IGZvciBhIHNpbmdsZSBwYXR0ZXJuIChhIHVuaXF1ZSBjb21iaW5hdGlvbiBvZiBgcmF0ZVJlY2VpdmVyRmllbGROYW1lc2AgdmFsdWVzKSBwZXIgY29udGFpbmVyIHdpdGhpbiB0aGUgY3VycmVudCB3aW5kb3cgKGByYXRlUmVjZWl2ZXJSZXNldEludGVydmFsTXNgKS4gQXBwbGllcyB0byBldmVyeSBjb250YWluZXIgdGhlIHJlZ3VsYXRvciBzZWVzLCB1bmxlc3MgdGhhdCBjb250YWluZXIgaGFzIGl0cyBvd24gZW50cnksIG9yIHRoZSBgKmAgZW50cnksIGluIGByYXRlUmVjZWl2ZXJDYXBMb29rdXBGaWxlYCwgd2hpY2ggd2lucyBwZXItZXZlbnQuICBBdCBvciBiZWxvdyB0aGUgcmVzb2x2ZWQgY2FwIHRoZSBwYXR0ZXJuIGlzIGtlcHQgdW50b3VjaGVkLiBBYm92ZSBpdCwgYSBsaW5lIHRha2VzIHRoZSBjb250YWluZXIncyBhY3Rpb24sIGV4Y2VwdCB0aGUgYHJhdGVSZWNlaXZlckJhc2VsaW5lQ291bnRgIHNhbXBsZSwgdGhlIGxldmVscyBpbiBgcmF0ZVJlY2VpdmVyS2VlcENvdW50c2AgKHRoYXQgbWFueSBsaW5lcyBwZXIgcGF0dGVybiBwZXIgd2luZG93KSwgYSBwYXR0ZXJuIGJlbG93IGByYXRlUmVjZWl2ZXJNaW5TaGFyZVBlcmNlbnRgIG9mIGl0cyBjb250YWluZXIsIGFuZCB0aGUgYHJhdGVSZWNlaXZlclNldmVyaXR5Rmxvb3JzYCBzaGFyZSBvZiB0aGUgb3RoZXIgbGV2ZWxzLiAgKipgMGAgKHRoZSBkZWZhdWx0KSBkaXNhYmxlcyB0aGUgZmxlZXQtd2lkZSBjYXAuKiogV2l0aCBubyBmbGVldC13aWRlIGNhcCBhbmQgbm8gcGVyLWNvbnRhaW5lciBlbnRyeSBpbiBgcmF0ZVJlY2VpdmVyQ2FwTG9va3VwRmlsZWAsIHRoZSByZWd1bGF0b3IncyBvdmVyLWNhcCBicmFuY2ggbmV2ZXIgZW5nYWdlcyBmb3IgdGhhdCBjb250YWluZXIuIFByb3RlY3Rpb24gaXMgc3RyaWN0bHkgb3B0LWluLiBUaHJlZSBjb25maWd1cmF0aW9ucyBhcmUgZmlyc3QtY2xhc3M6ICAtICoqUGVyLWNvbnRhaW5lciBvbmx5Kio6IHNldCBgcmF0ZVJlY2VpdmVyQ2FwTG9va3VwRmlsZWAuIExpc3RlZCBjb250YWluZXJzIGdldCB0aGVpciBjYXA7ICAgdW5saXN0ZWQgY29udGFpbmVycyBhcmUgdW5yZWd1bGF0ZWQgYnkgdGhlIGFic29sdXRlIGNhcC4gTW9zdCBzZWxlY3RpdmUuIC0gKipGbGVldC13aWRlIG9ubHkqKjogc2V0IGByYXRlUmVjZWl2ZXJBYnNvbHV0ZUNhcGAgdG8gYSBwb3NpdGl2ZSBpbnRlZ2VyLiBBcHBsaWVzIHRvIGV2ZXJ5ICAgY29udGFpbmVyLiAtICoqQm90aCoqOiBwZXItY29udGFpbmVyIGVudHJpZXMgb3ZlcnJpZGUgdGhlIGZsZWV0LXdpZGUgY2FwOyB1bmxpc3RlZCBjb250YWluZXJzIGZhbGwgYmFjayAgIHRvIHRoZSBmbGVldC13aWRlIGNhcCAoc2FmZXR5IGZsb29yKS4gICoqRXhhbXBsZToqKiAxMDQ4NTc2MCAoMTAgTUIsIHdpdGggYHJhdGVSZWNlaXZlclVuaXRgIGBieXRlc2ApIG1lYW5zIGEgcGF0dGVybiBpcyBoZWxkIG9uY2UgaXQgaGFzIHNwZW50IDEwIE1CIGluIGEgY29udGFpbmVyIHdpdGhpbiB0aGUgd2luZG93LiAgV2l0aCB0aGUgc2hpcHBlZCBmbG9vcnMgYXQgYDBgIGFuZCB0aGUgc2hhcmUgZ3VhcmQgb2ZmLCB0aGUgbW9zdCBvbmUgcGF0dGVybiBpbiBvbmUgY29udGFpbmVyIHBhc3NlcyBwZXIgd2luZG93IGlzIHRoZSBsYXJnZXIgb2YgdGhlIGNhcCBhbmQgdGhlIGJhc2VsaW5lIHNhbXBsZSwgcGx1cyB0aGUga2VlcCBjb3VudCBmb3IgYW4gZXJyb3ItY2xhc3MgcGF0dGVybi4gKEFjY2VwdHMgbnVtYmVyIG9yIHN0cmluZyB3aXRoICQ9IHByZWZpeCBmb3IgcnVudGltZSBldmFsdWF0aW9uKSAoRGVmYXVsdDogMCkiLAogICAgICAgICAgImRlZmF1bHQiIDogMAogICAgICAgIH0sCiAgICAgICAgIm1pblNoYXJlUGVyY2VudCIgOiB7CiAgICAgICAgICAidHlwZSIgOiBbCiAgICAgICAgICAgICJudW1iZXIiLAogICAgICAgICAgICAic3RyaW5nIiwKICAgICAgICAgICAgIm51bGwiCiAgICAgICAgICBdLAogICAgICAgICAgIm1hcmtkb3duRGVzY3JpcHRpb24iIDogIk1pbmltdW0gc2hhcmUgb2YgY29udGFpbmVyIHZvbHVtZSBiZWxvdyB3aGljaCBhIHBhdHRlcm4gaXMgZXhlbXB0IGZyb20gc2FtcGxpbmdcblxuRGVmaW5lcyBhbiBvcHRpb25hbCBzaGFyZS1vZi1jb250YWluZXIgZ3VhcmQgKDAuMCB0byAxLjApOiBpZiBhIHBhdHRlcm4gaXMgYWJvdmUgaXRzIGNhcCBCVVQgYmVsb3cgdGhpcyBzaGFyZSBvZiBpdHMgY29udGFpbmVyJ3Mgdm9sdW1lLCB0aGUgcmVndWxhdG9yIGtlZXBzIGl0LiBUaGUgZGVmYXVsdCBpcyBgMGAsIHdoaWNoIHR1cm5zIHRoZSBndWFyZCBvZmYsIHNvIGEgY2FwIGhvbGRzIGV2ZXJ5IHBhdHRlcm4gaXQgaXMgc2V0IGZvci4gIFNoYXJlIGlzIGAocGF0dGVybiB1bml0cyArIGV2ZW50KSAvIChjb250YWluZXIgdW5pdHMgKyBldmVudClgIG92ZXIgdGhlIGN1cnJlbnQgd2luZG93LCBpbiBgcmF0ZVJlY2VpdmVyVW5pdGAuICAqKkV4YW1wbGU6KiogMC4wNSBrZWVwcyBhIHBhdHRlcm4gYWJvdmUgaXRzIGNhcCB3aGlsZSBpdCByZXByZXNlbnRzIGxlc3MgdGhhbiA1JSBvZiBpdHMgY29udGFpbmVyJ3Mgdm9sdW1lLCBmb3IgY29udGFpbmVycyB3aG9zZSB0cmFmZmljIGlzIHNwcmVhZCBhY3Jvc3MgbWFueSBwYXR0ZXJucy4gKEFjY2VwdHMgbnVtYmVyIG9yIHN0cmluZyB3aXRoICQ9IHByZWZpeCBmb3IgcnVudGltZSBldmFsdWF0aW9uKSAoRGVmYXVsdDogMCkiLAogICAgICAgICAgImRlZmF1bHQiIDogMAogICAgICAgIH0sCiAgICAgICAgImluZ2VzdGlvbkNvc3RQZXJHQiIgOiB7CiAgICAgICAgICAidHlwZSIgOiBbCiAgICAgICAgICAgICJudW1iZXIiLAogICAgICAgICAgICAic3RyaW5nIiwKICAgICAgICAgICAgIm51bGwiCiAgICAgICAgICBdLAogICAgICAgICAgIm1hcmtkb3duRGVzY3JpcHRpb24iIDogIlZlbmRvciBpbmdlc3Rpb24gY29zdCBwZXIgR0IgaW4gVVNELCBmb3IgcmVuZGVyaW5nIHNhdmluZ3MgaW4gZG9sbGFyc1xuXG5EZWZpbmVzIHRoZSBjb3N0IHBlciBHQiBjaGFyZ2VkIGJ5IHlvdXIgb2JzZXJ2YWJpbGl0eSB2ZW5kb3IgZm9yIGxvZyBpbmdlc3Rpb24uIFVzZWQgKipvbmx5KiogdG8gcmVuZGVyIHNhdmluZ3MgbWV0cmljcyBpbiBkb2xsYXJzIChkcm9wcGVkIGJ5dGVzIMOXIGNvc3QgcGVyIEdCKTsgaXQgZG9lcyAqKm5vdCoqIGFmZmVjdCB0aGUga2VlcC9kcm9wIGRlY2lzaW9uLCB3aGljaCBpcyBkcml2ZW4gYnkgdGhlIGJ5dGUgY2FwLiAgKipDb21tb24gdmVuZG9yIHByaWNpbmcgKDIwMjUpOioqIC0gKipTcGx1bmsgQ2xvdWQqKjogfiQxLjUwL0dCICh2YXJpZXMgYnkgY29udHJhY3QsIFNLVSkgLSAqKkRhdGFkb2cgTG9ncyoqOiB+JDAuMTAtJDAuMjUvR0IgKGRlcGVuZHMgb24gdGllcjogc3RhbmRhcmQsIGZsZXgsIG9ubGluZSBhcmNoaXZlcykgLSAqKkVsYXN0aWMgQ2xvdWQqKjogfiQwLjEwOS9HQiAoc3RhbmRhcmQgbG9nZ2luZyB0aWVyKSAtICoqTmV3IFJlbGljKio6IH4kMC4zMC9HQiAoRGF0YSBQbHVzKSAtICoqU3VtbyBMb2dpYyoqOiB+JDEuNTAvR0IgKGRlcGVuZHMgb24gcGxhbikgLSAqKkFXUyBDbG91ZFdhdGNoIExvZ3MqKjogfiQwLjUwL0dCIGluZ2VzdGlvbiArICQwLjAzL0dCIHN0b3JhZ2UgLSAqKkF6dXJlIE1vbml0b3IgTG9ncyoqOiB+JDIuMzAvR0IgQW5hbHl0aWNzLCAkMC41MC9HQiBCYXNpYywgJDAuMDUvR0IgQXV4aWxpYXJ5ICgrIHBlci1HQiBxdWVyeSBmZWUpIChBY2NlcHRzIG51bWJlciBvciBzdHJpbmcgd2l0aCAkPSBwcmVmaXggZm9yIHJ1bnRpbWUgZXZhbHVhdGlvbikgKERlZmF1bHQ6IDEpIiwKICAgICAgICAgICJkZWZhdWx0IiA6IDEKICAgICAgICB9CiAgICAgIH0KICAgIH0KICB9LAogICJhZGRpdGlvbmFsUHJvcGVydGllcyIgOiB0cnVlCn0=
# 🔟❎ 'run' rate regulator configuration
# The rate regulator holds each log pattern in a container to a cap per window, and
# each container to an optional total per window, counted in bytes or in events.
# Lines over a cap or a total take the container's action; error-class levels keep
# a fixed count of lines per pattern per window. An optional mute file overrides the
# regulator for explicitly declared patterns.
# To learn more see https://doc.log10x.com/run/receive/rate/
# Set the 10x pipeline to 'run'
tenx: run
# =============================== Dependencies ================================
include: run/modules/receive/rate
# ============================== Rate Options =================================
rateReceiver:
# 'fieldNames' identifies the log PATTERN (the numerator bucket): the field the
# message initializer writes, named by symbolMessageField (message_pattern). The container is configured
# separately via 'containerField' below -- it is the denominator and is keyed
# on its own, so a pattern's share is measured per container.
fieldNames:
- $=yield TenXEnv.get("symbolMessageField")
# 'containerField' names the field whose value scopes the share denominator
# (the per-container total). Defaults to the k8s container name, which is
# stable across pod replicas (never the pod). When the field is absent on an
# event (non-k8s input), the regulator falls back to a single node-wide bucket.
containerField: $=yield TenXEnv.get("k8sContainerNameField")
# 'resetIntervalMs' is the window over which recent share is measured.
# Windows start at each multiple of the interval since the Unix epoch, so
# every node's windows line up with the clock, the same windows for all
# patterns and services. The first window after a start is partial, and a
# policy file reload does not start a new window.
resetIntervalMs: $=parseDuration("4m")
# 'unit' is what the caps, the totals and the share guard count: 'bytes' (each
# event counts the UTF-8 size of the whole record the forwarder sends, not only
# the message) or 'events' (each line counts 1). Write the cap
# and total files in the same unit. Any other value stops the launch.
unit: bytes
# 'absoluteCap' is the fleet-wide cap: the budget, in 'unit', for a single
# pattern per container within the current window. Past it, lines take the
# container's action, except the 'baselineCount' sample and, for the levels
# in 'keepCounts', that many lines per pattern per window.
#
# Default 0 = disabled. Three customer configurations are first-class:
# - Per-container only: leave 'absoluteCap' unset, set 'capLookup.file' below.
# Listed containers get the file's cap; unlisted containers are
# unregulated by the absolute cap. Most selective.
# - Fleet-wide only: set 'absoluteCap' to a positive integer (e.g., 10485760
# for 10 MB). Applies to every container the regulator sees.
# - Both: per-container entries in 'capLookup.file' override the fleet-wide
# cap; unlisted containers fall back to the fleet-wide cap (safety floor).
# absoluteCap: 10485760 # 10 MB
# 'minSharePercent' is an optional guard for legitimately high-volume
# containers. If a pattern is over its cap BUT below this share of its
# container's volume, it is left alone. 0 turns the guard off, so a cap holds
# every pattern it is set for.
minSharePercent: 0
# 'defaultAction' is the action the held lines of a container with neither its
# own row nor a '*' row in 'actionLookupFile' take: 'pass', 'offload',
# 'tier_down', 'compact', 'sample' or 'drop'. 'pass' leaves them in place, so
# only the containers the file covers act on theirs. A value outside the six
# logs a warning at load and 'pass' applies. Read by the regulators that
# consult 'actionLookupFile'.
defaultAction: pass
# 'keepCounts' is the number of lines per pattern per window a level passes once
# the pattern is over its cap or its service over its total, also under a mute
# entry, in place of its 'severityFloors' draw. ERROR, CRITICAL and FATAL keep
# a count of 50 even when removed here; -1 gives a level its floor instead. In
# a service with a total, the lines count toward it and 'keepMaxOverTotal'
# bounds them past it.
keepCounts:
- ERROR=50
- CRITICAL=50 # the level enrichment maps fatal/critical -> CRITICAL
- FATAL=50 # kept for forwarders whose level vocabulary emits FATAL
# 'keepCountSlices' is how many equal slices of the window release each
# pattern's 'keepCounts' lines. The allowance accumulates: by the end of
# slice i of S the pattern may have passed the count x i / S, rounded down,
# so with ERROR=50 and the 4-minute window, 4 slices pass 12, 13, 12 and 13
# lines of a sustained storm in its four minutes. Lines a slice leaves unused
# carry to the next, so a burst late in the window passes more than one
# early in it, never more than the count, and lines under a mute entry share
# the same count. 1 passes the whole count at the window start; below 1 or
# not a number acts as 1, and a fraction is rounded down. Read by the
# regulators that consult 'capLookup.file'.
keepCountSlices: 4
# 'severityFloors' is the fraction of each level kept at random once a pattern is
# over its cap, for levels not in 'keepCounts'. 0 keeps none, so the cap holds.
# Floor-map keys must match the level vocabulary emitted by the level enrichment.
severityFloors:
- TRACE=0
- DEBUG=0
- INFO=0
- WARN=0
- ERROR=0 # 'keepCounts' governs ERROR, CRITICAL and FATAL
- CRITICAL=0
- FATAL=0
# 'minRetentionThreshold' is the floor used for any level not present in
# 'severityFloors'.
minRetentionThreshold: 0
# 'warmupMs' is an optional per-instance grace period before the regulator starts
# capping a newly-seen container. Scope is per regulator instance, so a regulator
# restart restarts the window. 0 caps a container from its first line. See
# https://doc.log10x.com/run/receive/rate/#warmup for the operator guide.
warmupMs: 0
# 'baselineCount' is the number of events of each pattern kept per window
# regardless of the cap and the share, so even a heavily-capped pattern leaves
# a forensic sample. In a service with a total, the sample counts toward it.
baselineCount: 5
# 'baselineMaxOverTotal' is the most sample lines a service passes per window
# once it has passed its total; the rest take the regular path (the keep
# count, then the service's action). It bounds a service that prints many new
# patterns in one window. Counted in lines whatever 'unit' is. 0 removes the
# bound, so every sample line passes.
baselineMaxOverTotal: 50
# 'keepMaxOverTotal' is the most 'keepCounts' lines a service passes per window
# once it has passed its total; the rest take the service's action. Within the
# total they pass like any line. It bounds a service that prints many new
# error patterns in one window. Counted in lines whatever 'unit' is. 0 removes
# the bound, so every keep-count line passes.
keepMaxOverTotal: 500
# 'ingestionCostPerGB' is used only to render savings metrics in dollars; it does
# not affect the keep/drop decision (the decision is share-based).
ingestionCostPerGB: 1.5
# ---------------------------- Mute File Options ----------------------------
# Optional declarative mute file keyed by the joined 'fieldNames'. The mute file
# composes with the regulator: a listed, active pattern is decided by its file
# entry (the human declaration wins), and everything else is handled by the
# regulator.
#
# File format (CSV; header row + one comma-separated entry per row):
# fieldSet,value
# <fieldSetKey>,<sampleRate>:<untilEpochSec>[:<reason>]
#
# sampleRate 1.0 = never sampled; <1.0 = retain at that rate. Entries self-heal
# past 'untilEpochSec'. The 'keepCounts' levels still pass their count per
# pattern per window, so a 0.0 mute never silences ERROR/CRITICAL/FATAL, and in
# a capped container the lines a mute passes count toward the service's total.
#
# Periodically pulling the mute file to keep it fresh is done via the gitops
# configuration -- see https://doc.log10x.com/config/github/#config
lookup:
# 'file' specifies the mute file path. Hot-reloaded on in-place writes (the
# gitops pattern); Kubernetes ConfigMap mounts won't reload. Comment out to
# run the regulator alone (the default).
# file: $=path("data/sample/mutes") + "/mutes.csv"
# 'retain' specifies the period before the file is marked as stale.
retain: $=parseDuration("10m")
# ---------------------------- Cap File Options -----------------------------
# Optional declarative per-container cap file keyed by the value of
# 'containerField' (the k8s container name by default). Each entry assigns a
# cap, in 'unit', to a specific container; the file wins per-event over
# 'absoluteCap' above. A row keyed '*' applies to every container without a
# row of its own. Unlisted containers with no '*' row fall back to
# 'absoluteCap' (or to no cap, when 'absoluteCap' is unset/0). A row of 0
# exempts its container; a '*' row of 0 exempts every container without a row
# of its own, so 'absoluteCap' then applies to none of them.
#
# File format (CSV; header row + one comma-separated entry per row):
# container,cap
# <container>,<cap>[:<untilEpochSec>][:<reason>]
# *,<cap>[:<untilEpochSec>][:<reason>]
#
# Written by the Log10x MCP: its budget run (log10x_setup_recurring) writes the
# file to the policy ConfigMap or commits it to the policy branch. A
# log10x_configure_engine call derives caps from a target percent or a monthly
# dollar budget and delivers them as its 'delivery' says: a PR against the
# gitops repo, a write to the policy ConfigMap, or no write (stdout_only).
capLookup:
# 'file' specifies the per-container cap file path. Hot-reloaded on in-place
# writes (the gitops pattern) and when the file is replaced via ATOMIC_MOVE
# (the Kubernetes ConfigMap pull driver, whose copy is at
# ${java.io.tmpdir}/tenx/kubernetes/<namespace>/<configMap>/caps.csv).
#
# CAP_LOOKUP_FILE sets the path. Unset, no cap table loads and every container
# falls back to 'absoluteCap', so a Receiver launches before its policy files
# arrive.
#
# With GH_ENABLED=true (the policy lane in pipelines/gitops/config.yaml), the
# default is the pulled copy of the policy repo's log10x/policy/caps.csv, in
# the lane's mirror folder: ${GH_DEST:-${java.io.tmpdir}/tenx/github}. The
# policy folder must then hold caps.csv when the engine starts. GH_ENABLED is
# read as the lane reads it: true, True or TRUE turn it on (any other value
# but false/False/FALSE stops the launch). It wins over the ConfigMap path
# for all four policy files: enable one lane, not both.
file: '$=TenXEnv.get("CAP_LOOKUP_FILE", (TenXEnv.get("GH_ENABLED", "false") == "true" || TenXEnv.get("GH_ENABLED", "false") == "True" || TenXEnv.get("GH_ENABLED", "false") == "TRUE") ? TenXEnv.get("GH_DEST", TenXEnv.get("java.io.tmpdir", "/tmp") + "/tenx/github") + "/log10x/policy/caps.csv" : TenXEnv.get("CAP_LOOKUP_FILE"))'
# 'retain' specifies the period before the file is marked as stale.
retain: $=parseDuration("10m")
# =========================== Config-Version Stamp ============================
#
# 'configGeneration.file' points at the config-generation.csv the MCP control
# plane (log10x_configure_engine) writes as a SIBLING of the cap file in the
# cap ConfigMap. The receiver reads its `generation` value (a hash of the cap
# policy) and stamps it on every event as `tenx_config_version`. The
# `config_generation` aggregator publishes it as one series per generation
# (`config_generation_summaryBytes_total{tenx_config_version=...}`); the per-pattern
# counters do not carry it, so a policy write does not restart their series.
# The running engine advertises which config generation it loaded and the MCP
# can verify the policy it wrote is live (the config-generation closed loop).
# Hot-reloaded like the cap file.
#
# OPT-IN, decoupled from caps: unset by default, so the stamp is emitted ONLY
# when this points at a file. A receiver running the regulator WITHOUT the MCP
# closed loop (GitOps-managed caps) leaves it unset and never loads the file --
# no dependency, no init failure on a missing file. Set CONFIG_GENERATION_FILE
# (or this) to the sibling of caps.csv, e.g.:
# ${java.io.tmpdir}/tenx/kubernetes/<namespace>/<configMap>/config-generation.csv
# With GH_ENABLED=true the default is the GitHub policy lane's pulled copy of
# log10x/policy/config-generation.csv.
configGeneration:
file: '$=TenXEnv.get("CONFIG_GENERATION_FILE", (TenXEnv.get("GH_ENABLED", "false") == "true" || TenXEnv.get("GH_ENABLED", "false") == "True" || TenXEnv.get("GH_ENABLED", "false") == "TRUE") ? TenXEnv.get("GH_DEST", TenXEnv.get("java.io.tmpdir", "/tmp") + "/tenx/github") + "/log10x/policy/config-generation.csv" : "")'
# --------------------------- Action File Options ---------------------------
# Optional declarative per-SERVICE action file, keyed by the value of
# 'containerField' (the k8s container name = the service). Each entry assigns
# the disposition of that service's held lines: 'pass' (default), 'offload'
# (to customer S3), 'tier_down' (SIEM cheap tier), 'compact' (lossless
# encode), 'sample', or 'drop'. The cap and the total decide which lines are
# held; the action only decides what happens to them. A row keyed '*' applies
# to every service without a row of its own; a service with neither takes
# 'defaultAction' above ('pass' unless set), and a cap file with no actions
# file loads an empty table.
#
# File format (CSV; header row + one comma-separated entry per row):
# container,action
# <container>,<action>[:<untilEpochSec>][:<reason>]
# *,<action>[:<untilEpochSec>][:<reason>]
#
# Written by the Log10x MCP beside the cap file, the same way (see 'capLookup').
# 'actionLookupFile' is the per-service action file path. Declared as a FLAT
# key (like 'fieldNames' / 'minSharePercent'): the schema generator nests a
# group only when two or more options share its prefix, and this option is
# the only one under 'actionLookup'. Always set (default below, sibling to the
# cap file) so the cap-variant regulator can read it: the pulled copy of
# log10x/policy/actions.csv with GH_ENABLED=true, else the ConfigMap path.
# ACTION_LOOKUP_FILE overrides for non-k8s / fixed-path deployments.
actionLookupFile: '$=TenXEnv.get("ACTION_LOOKUP_FILE", (TenXEnv.get("GH_ENABLED", "false") == "true" || TenXEnv.get("GH_ENABLED", "false") == "True" || TenXEnv.get("GH_ENABLED", "false") == "TRUE") ? TenXEnv.get("GH_DEST", TenXEnv.get("java.io.tmpdir", "/tmp") + "/tenx/github") + "/log10x/policy/actions.csv" : TenXEnv.get("java.io.tmpdir", "/tmp") + "/tenx/kubernetes/" + TenXEnv.get("K8S_NAMESPACE", "demo") + "/" + TenXEnv.get("K8S_CONFIGMAP", "log10x-action-intent") + "/actions.csv")'
# ---------------------------- Total File Options ---------------------------
# Optional declarative per-SERVICE total file, keyed by the value of
# 'containerField'. Each entry bounds what the service passes per window on
# this node, in 'unit'. When the service's caps alone let more than its total
# through in the previous window, every pattern's cap scales by total / that
# amount for the whole window, or by what they let through so far this window
# once that is larger, so its largest patterns are held first. The scale
# follows the previous window, so the window after a storm is scaled by the
# storm for its whole length and recovers the window after. The first window
# after a quiet one fills its total in arrival order before the scale applies.
# A service whose first lines of this window and of the last window it sent in
# are two window lengths or more apart scales by total / its units so far this
# window instead. Once the lines it passed reach the total, every further line
# takes the service's action. The 'baselineCount' sample counts toward the
# total like any line, and once the total is spent the service passes at most
# 'baselineMaxOverTotal' more sample lines in the window. The 'keepCounts'
# lines count toward the total the same way, and once it is spent the service
# passes at most 'keepMaxOverTotal' more of them in the window. The lines a
# mute entry passes still pass and count toward the total, so a muted pattern
# can exceed it by that much. Read by the cap-file regulators, for containers
# with a cap. A row keyed '*' applies to every service without a row of its
# own; a row of 0 exempts its service, and a '*' row of 0 gives every unlisted
# service no total. A missing file loads as an empty table.
#
# File format (CSV; header row + one comma-separated entry per row):
# container,total
# <container>,<total>[:<untilEpochSec>][:<reason>]
# *,<total>[:<untilEpochSec>][:<reason>]
#
# 'totalLookupFile' is the per-service total file path, a FLAT key like
# 'actionLookupFile', defaulting to the sibling of the cap file: the pulled
# copy of log10x/policy/totals.csv with GH_ENABLED=true, else the ConfigMap
# path. TOTAL_LOOKUP_FILE overrides for non-k8s / fixed-path deployments.
totalLookupFile: '$=TenXEnv.get("TOTAL_LOOKUP_FILE", (TenXEnv.get("GH_ENABLED", "false") == "true" || TenXEnv.get("GH_ENABLED", "false") == "True" || TenXEnv.get("GH_ENABLED", "false") == "TRUE") ? TenXEnv.get("GH_DEST", TenXEnv.get("java.io.tmpdir", "/tmp") + "/tenx/github") + "/log10x/policy/totals.csv" : TenXEnv.get("java.io.tmpdir", "/tmp") + "/tenx/kubernetes/" + TenXEnv.get("K8S_NAMESPACE", "demo") + "/" + TenXEnv.get("K8S_CONFIGMAP", "log10x-action-intent") + "/totals.csv")'
Options
Specify the options below to configure the rate receiver:
| Name | Description |
|---|---|
| rateReceiverFieldNames | List of TenXObject fields to identify rate counter buckets |
| rateReceiverContainerField | Field whose value scopes the per-container share denominator |
| rateReceiverResetIntervalMs | Reset interval for rate counters in milliseconds |
| rateReceiverUnit | What the caps, the totals and the share guard count, `bytes` or `events` |
| rateReceiverMinRetentionThreshold | Default retention floor for severity levels not listed in severityFloors |
| rateReceiverSeverityFloors | Fraction of each severity level kept at random once a pattern is held |
| rateReceiverKeepCounts | Lines per pattern per window that pass for a level once the pattern is held |
| rateReceiverKeepCountSlices | Equal slices of the window through which each pattern's keep count is released |
| rateReceiverLookupFile | Declarative mute file keyed by field-set |
| rateReceiverLookupRetain | Retention period for the lookup file containing global event type rates |
| rateReceiverActionLookupFile | Declarative per-service action file, keyed by the `rateReceiverContainerField` value; decides the disposition of each service's regulator excess |
| rateReceiverDefaultAction | The action a container with no `rateReceiverActionLookupFile` row takes for its over-cap excess |
| rateReceiverCapLookupFile | Declarative per-container cap file, keyed by the `rateReceiverContainerField` value |
| rateReceiverCapLookupRetain | Retention period for the per-container cap file before it is considered stale |
| rateReceiverTotalLookupFile | Declarative per-service total file, keyed by the `rateReceiverContainerField` value; bounds what each capped service passes per window |
| rateReceiverConfigGenerationFile | Optional config-generation file whose `generation` value is stamped as the `tenx_config_version` metric label |
| rateReceiverWarmupMs | Per-container grace period before this regulator instance starts capping |
| rateReceiverBaselineCount | Events per pattern kept each window regardless of share |
| rateReceiverBaselineMaxOverTotal | Sample lines a service passes per window once it has passed its total |
| rateReceiverKeepMaxOverTotal | Keep-count lines a service passes per window once it has passed its total |
| rateReceiverAbsoluteCap | Fleet-wide cap per pattern per container per window; `0` (default) disables the cap unless overridden per-container via `rateReceiverCapLookupFile` |
| rateReceiverMinSharePercent | Minimum share of container volume below which a pattern is exempt from sampling |
| rateReceiverIngestionCostPerGB | Vendor ingestion cost per GB in USD, for rendering savings in dollars |
rateReceiverFieldNames
List of TenXObject fields to identify rate counter buckets.
| Type | Default |
|---|---|
| List | [symbolMessage] |
Defines the list of TenXObject field names extracted to identify which rate counter bucket an event belongs to.
The list usually contains the pattern field the message enrichment module writes,
named by symbolMessageField: message_pattern in the shipped configuration, symbolMessage at that option's default.
It can include additional fields like GeoIP, HTTP code, k8s container name, or custom enrichments for multi-dimensional rate tracking.
Common Use Cases:
Single-app receiving (per event type):
Multi-dimensional tracking (event type + geography + HTTP status):
Multi-app receiving in Kubernetes:
Option A: Cap total spend per app (all event types combined):
Each app's total spend (across all event types and pods) gets one cap. Simple but loses event-type intelligence.
Option B: Cap spend per event type per app:
rateReceiverFieldNames:
- message_pattern # Event type
- container # App identifier (same across all pods)
Each (event type × app) combo gets its own cap. Provides fairness within apps but allows apps with many event types to potentially exceed one total cap.
The container is configured separately via rateReceiverContainerField (it scopes the
share denominator), so fieldNames identifies only the log pattern itself.
rateReceiverContainerField
Field whose value scopes the per-container share denominator.
| Type | Default |
|---|---|
| String |
Names the field whose value scopes the share denominator (the per-container total).
A pattern's share is measured against the total volume of the container it belongs to,
so the cap is enforced per (pattern, container).
Defaults to the k8s container name, which is
stable across pod replicas, so pods of one container on the same node share the cap, and a
sidecar never consumes the application container's allowance. Each regulator instance counts
its own, so pods spread across ten nodes get ten caps. Use container, never pod.
When the field is absent on an event (non-k8s input, or no k8s extractor configured), the regulator falls back to a single node-wide bucket and enforces the cap per pattern across the node.
rateReceiverResetIntervalMs
Reset interval for rate counters in milliseconds.
| Type | Default |
|---|---|
| Number | 240000 |
Defines the window in milliseconds over which a pattern's recent share is measured. The counters reset every interval, so share reflects recent volume rather than all-time totals. Windows start at each multiple of the interval since the Unix epoch, so every node's windows line up with the clock, the same windows for all patterns and services. The first window after a start is partial, and a policy file reload does not start a new window.
Shorter windows (e.g., 1 minute) are more reactive but noisier; longer windows are smoother but slower to adapt. The default of 4 minutes balances the two.
Validation: Must be at least 60000 milliseconds (1 minute).
rateReceiverUnit
What the caps, the totals and the share guard count, `bytes` or `events`.
| Type | Default |
|---|---|
| String | bytes |
Defines what the regulator counts against rateReceiverAbsoluteCap, the cap file
(rateReceiverCapLookupFile), the total file (rateReceiverTotalLookupFile) and the
share guard: bytes counts the UTF-8 size of each event as the forwarder sends it, the whole record and not only the message, events counts each line as 1.
Use events where the analyzer bills per event (Datadog indexes logs per event) and
bytes where it bills per GB. Write the cap and total files in the same unit.
Validation: must be bytes or events; any other value stops the launch.
rateReceiverMinRetentionThreshold
Default retention floor for severity levels not listed in severityFloors.
| Type | Default |
|---|---|
| Number | 0 |
Defines the retention floor (0.0 to 1.0) used for any severity level not present in
rateReceiverSeverityFloors: the fraction of a held pattern's lines of that level kept at
random. 0 keeps none, so the cap holds.
rateReceiverSeverityFloors
Fraction of each severity level kept at random once a pattern is held.
| Type | Default |
|---|---|
| List | [] |
defines a map of severity levels to the
fraction (0.0 to 1.0) of a held pattern's lines kept at random, for levels not listed in
rateReceiverKeepCounts. The shipped configuration sets every level to 0, so a cap holds
and error-class levels pass by count instead.
The floor also applies under a mute-file entry: an active entry keeps the larger of its sample rate and the floor.
Floor-map keys must match the level vocabulary emitted by the level enrichment. Any level not
listed uses rateReceiverMinRetentionThreshold.
For example:
rateReceiverKeepCounts
Lines per pattern per window that pass for a level once the pattern is held.
| Type | Default |
|---|---|
| List | [] |
defines a map of severity levels to a count:
the number of lines of each pattern of that level that pass per window once the pattern is
over its cap or its container is over its total (rateReceiverTotalLookupFile), and under an
active mute-file entry. Lines past the count take the container's action, or the mute's
sample rate under a mute. A listed level skips its rateReceiverSeverityFloors draw.
The count is per pattern, per container, per regulator instance (one per node), per window
(rateReceiverResetIntervalMs). The lines it passes count toward the container's total, and
once the total is spent the container passes at most rateReceiverKeepMaxOverTotal more of
them in the window.
Keys must match the level vocabulary emitted by the level enrichment. The module's settings
set ERROR=50, CRITICAL=50 and FATAL=50, and entries merge by level, so those three
levels always keep a count (50 unless set); an entry for one of them in the config or on the
command line comes later and wins, and -1 gives it its floor instead. Any other level not
listed follows its floor.
For example:
rateReceiverKeepCountSlices
Equal slices of the window through which each pattern's keep count is released.
| Type | Default |
|---|---|
| Number | 4 |
Defines how many equal slices of the window (rateReceiverResetIntervalMs) release the
rateReceiverKeepCounts lines of a pattern once it is over its cap or its container is over
its total. The allowance accumulates through the window: by the end of the first of S slices
the pattern may have passed the count x 1 / S lines, by the end of the second the count x
2 / S, rounded down, and the whole count in the last, so with ERROR=50, 4 slices and the
4-minute window a sustained storm passes 12, 13, 12 and 13 lines in the window's four
minutes and reaches the destination in every one of them. Lines a slice leaves unused carry
to the next, so a burst late in the window passes more than one early in it, never more than
the count. Lines an active mute-file entry passes and the lines released here share one count
per window. Slices start on the clock like windows, so with the defaults each slice is one
clock minute. 1 releases the whole count at the start of the window; a value below 1 or not
a number acts as 1, and a fraction is rounded down. Past the container's total every
keep-count line counts toward rateReceiverKeepMaxOverTotal. Read by the cap-file
regulators.
rateReceiverLookupFile
Declarative mute file keyed by field-set.
| Type | Default |
|---|---|
| String |
Defines the path to a declarative mute file that caps specific log patterns by
the joined field-set defined in rateReceiverFieldNames (e.g. message_pattern,
container, httpCode). The key format is the same one the local receiver uses
for per-node counters.
When this option is set, the mute file composes with the regulator rather than replacing it: a listed, active pattern is decided by its file entry (the human declaration wins, and the regulator is skipped for that event), while every other pattern is handled by the regulator's cap.
File format (CSV; header row + one comma-separated entry per row):
fieldSetKey, the joined values of the fields named inrateReceiverFieldNames, separated by_. WithrateReceiverFieldNames: [message_pattern]the key is just the pattern (e.g.Error_syncing_pod). With[message_pattern, container]the key ismessage_pattern_container(e.g.heartbeat_debug_frontend).sampleRate, probability in[0, 1.0]that a matching event is retained.0= full mute;0.1= keep 10%;1.0= no-op.untilEpochSec, mute expires at this Unix epoch (seconds). Past that, the entry becomes a no-op until someone edits or removes it. Self-healing by design.reason, optional free-text string for audit. Not used at runtime. Must not contain commas (would break CSV parsing).
Example (with rateReceiverFieldNames: [message_pattern]):
fieldSet,value
Error_syncing_pod,0.10:1744848000:pod error spam OPS-4821
heartbeat_debug,0:1744416000:k8s liveness 200s
jwt_validated,0.25:1744502400:auth flood after deploy
The file is hot-reloaded on in-place writes (the gitops pattern); a Kubernetes
ConfigMap mount won't reload because the CM swap is a symlink rename, not an
in-place write.
Why this shape:
- Field-set keyed, not regex keyed → mute keys are the exact identifiers the
Reporter attributes cost to (same
rateReceiverFieldNameson both sides), so a "top spender" in the Reporter maps 1:1 to a mute entry. - Git-friendly: the file is a human-readable declaration that can live in a
config repo, reviewed via PR,
git blame-d for who/why. - Self-healing: every mute has an explicit expiry, so forgotten entries eventually stop filtering instead of silently dropping production data forever.
- AI-editable: an operator can ask an assistant (e.g., Claude Code via the
Log10x MCP) to "mute
Error_syncing_podfor 24 hours at 10%", the assistant reads the Reporter's cost attribution, appends the entry, and opens a PR or pushes the change, as the repo is set up. The mute file is the interface.
Error-class lines still pass by count. Under an active entry, the levels in
rateReceiverKeepCounts pass up to their count per pattern per window, released
across the window, before the sample rate applies, so a 0.0 mute never silences
ERROR/CRITICAL/FATAL traffic.
Lines a mute passes still count. In a container with a cap file row, the lines an
active entry passes count toward the service's total (rateReceiverTotalLookupFile), so
the service's other patterns are held first once the total is reached.
When rateReceiverLookupFile is unset, the regulator runs alone on every pattern.
rateReceiverLookupRetain
Retention period for the lookup file containing global event type rates.
| Type | Default |
|---|---|
| Number | 300000 |
Defines the retention period for the lookup file containing global event type frequency data.
If the file's last modified time is older than this period, the lookup is considered stale, and local counter rates are used. Used to make sampling decisions based on cluster-wide event patterns.
Validation: Must be greater than 60000 milliseconds.
rateReceiverActionLookupFile
Declarative per-service action file, keyed by the `rateReceiverContainerField` value; decides the disposition of each service's regulator excess.
| Type | Default |
|---|---|
| String | "" |
Defines the path to a declarative per-service action file (sibling to the cap file).
Each entry assigns the disposition of a service's held lines: pass (default), offload
(to customer S3), tier_down (analyzer cheap tier), compact (lossless encode), sample,
or drop. The cap (rateReceiverCapLookupFile) and the total (rateReceiverTotalLookupFile)
decide which lines are held; the action only decides what happens to them. A row keyed *
applies to every service without a row of its own; a service with neither takes
rateReceiverDefaultAction (pass unless set), and a cap file with no actions file loads an
empty table. Read by the cap-variant regulator classes, which call route(action) at the
over-budget decision point.
File format (CSV; header row + one comma-separated entry per row):
container,action
<container>,<action>[:<untilEpochSec>][:<reason>]
*,<action>[:<untilEpochSec>][:<reason>]
container, value ofrateReceiverContainerField(the k8s container = the service), or*for every service without a row of its own.action, one ofdrop/offload/tier_down/compact/sample/pass.untilEpochSec, optional Unix-epoch (seconds) expiry; past it the entry is a no-op.reason, optional free-text for audit. Must not contain commas (would break CSV parsing).
Intended to be managed via GitOps + the log10x_configure_engine MCP tool, which derives
per-service actions from the per-pattern action plan it already computes.
From a policy repo. With GH_ENABLED=true, the default is the GitHub policy lane's
mirrored copy of the repo's log10x/policy/actions.csv: ${GH_DEST}/log10x/policy/actions.csv, with
GH_DEST defaulting to ${java.io.tmpdir}/tenx/github (pipelines/gitops/config.yaml).
Each sync rewrites the copy in place, so the lookup hot-reloads. GH_ENABLED turns on
with true, True or TRUE, as the lane reads it, and with the Kubernetes ConfigMap lane
also on the GitHub copy wins: enable one lane.
rateReceiverDefaultAction
The action a container with no `rateReceiverActionLookupFile` row takes for its over-cap excess.
| Type | Default |
|---|---|
| String | pass |
Defines what the held lines of a container with neither its own row nor a * row in
rateReceiverActionLookupFile do: one of pass, offload, tier_down, compact, sample
or drop. pass leaves them where they were, so only the containers the actions file covers
act on theirs. An explicit row, and then the * row, still win.
Set it beside rateReceiverAbsoluteCap so the fleet-wide cap acts on services nobody listed.
Read by the cap-file regulator classes, the ones that consult the actions file. A value
outside the six logs a warning at load and the regulator uses pass.
rateReceiverCapLookupFile
Declarative per-container cap file, keyed by the `rateReceiverContainerField` value.
| Type | Default |
|---|---|
| String |
Defines the path to a declarative per-container cap file. Each entry assigns a cap, in
rateReceiverUnit, to a specific container (the value of rateReceiverContainerField, which
defaults to the k8s container name). The file's cap wins per-event over
rateReceiverAbsoluteCap: a listed container gets its own row, an unlisted one gets the row
keyed *, and a container with neither falls back to the fleet-wide cap (or to no cap, if
rateReceiverAbsoluteCap is 0).
File format (CSV; header row + one comma-separated entry per row):
container, value ofrateReceiverContainerFieldfor the events to cap. In k8s this is the k8s container name, stable across pod replicas.*caps every container without a row of its own.cap, the cap per pattern per container per window, inrateReceiverUnit.0exempts the container from every cap, the*row andrateReceiverAbsoluteCapincluded (the over-cap branch is skipped for it). A*row of0exempts every container without a row of its own, sorateReceiverAbsoluteCapthen applies to none of them.untilEpochSec, optional Unix-epoch (seconds) expiry. Past that, the entry becomes a no-op and the fallback cap applies.reason, optional free-text string for audit. Not used at runtime. Must not contain commas (would break CSV parsing).
Example:
container,cap
payment-service,4194304:1735689600:annual budget protection PAY-101
auth-service,2097152
istio-proxy,0:1735689600:exempt platform sidecar PLAT-42
Why this shape:
- Container-keyed, matching the regulator's container axis. The file's key is the same value the regulator's counters are bucketed by, so listed caps map 1:1 to counters without translation.
- Git-friendly: a human-readable declaration that lives in a config repo, reviewed via
PR,
git blame-d for who/why. - Self-healing: every entry can carry an explicit expiry, so forgotten caps eventually stop filtering instead of silently dropping production data forever.
- AI-editable: the Log10x MCP writes it. Its budget run (
log10x_setup_recurring) writes the file to the policy ConfigMap or commits it to the policy branch. Alog10x_configure_enginecall derives caps from a target percent or a monthly dollar budget and delivers them as itsdeliverysays: a PR against the gitops repo, a write to the policy ConfigMap, or no write (stdout_only). The cap file is the interface.
Error-class lines still pass by count. Past the cap, the levels in
rateReceiverKeepCounts pass that many lines per pattern per window, so a tight cap never
fully silences ERROR/CRITICAL traffic.
When rateReceiverCapLookupFile is unset, every container falls back to
rateReceiverAbsoluteCap (which itself defaults to 0 = disabled).
From a policy repo. With GH_ENABLED=true, the default is the GitHub policy lane's
mirrored copy of the repo's log10x/policy/caps.csv: ${GH_DEST}/log10x/policy/caps.csv, with
GH_DEST defaulting to ${java.io.tmpdir}/tenx/github (pipelines/gitops/config.yaml).
Each sync rewrites the copy in place, so the lookup hot-reloads. GH_ENABLED turns on
with true, True or TRUE, as the lane reads it, and with the Kubernetes ConfigMap lane
also on the GitHub copy wins: enable one lane. The policy folder must hold caps.csv
when the engine starts.
The file is hot-reloaded on in-place writes (the gitops pattern); a Kubernetes
ConfigMap mount won't reload because the CM swap is a symlink rename, not an
in-place write.
rateReceiverCapLookupRetain
Retention period for the per-container cap file before it is considered stale.
| Type | Default |
|---|---|
| Number | 300000 |
Defines the retention period (in milliseconds) for the cap file (rateReceiverCapLookupFile).
If the file's last modified time is older than this period, a warning is logged. The cap
entries continue to apply; the staleness check is advisory so operators notice when an
automated tooling pipeline has stopped updating the file.
Validation: Must be greater than 60000 milliseconds.
rateReceiverTotalLookupFile
Declarative per-service total file, keyed by the `rateReceiverContainerField` value; bounds what each capped service passes per window.
| Type | Default |
|---|---|
| String |
Defines the path to a declarative per-service total file (sibling to the cap file). Each
entry bounds what a service passes per window (rateReceiverResetIntervalMs) on this
regulator instance, in rateReceiverUnit. Read by the cap-file regulator classes, for
containers with a resolved cap.
Two rules apply once a service has a total:
- Largest first. When the service's caps alone let more than its total through in the previous window, every pattern's cap scales by total / that amount for the whole window, or by what they let through so far this window once that is larger, so the service's largest patterns are held first and its small ones keep passing. The scale follows the previous window, so the window after a storm is scaled by the storm for its whole length and recovers the window after. The first window after a quiet one fills its total in arrival order before the scale applies. A service whose first lines of this window and of the last window it sent in are two window lengths or more apart scales by total / its units so far this window instead.
- Hard bound. Once the lines the service passed reach its total, every further line takes
the service's action (
rateReceiverActionLookupFile).
The rateReceiverBaselineCount sample counts toward the total like any line, and once the total
is spent the service passes at most rateReceiverBaselineMaxOverTotal more sample lines in the
window. The rateReceiverKeepCounts lines count toward the total the same way, and once it is
spent the service passes at most rateReceiverKeepMaxOverTotal more of them in the window. The
lines an active mute entry passes always pass and count toward the total, so a muted pattern can
exceed it by that much.
File format (CSV; header row + one comma-separated entry per row):
container,total
<container>,<total>[:<untilEpochSec>][:<reason>]
*,<total>[:<untilEpochSec>][:<reason>]
container, value ofrateReceiverContainerField(the k8s container = the service), or*for every service without a row of its own.total, the service's total per window on this instance, inrateReceiverUnit.0exempts the service; a*row of0gives every service without a row of its own no total.untilEpochSec, optional Unix-epoch (seconds) expiry; past it the entry is a no-op.reason, optional free-text for audit. Must not contain commas (would break CSV parsing).
A missing file loads as an empty table, so no service has a total until a row names it. Each
regulator instance holds its own total; the MCP's budget run (log10x_setup_recurring)
divides a fleet total across instances.
From a policy repo. With GH_ENABLED=true, the default is the GitHub policy lane's
mirrored copy of the repo's log10x/policy/totals.csv: ${GH_DEST}/log10x/policy/totals.csv, with
GH_DEST defaulting to ${java.io.tmpdir}/tenx/github (pipelines/gitops/config.yaml).
Each sync rewrites the copy in place, so the lookup hot-reloads. GH_ENABLED turns on
with true, True or TRUE, as the lane reads it, and with the Kubernetes ConfigMap lane
also on the GitHub copy wins: enable one lane.
rateReceiverConfigGenerationFile
Optional config-generation file whose `generation` value is stamped as the `tenx_config_version` metric label.
| Type | Default |
|---|---|
| String |
Defines the path to the config-generation file the MCP control plane
(log10x_configure_engine) writes as a SIBLING of the cap file in the cap ConfigMap. It is a
two-column CSV (key,value) with one row, generation,<hash-of-caps>, where the generation
is a deterministic hash of the cap policy. The receiver's config-generation object reads that
value and stamps it on every event as tenx_config_version (declared in this module's
metricTagFields). The receiver's config_generation aggregator publishes it as one series per
generation, config_generation_summaryBytes_total{tenx_config_version=...}, so the running engine
advertises which config generation it loaded; the per-pattern counters do not carry it, so a
policy write does not restart their series. The MCP then verifies the policy it wrote is actually
live by comparing the label to hash(current caps), the config-generation closed loop.
Opt-in, and decoupled from caps. Unset by default (""); the tenx_config_version stamp is
emitted only when this points at a file. A receiver running the rate regulator WITHOUT the MCP
closed loop (e.g. GitOps-managed caps) leaves it unset and emits no tenx_config_version label.
It never depends on the file existing, so it can't fail init on a missing file. Set it only where
the MCP writes the file (via the CONFIG_GENERATION_FILE env or configGeneration.file in
config.yaml).
File format (CSV; header row + one row):
Hot-reloaded like the cap file, so a new generation written by configure_engine goes live
without an engine restart. This is exactly what the verifier observes as the stale -> live
transition.
From a policy repo. With GH_ENABLED=true, the default is the GitHub policy lane's
mirrored copy of the repo's log10x/policy/config-generation.csv: ${GH_DEST}/log10x/policy/config-generation.csv, with
GH_DEST defaulting to ${java.io.tmpdir}/tenx/github (pipelines/gitops/config.yaml).
Each sync rewrites the copy in place, so the lookup hot-reloads. GH_ENABLED turns on
with true, True or TRUE, as the lane reads it, and with the Kubernetes ConfigMap lane
also on the GitHub copy wins: enable one lane.
rateReceiverWarmupMs
Per-container grace period before this regulator instance starts capping.
| Type | Default |
|---|---|
| Number | 0 |
Defines an optional per-container grace period in milliseconds. A container is left
unregulated for this long after this regulator instance first sees its events. The default is
0: a container is capped from its first line, which is what a cap meant as a budget needs.
A positive value defers cap decisions while the per-pattern counts fill. This is a delay only; no learned baseline is built, and the only state that survives is the container's first-seen timestamp.
"First sees" is per regulator instance, not per container birth. A container that has been
running for hours but whose events have only just started flowing through this regulator
(e.g. after a regulator restart or forwarder reconnect) restarts the warmup window. On a
daemonset rolling restart the cap is therefore disabled for warmupMs per node as it cycles.
Set it for slow-ramping JVMs or workloads with long init phases whose first minutes should not be capped. Patterns that are legitimately dominant in steady state belong on the mute file, not in a warmup.
rateReceiverBaselineCount
Events per pattern kept each window regardless of share.
| Type | Default |
|---|---|
| Number | 5 |
Defines how many events of each (pattern, container) are kept per window regardless of the cap
and the share, so even a heavily-capped pattern leaves a small forensic sample to inspect during
an incident. In a service with a total (rateReceiverTotalLookupFile) the sample counts toward
it, and once the total is spent the service passes at most rateReceiverBaselineMaxOverTotal
more sample lines in the window.
rateReceiverBaselineMaxOverTotal
Sample lines a service passes per window once it has passed its total.
| Type | Default |
|---|---|
| Number | 50 |
Defines how many rateReceiverBaselineCount sample lines a service passes per window on this
regulator instance once it has passed its total (rateReceiverTotalLookupFile). Within the
total the sample passes like any line. Past it, sample lines pass up to this count, and the rest
take the regular path: the keep count for the levels in rateReceiverKeepCounts, then the
service's action. This bounds a service that prints many new patterns in one window, each of
which would otherwise pass its sample over the total.
The count is in lines whatever rateReceiverUnit is, like the sample and the keep counts, so
under bytes a service can exceed its total by this many of its own lines. 0 removes the
bound, so every sample line passes. Read by the cap-file regulators, for services with a total.
rateReceiverKeepMaxOverTotal
Keep-count lines a service passes per window once it has passed its total.
| Type | Default |
|---|---|
| Number | 500 |
Defines how many rateReceiverKeepCounts lines a service passes per window on this regulator
instance once it has passed its total (rateReceiverTotalLookupFile). Within the total a
keep-count line passes like any line. Past it, keep-count lines pass up to this count, and the
rest take the service's action. This bounds a service that prints many new error patterns in
one window, each of which would otherwise pass its keep count over the total.
The count is in lines whatever rateReceiverUnit is, like the keep counts, so under bytes a
service can exceed its total by this many of its own lines. 0 removes the bound, so every
keep-count line passes. The lines an active mute entry passes follow the entry and are not
counted here. Read by the cap-file regulators, for services with a total.
rateReceiverAbsoluteCap
Fleet-wide cap per pattern per container per window; `0` (default) disables the cap unless overridden per-container via `rateReceiverCapLookupFile`.
| Type | Default |
|---|---|
| Number | 0 |
Defines a fleet-wide cap, in rateReceiverUnit: the budget for a single pattern (a unique
combination of rateReceiverFieldNames values) per container within the current window
(rateReceiverResetIntervalMs). Applies to every container the regulator sees, unless that
container has its own entry, or the * entry, in rateReceiverCapLookupFile, which wins
per-event.
At or below the resolved cap the pattern is kept untouched. Above it, a line takes the
container's action, except the rateReceiverBaselineCount sample, the levels in
rateReceiverKeepCounts (that many lines per pattern per window), a pattern below
rateReceiverMinSharePercent of its container, and the rateReceiverSeverityFloors share of
the other levels.
0 (the default) disables the fleet-wide cap. With no fleet-wide cap and no per-container
entry in rateReceiverCapLookupFile, the regulator's over-cap branch never engages for that
container. Protection is strictly opt-in. Three configurations are first-class:
- Per-container only: set
rateReceiverCapLookupFile. Listed containers get their cap; unlisted containers are unregulated by the absolute cap. Most selective. - Fleet-wide only: set
rateReceiverAbsoluteCapto a positive integer. Applies to every container. - Both: per-container entries override the fleet-wide cap; unlisted containers fall back to the fleet-wide cap (safety floor).
Example: 10485760 (10 MB, with rateReceiverUnit bytes) means a pattern is held once it
has spent 10 MB in a container within the window.
With the shipped floors at 0 and the share guard off, the most one pattern in one container
passes per window is the larger of the cap and the baseline sample, plus the keep count for an
error-class pattern.
rateReceiverMinSharePercent
Minimum share of container volume below which a pattern is exempt from sampling.
| Type | Default |
|---|---|
| Number | 0 |
Defines an optional share-of-container guard (0.0 to 1.0): if a pattern is above its cap BUT
below this share of its container's volume, the regulator keeps it. The default is 0, which
turns the guard off, so a cap holds every pattern it is set for.
Share is (pattern units + event) / (container units + event) over the current window, in
rateReceiverUnit.
Example: 0.05 keeps a pattern above its cap while it represents less than 5% of its container's volume, for containers whose traffic is spread across many patterns.
rateReceiverIngestionCostPerGB
Vendor ingestion cost per GB in USD, for rendering savings in dollars.
| Type | Default |
|---|---|
| Number | 1.5 |
Defines the cost per GB charged by your observability vendor for log ingestion. Used only to render savings metrics in dollars (dropped bytes × cost per GB); it does not affect the keep/drop decision, which is driven by the byte cap.
Common vendor pricing (2025):
- Splunk Cloud: ~$1.50/GB (varies by contract, SKU)
- Datadog Logs: ~$0.10-$0.25/GB (depends on tier: standard, flex, online archives)
- Elastic Cloud: ~$0.109/GB (standard logging tier)
- New Relic: ~$0.30/GB (Data Plus)
- Sumo Logic: ~$1.50/GB (depends on plan)
- AWS CloudWatch Logs: ~$0.50/GB ingestion + $0.03/GB storage
- Azure Monitor Logs: ~$2.30/GB Analytics, $0.50/GB Basic, $0.05/GB Auxiliary (+ per-GB query fee).
This module is defined in rate/module.yaml.