{"id":24678728,"url":"https://github.com/Contrast-Security-Inc/contrast-semantic-conventions","last_synced_at":"2025-10-08T11:31:25.249Z","repository":{"id":263678252,"uuid":"891134120","full_name":"Contrast-Security-OSS/contrast-semantic-conventions","owner":"Contrast-Security-OSS","description":"Semantic Conventions that apply to Contrast sensors","archived":false,"fork":false,"pushed_at":"2024-11-20T17:22:44.000Z","size":4614,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-19T21:37:53.883Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Open Policy Agent","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Contrast-Security-OSS.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-19T19:37:13.000Z","updated_at":"2024-11-20T17:22:47.000Z","dependencies_parsed_at":"2024-11-19T21:36:57.213Z","dependency_job_id":null,"html_url":"https://github.com/Contrast-Security-OSS/contrast-semantic-conventions","commit_stats":null,"previous_names":["contrast-security-oss/contrast-semantic-conventions"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Contrast-Security-OSS%2Fcontrast-semantic-conventions","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Contrast-Security-OSS%2Fcontrast-semantic-conventions/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Contrast-Security-OSS%2Fcontrast-semantic-conventions/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Contrast-Security-OSS%2Fcontrast-semantic-conventions/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Contrast-Security-OSS","download_url":"https://codeload.github.com/Contrast-Security-OSS/contrast-semantic-conventions/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235706306,"owners_count":19032607,"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":"2025-01-26T13:18:04.373Z","updated_at":"2025-10-08T11:31:19.683Z","avatar_url":"https://github.com/Contrast-Security-OSS.png","language":"Open Policy Agent","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \u003cimg src=\"https://www.contrastsecurity.com/hubfs/favicon.png\" alt=\"Contrast Icon\" width=\"50\" height=\"\"\u003e Contrast Semantic Conventions\n\n[![Checks](https://github.com/Contrast-Security-OSS/contrast-semantic-conventions/workflows/Checks/badge.svg?branch=main)](https://github.com/Contrast-Security-OSS/contrast-semantic-conventions/actions?query=workflow%3A%22Checks%22+branch%3Amain)\n[![GitHub tag (latest SemVer)](https://img.shields.io/github/tag/open-telemetry/semantic-conventions.svg?logo=opentelemetry\u0026\u0026color=f5a800\u0026label=Latest%20release)](https://github.com/open-telemetry/semantic-conventions/releases/latest)\n[![Specification Version](https://img.shields.io/badge/OTel_specification_version-v1.37.0-blue?logo=opentelemetry\u0026color=f5a800)](https://github.com/open-telemetry/opentelemetry-specification/releases/tag/v1.37.0)\n\nThis repo is built on top of [this otel specification version][SpecificationVersion]\n\nSemantic Conventions are metric and attribute names that are defined so that they\nmean the same thing to all parties producing and consuming sensor data.\nRaw timeseries and span data are stored in schemaless datastores and thus there\nis not a strictly defined schema file. This design allows for agents to all be\nat various levels of support in what they produce while the consumers of the\ndata do the best with what they have.\n\nThe single source of truth of semantic convention definitions are the yaml\nfiles in the `model/` directory. These definitions are meant to be machine\nparsable so that model libraries can be generated for various languages.\n\nThe single source of truth for the semantic convention documentation are the\nmarkdown files in the `docs/` directory. This encapsulates the data in the\n`model/` directory in a human-digestible form.\n\nThe semantic convention definitions are used to fill in table data in the\nsemantic convention documentation. This is the same pattern as [opentelemetry's\nsemantic-convention](https://github.com/open-telemetry/semantic-conventions) repo.\nContrasts Security Observability builds on top of the existing semantic-conventions\nof opentelemetry and this contrast-semantic-conventions document should be\ninterpreted as an addendum to the core opentelemtry semantic conventions standard.\nThis standard will be used for all signal data sent by Contrast sensors to that\nproper dimensional correlation/association can be performed on the backend data\nacross all of our products.\n\n## Read the docs\n\nThe human-readable version of the semantic conventions resides in the [docs](docs/README.md) folder.\nMajor parts of these Markdown documents are generated from the YAML definitions located in the [model](model/README.md) folder.\n\n## Releases\n\nSemantic Conventions are versioned and the semantic version used by an agent is\nencoded as a Resource attribute. The backend will accept multiple semantic versions\nin use simultaneously by different agent instances.\n\nThe Contrast Semantic Conventions version will encompass the version of the addendum\nhere and the core semantic conventions version which is [v1.22.0](https://github.com/open-telemetry/semantic-conventions/releases/tag/v1.22.0)\nat the time of this writing.\n\n[SpecificationVersion]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.26.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FContrast-Security-Inc%2Fcontrast-semantic-conventions","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FContrast-Security-Inc%2Fcontrast-semantic-conventions","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FContrast-Security-Inc%2Fcontrast-semantic-conventions/lists"}