{"id":18767803,"url":"https://github.com/lightstep/cloud-native-observability","last_synced_at":"2025-12-09T21:30:17.066Z","repository":{"id":40350767,"uuid":"454639191","full_name":"lightstep/cloud-native-observability","owner":"lightstep","description":"An open access guide to Cloud-Native Observability.","archived":false,"fork":false,"pushed_at":"2022-10-12T00:54:12.000Z","size":4117,"stargazers_count":44,"open_issues_count":5,"forks_count":4,"subscribers_count":51,"default_branch":"main","last_synced_at":"2024-12-29T06:46:42.319Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc-by-sa-4.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lightstep.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-02-02T04:12:14.000Z","updated_at":"2024-09-05T05:28:32.000Z","dependencies_parsed_at":"2023-01-19T21:07:14.354Z","dependency_job_id":null,"html_url":"https://github.com/lightstep/cloud-native-observability","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lightstep%2Fcloud-native-observability","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lightstep%2Fcloud-native-observability/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lightstep%2Fcloud-native-observability/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lightstep%2Fcloud-native-observability/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lightstep","download_url":"https://codeload.github.com/lightstep/cloud-native-observability/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239671422,"owners_count":19677873,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-07T19:08:42.761Z","updated_at":"2025-12-09T21:30:17.015Z","avatar_url":"https://github.com/lightstep.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"![The Complete Guide to Cloud-Native Observability](./img/header.png)\n\n![Status](https://img.shields.io/badge/status-draft-blue?style=for-the-badge)\n![GitHub release (latest by date including\npre-releases)](https://img.shields.io/github/v/release/lightstep/cloud-native-observability?include_prereleases\u0026style=for-the-badge)\n![GitHub Repo stars](https://img.shields.io/github/stars/lightstep/cloud-native-observability?style=for-the-badge)\n\n# About This Project\n\n**What is the goal of this project?** To provide a clear, concise, and unbiased\noverview of cloud-native observability.\n\n**Why is that important?** Despite untold millions of marketing dollars spent in\nand around observability (or maybe _because_ of the untold millions of marketing\ndollars spent), cloud-native observability practice today is often inefficient,\nineffective, or both. It doesn't need to be that way.\n\n**Who is this for?** Observability and DevOps practitioners, SREs,\nend-users of observability systems, and anyone involved in building and running\ncloud-native software at scale.\n\n**How can you help?** You can contribute in several ways --\n\n* Adding your stories and learnings to [the \"Real World Examples\" directory](./real_world_examples/README.md)\n* Helping refine and shape this repository through\n  [contributions](./CONTRIBUTING.md)\n* Tackling a [good first\n  issue](https://github.com/lightstep/cloud-native-observability/labels/good%20first%20issue)\n* Giving us a star and sharing the repository!\n\nYou can also view the [project milestones](./CONTRIBUTING.md#milestones).\n\n## What We're Looking For\n\nCurrently, we would appreciate feedback (either via issues or pull requests) in\nthe following areas:\n\n* Overall structure and flow of the document.\n* Overall comprehension of the text/themes.\n* Un-defined, under-defined, or over-defined themes/concepts/terms.\n* General feedback on the ideas.\n* Illustrations and explanatory diagrams.\n\n---\n\n## Table of Contents\n\n\u003c!-- TODO: Add subsection links to TOC --\u003e\n\u003c!-- cspell:disable --\u003e\n\n* [README](./README.md)\n* [Foreword](\u003c./00 - foreword.md\u003e)\n* [Introduction](\u003c./01 - intro.md\u003e)\n  * [What's the point of software development, anyway?](\u003c./01 - intro.md#whats-the-point-of-software-development-anyway\u003e)\n  * [Why Cloud-Native Matters](\u003c./01 - intro.md#why-cloud-native-matters\u003e)\n* [End-users and Engineers, Transactions and Resources](\u003c./02 - end-users-and-engineers.md\u003e)\n  * [End-users](\u003c./02 - end-users-and-engineers.md#end-users\u003e)\n  * [Engineers](\u003c./02 - end-users-and-engineers.md#engineers\u003e)\n  * [Transactions](\u003c./02 - end-users-and-engineers.md#transactions\u003e)\n  * [Resources](\u003c./02 - end-users-and-engineers.md#resources\u003e)\n  * [SLIs and SLOs](\u003c./02 - end-users-and-engineers.md#slis-and-slos\u003e)\n* [The Anatomy of Observability](\u003c./03 - anatomy-of-observability.md\u003e)\n  * [Telemetry](\u003c./03 - anatomy-of-observability.md#telemetry\u003e)\n  * [Persistence](\u003c./03 - anatomy-of-observability.md#persistence\u003e)\n  * [Workflows](\u003c./03 - anatomy-of-observability.md#workflows\u003e)\n* [Telemetry Creation and OpenTelemetry](\u003c./04 - telemetry-creation-and-otel.md\u003e)\n  * [Instrumentation and Granularity](\u003c./04 - telemetry-creation-and-otel.md#instrumentation-and-granularity\u003e)\n  * [OpenTelemetry and Commodity Telemetry](\u003c./04 - telemetry-creation-and-otel.md#opentelemetry-and-commodity-telemetry\u003e)\n* [Effective Monitoring](\u003c./05 - effective-monitoring.md\u003e)\n  * [Effective Dashboards](\u003c./05 - effective-monitoring.md#effective-dashboards\u003e)\n  * [Effective Alerting](\u003c./05 - effective-monitoring.md#effective-alerting\u003e)\n  * [Fantastic SLOs and Where To Find Them](\u003c./05 - effective-monitoring.md#fantastic-slos-and-where-to-find-them\u003e)\n* [Effective Investigation](\u003c./06 - effective-investigation.md\u003e)\n  * [Context -- What Ties Everything Together](\u003c./06 - effective-investigation.md#context----what-ties-everything-together\u003e)\n  * [Guided Analysis vs. Data Exploration](\u003c./06 - effective-investigation.md#guided-analysis-vs.-data-exploration\u003e)\n  * [Tagging and Cardinality](\u003c./06 - effective-investigation.md#tagging-and-cardinality\u003e)\n* [Effective SLOs](\u003c./07 - effective-slo.md\u003e)\n  * [Counting the Uncountable](\u003c./07 - effective-slo.md#counting-the-uncountable\u003e)\n  * [Pushing the Envelope](\u003c./07 - effective-slo.md#pushing-the-envelope\u003e)\n* [Telemetry ROI -- The Elephant in the Room](\u003c./08 - telemetry-roi.md\u003e)\n  * [Costs Go Up, ROI Goes Down -- You Can Explain That](\u003c./08 - telemetry-roi.md#costs-go-up-roi-goes-down----you-can-explain-that\u003e)\n  * [The Predictive Value of Telemetry](\u003c./08 - telemetry-roi.md#the-predictive-value-of-telemetry\u003e)\n  * [Cost Reduction Strategies](\u003c./08 - telemetry-roi.md#cost-reduction-strategies\u003e)\n* [Organizational Concerns](\u003c./09 - organizational-concerns.md\u003e)\n  * [Combating the 'Three Pillars' ideology](\u003c./09 - organizational-concerns.md#combating-the-three-pillars-ideology\u003e)\n  * [Build, Buy, and Everything Inbetween](\u003c./09 - organizational-concerns.md#build-buy-and-everything-between\u003e)\n  * [Organizing Effective Observability Through Centralization](\u003c./09 - organizational-concerns.md#organizing-effective-observability-through-centralization\u003e)\n* [Glossary](\u003c./10 - glossary.md\u003e)\n\u003c!-- cspell:enable --\u003e\n---\n\n## Contributing\n\nWe gladly accept pull requests! Please see [CONTRIBUTING.md](./CONTRIBUTING.md)\nfor more.\n\n## Special Thanks\n\nThis guide is made possible thanks to salary-paying by [Lightstep](https://lightstep.com).\n\nWe'd love for you to check out our report on [how OpenTelemetry drives the\nfuture of observability](http://go.lightstep.com/register-oreilly-future-of-observability.html)\nas a companion to this whitepaper.\n\n---\n\nThis work is licensed under a\n[Creative Commons Attribution-ShareAlike 4.0 International License][cc-by-sa].\n\n[![CC BY-SA 4.0][cc-by-sa-image]][cc-by-sa]\n\n[cc-by-sa]: http://creativecommons.org/licenses/by-sa/4.0/\n[cc-by-sa-image]: https://licensebuttons.net/l/by-sa/4.0/88x31.png\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flightstep%2Fcloud-native-observability","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flightstep%2Fcloud-native-observability","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flightstep%2Fcloud-native-observability/lists"}