Skip to content

feat: add semantic conventions for gce instance labels#2617

Open
paulojmdias wants to merge 9 commits intoopen-telemetry:mainfrom
paulojmdias:feat/35859
Open

feat: add semantic conventions for gce instance labels#2617
paulojmdias wants to merge 9 commits intoopen-telemetry:mainfrom
paulojmdias:feat/35859

Conversation

@paulojmdias
Copy link
Copy Markdown
Member

Relates to open-telemetry/opentelemetry-collector-contrib#41919

Changes

This change introduces a new templated attribute for Google Compute Engine instance labels.
The attribute prefix gcp.gce.instance.labels. follows the existing GCP/GCE naming scheme and aligns with current semantic conventions for similar resources (e.g., container.label).

Merge requirement checklist

  • CONTRIBUTING.md guidelines followed.
  • Change log entry added, according to the guidelines in When to add a changelog entry.
    • If your PR does not need a change log, start the PR title with [chore]
  • Links to the prototypes or existing instrumentations (when adding or changing conventions)

Signed-off-by: Paulo Dias <paulodias.gm@gmail.com>
@paulojmdias paulojmdias requested review from a team as code owners August 12, 2025 21:10
@github-actions github-actions Bot added the enhancement New feature or request label Aug 12, 2025
@paulojmdias paulojmdias changed the title feat: add semantic conventions for gce instance labelsa feat: add semantic conventions for gce instance labels Aug 12, 2025
Copy link
Copy Markdown
Member

@ridwanmsharif ridwanmsharif left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Makes sense to me from the GCP side of things. Will wait for semconv approvers for a review

Copy link
Copy Markdown
Contributor

@thompson-tomo thompson-tomo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I feel that we should add this to the host namespace for maximum interoperability and work towards phasing out the dedicated gce namespace as the need is currently very low.

Comment thread model/gcp/registry.yaml Outdated
Comment on lines +198 to +207
- id: gcp.gce.instance.labels
type: template[string]
stability: development
brief: >
GCE instance labels, `<key>` being the label name and the value being the label value.
note: >
For example, a GCE instance label `env` with value `prod` SHOULD be recorded as the
`gcp.gce.instance.labels.env` attribute with value `"prod"`.
The `<key>` MUST be the exact GCE instance label key.
examples: [ 'prod' ]
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would prefer to see this in the host namespace given the reusability potential.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is against the direction we're taking in the entities SIG

Copy link
Copy Markdown
Member Author

@paulojmdias paulojmdias Aug 22, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Understood, either way, I also updated the example to be something more agnostic than the environment

@jsuereth
Copy link
Copy Markdown
Contributor

This seems highly related to a new SIG forming - open-telemetry/community#2837

I'm supportive of adding these labels now, but I also think we should track the long term direction here, as there may be other places we want these labels.

Comment thread model/gcp/registry.yaml
Signed-off-by: Paulo Dias <paulodias.gm@gmail.com>
Signed-off-by: Paulo Dias <paulodias.gm@gmail.com>
@github-actions
Copy link
Copy Markdown

github-actions Bot commented Sep 7, 2025

This PR was marked stale due to lack of activity. It will be closed in 7 days.

@github-actions github-actions Bot added the Stale label Sep 7, 2025
@paulojmdias
Copy link
Copy Markdown
Member Author

/label never-stale -stale

@lmolkova lmolkova removed the Stale label Sep 7, 2025
@github-actions
Copy link
Copy Markdown

This PR was marked stale due to lack of activity. It will be closed in 7 days.

@github-actions github-actions Bot added the Stale label Sep 23, 2025
@paulojmdias
Copy link
Copy Markdown
Member Author

/label -stale never-stale

@github-actions github-actions Bot removed the Stale label Sep 24, 2025
@github-actions
Copy link
Copy Markdown

github-actions Bot commented Oct 9, 2025

This PR was marked stale due to lack of activity. It will be closed in 7 days.

@github-actions github-actions Bot added the Stale label Oct 9, 2025
@paulojmdias
Copy link
Copy Markdown
Member Author

/label -stale

@github-actions github-actions Bot removed the Stale label Oct 10, 2025
@github-actions
Copy link
Copy Markdown

This PR was marked stale due to lack of activity. It will be closed in 7 days.

@dashpole dashpole reopened this Feb 3, 2026
@github-actions
Copy link
Copy Markdown

This PR has been labeled as stale due to lack of activity. It will be automatically closed if there is no further activity over the next 7 days.

@github-actions github-actions Bot added the Stale label Feb 18, 2026
@paulojmdias
Copy link
Copy Markdown
Member Author

/label -stale

@github-actions github-actions Bot removed the Stale label Feb 19, 2026
@github-actions
Copy link
Copy Markdown

github-actions Bot commented Mar 6, 2026

This PR has been labeled as stale due to lack of activity. It will be automatically closed if there is no further activity over the next 7 days.

@github-actions github-actions Bot added the Stale label Mar 6, 2026
@paulojmdias
Copy link
Copy Markdown
Member Author

/label -stale

@github-actions github-actions Bot removed the Stale label Mar 7, 2026
@github-actions
Copy link
Copy Markdown

This PR has been labeled as stale due to lack of activity. It will be automatically closed if there is no further activity over the next 7 days.

@github-actions github-actions Bot added the Stale label Mar 21, 2026
@paulojmdias
Copy link
Copy Markdown
Member Author

/label -stale

@github-actions github-actions Bot removed the Stale label Mar 22, 2026
@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 5, 2026

This PR has been labeled as stale due to lack of activity. It will be automatically closed if there is no further activity over the next 7 days.

@github-actions github-actions Bot added the Stale label Apr 5, 2026
@paulojmdias
Copy link
Copy Markdown
Member Author

/label -stale

@github-actions github-actions Bot removed the Stale label Apr 6, 2026
@github-actions
Copy link
Copy Markdown

This PR has been labeled as stale due to lack of activity. It will be automatically closed if there is no further activity over the next 7 days.

@github-actions github-actions Bot added the Stale label Apr 21, 2026
@paulojmdias
Copy link
Copy Markdown
Member Author

/label -stale

@github-actions github-actions Bot removed the Stale label Apr 22, 2026
@lmolkova lmolkova moved this from Untriaged to Needs More Approval in Semantic Conventions Triage Apr 27, 2026
@lmolkova lmolkova moved this from Needs More Approval to Ready to be Merged in Semantic Conventions Triage Apr 27, 2026
@jsuereth jsuereth enabled auto-merge April 27, 2026 15:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Status: Ready to be Merged

Development

Successfully merging this pull request may close these issues.

6 participants