# LoadStrike Observability Assets Guide

This download groups the public starter assets for the built-in LoadStrike reporting sinks.

## Asset Types

- Grafana starter assets for `InfluxDbReportingSink`, `TimescaleDbReportingSink`, and `GrafanaLokiReportingSink`
- JSON infra-config templates for `DatadogReportingSink`, `SplunkReportingSink`, and `OtelCollectorReportingSink`

## What The Sinks Export

All built-in sinks export reporting events plus metric projections.

- Realtime scenario and step statistics
- Custom metrics
- Final run summaries and final metric snapshots
- Status-code rows, threshold outcomes, and plugin-table rows
- Started/completed timestamps
- Run-result metadata such as report files, disabled sinks, and sink errors

## Storage Split Options

Some sinks expose extra options for separating projected metrics from the main event stream.

- `InfluxDbReportingSink`: `MetricsMeasurementName`
- `TimescaleDbReportingSink`: `MetricsTableName`
- `GrafanaLokiReportingSink`: `MetricsBaseUrl`, `MetricsEndpointPath`, and `MetricsHeaders` for the OTLP/HTTP companion metrics stream

## Grafana Starter Assets

Use these files when your LoadStrike run writes to InfluxDB, TimescaleDB, or Grafana Loki and you want a ready-made Grafana starting point.

- Datasource YAML files:
  - `/downloads/grafana/provisioning/datasources/loadstrike-influxdb.yaml`
  - `/downloads/grafana/provisioning/datasources/loadstrike-timescaledb.yaml`
  - `/downloads/grafana/provisioning/datasources/loadstrike-loki.yaml`
- Shared dashboard provider YAML:
  - `/downloads/grafana/provisioning/dashboards/loadstrike.yaml`
- Starter dashboard JSON files:
  - `/downloads/grafana/dashboards/loadstrike-influxdb-overview.json`
  - `/downloads/grafana/dashboards/loadstrike-timescaledb-overview.json`
  - `/downloads/grafana/dashboards/loadstrike-loki-overview.json`

Typical Grafana container paths:

- `/etc/grafana/provisioning/datasources`
- `/etc/grafana/provisioning/dashboards`
- `/var/lib/grafana/dashboards/loadstrike`

## Vendor Template Downloads

Use these templates when you want to bind sink settings from infra config instead of hardcoding them.

- Datadog:
  - `/downloads/observability/sinks/loadstrike-datadog-reporting-sink.json`
- Splunk HEC:
  - `/downloads/observability/sinks/loadstrike-splunk-reporting-sink.json`
- OTEL Collector:
  - `/downloads/observability/sinks/loadstrike-otel-collector-reporting-sink.json`

## How To Use A Template

1. Download the template that matches your sink.
2. Replace the placeholder endpoint, token, key, and tag values.
3. Load the file through `LoadInfraConfig(...)`.
4. Register the matching built-in sink in your runner.

Example:

```csharp
LoadStrikeRunner.RegisterScenarios(scenario)
    .LoadInfraConfig("./loadstrike-datadog-reporting-sink.json")
    .WithReportingSinks(new DatadogReportingSink())
    .WithRunnerKey("rkl_your_local_runner_key")
    .Run();
```

## Sink Mapping

- `InfluxDbReportingSink`: Grafana datasource YAML + dashboard provider YAML + InfluxDB dashboard JSON
- `TimescaleDbReportingSink`: Grafana datasource YAML + dashboard provider YAML + TimescaleDB dashboard JSON
- `GrafanaLokiReportingSink`: Grafana datasource YAML + dashboard provider YAML + Loki dashboard JSON
- `DatadogReportingSink`: Datadog infra-config JSON template
- `SplunkReportingSink`: Splunk infra-config JSON template
- `OtelCollectorReportingSink`: OTEL Collector infra-config JSON template