Skip to main content

Using sovdev-logger

For people using sovdev-logger in their application — install, configure, log. Not for people implementing or maintaining the library itself; see Contributor documentation for that.

Quickstart per language

Package READMEs stay the canonical, up-to-date source — not duplicated here (see Q2 in the documentation-strategy investigation for why):

  • TypeScript README — complete API reference, examples, patterns (canonical — other languages diff against this)
  • Python README — complete API reference, notes differences from TypeScript

Pages

  • Azure integration — why standard OpenTelemetry rather than Azure's own distro, and how the same code runs locally and in Azure.
  • Configuration — environment variables, OTLP setup, file logging.
  • Logging concepts — distributed tracing with spans, when to use them.
  • Log data structure — field reference, logging patterns, correlation strategies.
  • Observability architecture — dashboard setup, service name naming, verification.
  • Onboarding a new system — connecting a new application to the shared Grafana Cloud stack: a dedicated token, standard OTLP env vars, and it just shows up in the existing dashboard. Includes real experience reports, starting with ollacrm.
  • Dashboard walkthrough — every panel of the sovdev-logger dashboard, paired with the exact code that produces it.
  • Loggeloven compliance — Norwegian Red Cross logging requirements.