- C# 99.2%
- Shell 0.8%
Kai Siren
778bc5a429Part of the agentic-os-kai#505 load-point framework rollout. closes coilysiren/eco-telemetry#13 Audit-log: coily://1780119203/AGPHOX3P - coily git commit |
||
|---|---|---|
| .agents/skills/eco-telemetry | ||
| .claude | ||
| .coily | ||
| .github/workflows | ||
| Configs | ||
| docs | ||
| src | ||
| .gitignore | ||
| .pre-commit-config.yaml | ||
| AGENTS.md | ||
| CLAUDE.md | ||
| EcoTelemetry.csproj | ||
| LICENSE | ||
| README.md | ||
EcoTelemetry
OpenTelemetry-backed observability for Eco game servers. Exports exceptions, runtime metrics, simulation perf, and traces over OTLP so server admins can point them at Sentry, Grafana, Datadog, Honeycomb, or any other OTLP-compatible backend.
Eco's built-in stats system is designed for in-game economic and ecological reporting. It does not surface SRE-shaped signals: process health, exception rates, simulation tick latency, or web-request latency. EcoTelemetry fills that gap.
Status
Early. v1 ships:
- Logs: exception capture (
AppDomain.UnhandledException, optionalFirstChanceException) and an EcoILogWriterdecorator that mirrors the server's own log lines through OTel. - Metrics: runtime instrumentation (GC, threadpool, allocations) plus
eco.players.online. Each signal can route to its own OTLP endpoint via per-signal overrides.
Traces are stubbed.
Install
- Download
EcoTelemetry-<version>.zipfrom the latest release. - Extract into your Eco server's
Mods/directory so the result looks likeMods/EcoTelemetry/EcoTelemetry.dll. - Copy
Configs/EcoTelemetry.example.jsontoConfigs/EcoTelemetry.jsonand edit:OtlpEndpoint: your collector's OTLP HTTP or gRPC endpointOtlpHeaders: any auth headers (e.g.x-honeycomb-team=...or Sentry's auth header)ServiceName,ResourceAttributes: how this server identifies itself- per-signal toggles:
EnableLogs,EnableMetrics,EnableTraces
- Restart the Eco server.
If OtlpEndpoint is empty, EcoTelemetry falls back to the console exporter so you can verify the pipeline locally before pointing it at a real backend.
Build
dotnet build EcoTelemetry.csproj -c Release
The build pulls Eco.ReferenceAssemblies from NuGet for type-checking. The DLL plus its OpenTelemetry dependencies must be deployed together — see .github/workflows/release.yml for how the release artifact is assembled.
Routing signals
Each signal (logs, metrics) can target its own OTLP endpoint via the OtlpLogsEndpoint / OtlpMetricsEndpoint overrides; anything left blank falls back to the top-level OtlpEndpoint. Empty everywhere means console exporter (handy for first-boot smoke test).
Sentry (logs)
Sentry's OTLP endpoint is documented at https://docs.sentry.io/platforms/javascript/install/cdn/#using-opentelemetry:
OtlpLogsEndpoint:https://o<org>.ingest.sentry.io/api/<project>/otlp/v1/logsOtlpLogsHeaders:x-sentry-auth=Sentry sentry_key=<dsn-public-key>
VictoriaMetrics (metrics)
vmsingle exposes a native OTLP ingest endpoint at /opentelemetry/api/v1/push on its HTTP API port (8428 by default). No auth header required.
OtlpMetricsEndpoint:http://<vmsingle-host>:8428/opentelemetry/api/v1/pushOtlpMetricsProtocol:HttpProtobuf
Any OTLP-capable backend (Honeycomb, Grafana Cloud, OTel Collector) works the same way - there is no backend-specific code path.
Public sources
EcoTelemetry is built against Eco.ReferenceAssemblies and the public modding documentation at https://wiki.play.eco/en/Modding, https://docs.play.eco/, and https://github.com/StrangeLoopGames/EcoModKit.
License
MIT. See LICENSE.
Commands
Dev commands are declared in .coily/coily.yaml. Run them as coily exec <verb>.
See also
- AGENTS.md - agent-facing operating rules.
- docs/FEATURES.md - inventory of what ships today.
- .coily/coily.yaml - allowlisted commands.
Cross-reference convention from coilysiren/agentic-os#59.