Claude Skill

otel-telemetry-emissions

Version-pinned inventory of the telemetry (spans, metrics, logs, attributes) emitted by OpenTelemetry collector components and SDK instrumentation packages. Use when working with a covered component — what it emits at a given version, or how emission changed across versions — and

LLM Mart · 0 points · 0 views 0 listing impressions 0 install-command copies
Virus-scanned Reviewed automatically before listing.

Full trust report

Download ollygarden-opentelemetry-agent-skills-skills_otel-telemetry-emissions-9671795.zip · 655 KB
ollygarden/opentelemetry-agent-skills 111 13 forks Apache-2.0 Updated 11h ago
Part of ollygarden/opentelemetry-agent-skills — 19 skills

Install

skills CLI npx skills add https://github.com/ollygarden/opentelemetry-agent-skills/tree/main/skills/otel-telemetry-emissions
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install ollygarden-opentelemetry-agent-skills@llmmart
Git git clone https://github.com/ollygarden/opentelemetry-agent-skills.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole ollygarden/opentelemetry-agent-skills collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

Telemetry Emissions

A registry of what telemetry OpenTelemetry components actually emit, pinned to upstream versions.

Note: The telemetry emissions in these files were detected by LLM analysis of the upstream source and may contain errors. Verify against the component's source or docs before relying on a row for critical decisions.

Layout

<repo basename>/<path in repo>/v<version>.md

Example: opentelemetry-collector-contrib/receiver/kafkareceiver/v0.158.0.md

One file per scanned version. The files in a component directory are its telemetry history; index.md lists every file — start there to see what is covered.

Looking up a component at a version

  1. Find the component's directory (or its row in index.md).
  2. Pick the file matching the target version exactly.
  3. If there is no exact match, use the file with the highest version below the target and say the exact version is unverified.
  4. If the component or version is not covered at all, say so — do not infer telemetry from semantic conventions.

What a data file contains

Frontmatter (repo, path, version, scope_name, commit_sha, last_verified), then per-signal tables:

  • Traces — span name, kind, attributes, notes
  • Metrics — metric name, instrument type, unit, attributes, notes
  • Logs — log/event name, attributes, notes

scope_name is the component's instrumentation scope — the anchor for matching runtime telemetry back to the component. When helper or pipeline telemetry uses another scope, its rows name that scope in Notes. last_verified: null means the historical verification date could not be substantiated; recheck the pinned source before presenting its rows as verified. Absent signals are omitted entirely. Notes marks conditional emission (feature gates, opt-in config, experimental semconv). Sources lists the upstream files the data came from.

Files (opentelemetry-agent-skills)
  • evals
    • evals.json 3.7 KB 
      {
  "skill": "otel-telemetry-emissions",
  "runtime": "Claude Code 2.1.258",
  "model": "claude-sonnet-5",
  "cases": [
    {
      "id": "prometheusremotewrite-v0159-metrics",
      "prompt": "Which metrics does the OpenTelemetry Collector prometheusremotewriteexporter emit at v0.159.0? For each metric give the name, instrument type, unit, and attributes, and say which metrics are emitted only under a condition. Do not modify files or contact an endpoint.",
      "expectations": [
        "Names all 16 metrics under the otelcol_exporter_prometheusremotewrite_ prefix: consumers, failed_translations, sent_batches, translated_time_series, the nine wal_* metrics, and written_exemplars, written_histograms and written_samples.",
        "States that the nine wal_* metrics are emitted only when the wal config block is set, and that v0.159.0 adds the exporter attribute to them where earlier versions emit them with no attributes.",
        "States that written_samples, written_histograms and written_exemplars need Remote Write 2.0 — the exporter.prometheusremotewritexporter.enableSendingRW2 feature gate together with protobuf_message: io.prometheus.write.v2.Request.",
        "Gives correct instrument types and units: consumers is a non-monotonic Sum in {consumer}, wal_lag is a Gauge, wal_read_latency and wal_write_latency are Histograms in ms, and the remaining counters are monotonic Sums."
      ]
    },
    {
      "id": "prometheusremotewrite-written-headers",
      "prompt": "For the OpenTelemetry Collector prometheusremotewriteexporter at v0.159.0, which response header does each of the three otelcol_exporter_prometheusremotewrite_written_* metrics read its value from? Then say what would explain written_exemplars staying at zero while written_samples increases. Do not modify files or make network requests.",
      "expectations": [
        "Names X-Prometheus-Remote-Write-Samples-Written as the response header that written_samples is read from.",
        "Names X-Prometheus-Remote-Write-Histograms-Written as the response header that written_histograms is read from.",
        "Names X-Prometheus-Remote-Write-Exemplars-Written as the response header that written_exemplars is read from.",        
        "States that each metric is read from its own header, so a backend that returns Samples-Written but omits Exemplars-Written leaves written_exemplars at zero while written_samples increases."      
      ]
    },
    {
      "id": "prometheusremotewrite-version-coverage",
      "prompt": "Which metrics does the OpenTelemetry Collector prometheusremotewriteexporter emit at v0.160.0? For each metric give the name, instrument type, unit, and attributes, and say which metrics are emitted only under a condition. State the exact version your answer is verified against. Do not modify files or contact an endpoint.",
      "expectations": [
        "Answers from a source pinned to v0.160.0 and states that v0.160.0 is the verified version, rather than answering from v0.159.0 or a lower version and marking the result unverified.",
        "Names all 16 metrics under the otelcol_exporter_prometheusremotewrite_ prefix: consumers, failed_translations, sent_batches, translated_time_series, the nine wal_* metrics, and written_exemplars, written_histograms and written_samples.",
        "States that the nine wal_* metrics are emitted only when the wal config block is set, and carry the exporter attribute at v0.160.0.",
        "States that written_samples, written_histograms and written_exemplars need Remote Write 2.0 — the exporter.prometheusremotewritexporter.enableSendingRW2 feature gate together with protobuf_message: io.prometheus.write.v2.Request — and that each one is read from its own X-Prometheus-Remote-Write-*-Written response header."
      ]
    }
  ]
}
    • results.md 17.7 KB 
      # `otel-telemetry-emissions` harness results

One section per harness run, newest first.

## PR #242 — written-counts response headers

Run with Claude Code 2.1.259 driving `claude-sonnet-5`. Three cases, three arms, three
repetitions each: 27 runs. Cases 1 and 2 ran on 2026-09-04. Case 3 was added on 2026-09-05,
after a maintainer asked this PR to also carry the v0.160.0 file. Every repetition used a
fresh session, an isolated `CLAUDE_CONFIG_DIR`, an empty working directory outside this
repository, and the same tool access: `Read`, `Glob` and `Grep` only. No arm had network
access.

Cases 1 and 2 ran before v0.160.0 was added, so their proposed arm held only v0.154.0 to
v0.159.0. Those six files are byte-identical in both batches and both cases pin v0.159.0, but
that arm is not literally the one case 3 ran against. Cases 1 and 2 were not re-run.

Every arm — not only the withheld one — ran inside the same `bwrap` sandbox, which mounted an
empty `tmpfs` over the checkout of this repository. See "Method corrections" below for why.
The `evals/` directory was removed from the skill copy in all three arms, so no arm could read
the expectations it was graded against. Only the target skill differed between arms.

Grading was done by reading each final answer against the prose expectations in `evals.json`.
No grader script was used. No repetition was retried, and no repetition was excluded by
outcome.

| Arm | Target-skill revision / state | Cases × reps | Pass | Fail | Unknown |
|---|---|---:|---:|---:|---:|
| Target skill withheld | `Withheld` | 3 × 3 | 2 | 7 | 0 |
| Current `origin/main` skill | `1bf950f6101e0c66840dce5c873070ff6f47b582` | 3 × 3 | 6 | 3 | 0 |
| Proposed PR skill | `995864d7372a09b3257784a554dc58672784b7a9` | 3 × 3 | 9 | 0 | 0 |

### Per-attempt grading — `prometheusremotewrite-v0159-metrics`

`A` is all 16 metric names, `B` is the `wal` condition with the v0.159.0 `exporter` attribute,
`C` is the Remote Write 2.0 gate and config, and `D` is the instrument types and units.

| Attempt | A | B | C | D | Result |
|---|---|---|---|---|---|
| `case1-withheld-1` | fail | fail | fail | fail | fail |
| `case1-withheld-2` | fail | fail | fail | fail | fail |
| `case1-withheld-3` | fail | fail | fail | fail | fail |
| `case1-current-1` | pass | pass | pass | pass | pass |
| `case1-current-2` | pass | pass | pass | pass | pass |
| `case1-current-3` | pass | pass | pass | pass | pass |
| `case1-proposed-1` | pass | pass | pass | pass | pass |
| `case1-proposed-2` | pass | pass | pass | pass | pass |
| `case1-proposed-3` | pass | pass | pass | pass | pass |

### Per-attempt grading — `prometheusremotewrite-written-headers`

`A` is the `Samples-Written` header, `B` is `Histograms-Written`, `C` is `Exemplars-Written`,
and `D` is the one-header-per-metric consequence for a backend that omits the exemplars header.

| Attempt | A | B | C | D | Result |
|---|---|---|---|---|---|
| `case2-withheld-1` | fail | fail | fail | pass | fail |
| `case2-withheld-2` | pass | pass | pass | pass | pass |
| `case2-withheld-3` | pass | pass | pass | pass | pass |
| `case2-current-1` | pass | pass | pass | pass | pass |
| `case2-current-2` | pass | pass | pass | pass | pass |
| `case2-current-3` | pass | pass | pass | pass | pass |
| `case2-proposed-1` | pass | pass | pass | pass | pass |
| `case2-proposed-2` | pass | pass | pass | pass | pass |
| `case2-proposed-3` | pass | pass | pass | pass | pass |

### Per-attempt grading — `prometheusremotewrite-version-coverage`

`A` is answering from a source pinned to v0.160.0, `B` is all 16 metric names, `C` is the
`wal` condition with the `exporter` attribute, and `D` is the Remote Write 2.0 gate together
with the response header each `written_*` metric reads.

| Attempt | A | B | C | D | Result |
|---|---|---|---|---|---|
| `case3-withheld-1` | fail | fail | fail | fail | fail |
| `case3-withheld-2` | fail | fail | fail | fail | fail |
| `case3-withheld-3` | fail | fail | fail | fail | fail |
| `case3-current-1` | fail | pass | pass | fail | fail |
| `case3-current-2` | fail | pass | pass | fail | fail |
| `case3-current-3` | fail | pass | pass | fail | fail |
| `case3-proposed-1` | pass | pass | pass | pass | pass |
| `case3-proposed-2` | pass | pass | pass | pass | pass |
| `case3-proposed-3` | pass | pass | pass | pass | pass |

### What differed

**Case 3 separates the arms.** The proposed skill passed 12 of 12 expectations, `origin/main`
6 of 12, and the withheld arm 0 of 12. The whole gap is version coverage. `origin/main` has no
v0.160.0 file, so all three of its runs fell back to v0.159.0 and marked the answer unverified
— the behaviour `SKILL.md` prescribes when no file matches the target version exactly. The
behaviour was correct and the data was absent. The proposed skill matched v0.160.0 exactly and
cited its `commit_sha` in all three runs. The withheld arm answered none of the three, and
asked for network access rather than reply from recall.

**Cases 1 and 2 are a null result.** The proposed arm scored the same as the `origin/main`
arm: 12/12 expectations on case 1 and 12/12 on case 2. On those two cases, the header fix does
not improve agent output.

**Case 2 cannot separate the arms.** Two of the three *withheld* runs named all three headers
correctly with no skill installed. The model holds these header names in prior knowledge, so a
prompt that asks for them directly is answered with or without the registry. Only
`case2-withheld-1` got them wrong, inverting the word order to
`X-Prometheus-Remote-Write-Written-Samples`. The case is retained because it documents the fix
and will catch a future regression in the data file, not because it discriminates today.

**The measurable difference sits in case 1, and no expectation covers it.** Case 1 does not ask
where a metric's value comes from, so the agent reports whatever the data file says. On
`origin/main`, two of three runs reproduced `X-Prometheus-Remote-Write-Samples-Written`-family
verbatim — the wording this PR removes — while the third generalised to the correct
`X-Prometheus-Remote-Write-*-Written` pattern. On the proposed skill, two of three runs gave
the exact per-metric mapping and the third did not mention headers at all. No run on the
proposed skill reproduced the misleading wording, and no run on `origin/main` gave the correct
per-metric mapping.

**The defect reproduced itself in case 3, unprompted.** `case3-current-2` wrote that the
values are "read from `X-Prometheus-Remote-Write-Samples-Written`-family response headers" —
the wording this PR removes — in answer to a question that never mentioned headers.
`case3-current-1` omitted the headers entirely and `case3-current-3` generalised to the
correct `X-Prometheus-Remote-Write-*-Written` pattern. All three proposed runs gave the exact
per-metric mapping. Across cases 1 and 3, three of six `origin/main` runs copied the wrong
string and no proposed run did.

So the two halves of this PR do different work. The header fix stops a wrong string from
reaching answers, and adds no capability, which is why cases 1 and 2 show parity. The v0.160.0
file adds coverage, and case 3 measures it.

**No regression.** Every expectation that passed on `origin/main` also passed on the proposed
skill, in all three repetitions of all three cases.

### Failing runs kept, and why

All ten failures are preserved. None was retried.

- `case1-withheld-1`, `case1-withheld-2` and `case1-withheld-3` had no registry to read.
  Rep 1 answered about `target_info` and `otel_scope_info`, which the question did not ask
  about; reps 2 and 3 named two of the 16 metrics from recall and flagged their own confidence
  as moderate. All three offered to fetch the upstream source. Genuine misses.
- `case2-withheld-1` gave the header names with the word order inverted, and passed only the
  fourth expectation.
- `case3-withheld-1`, `case3-withheld-2` and `case3-withheld-3` declined to answer. Each asked
  for `WebFetch` or `gh api` access to read the upstream source at the v0.160.0 tag. Run 2
  reported that it had checked the `otel-collector` skill and found it "verified only against
  v0.159.0", documenting configuration rather than the exporter's own self-observability
  metrics. Genuine misses, and evidence that no other skill in this repository carries the
  data.
- `case3-current-1`, `case3-current-2` and `case3-current-3` failed the version expectation
  because `origin/main` has no v0.160.0 file. Each fell back to v0.159.0 and said so, which is
  what `SKILL.md` instructs. The runs are graded as failures against the case, not as faults
  in the shipping skill.

### Method corrections

Two earlier batches of 18 runs, and one batch of three, were discarded. All are preserved
outside the repository. They are recorded here because they changed the method, not because
they changed a score.

1. **The first batch leaked.** The withheld arm removed the skill from its config directory,
   but the repository still sat on disk and `Read` accepts absolute paths. One run globbed `/`,
   found this checkout, and answered case 1 from the working tree — reproducing the corrected
   headers and the file's own `commit_sha` and `last_verified`. The other 17 runs of that batch
   were clean. Every arm now runs under `bwrap` with the checkout hidden, so the arms stay
   identical and no arm can reach it.
2. **Case 2 was rewritten after its first run.** The original prompt opened with a symptom —
   "`written_exemplars` stays at zero while `written_samples` increases" — and scored 0/9 on
   the proposed arm. The transcripts showed why: all three runs answered from the
   `otel-collector` skill's `prometheus_remote_write` pages and never opened the emissions
   registry. The case measured which skill a troubleshooting question routes to, not the data
   under test. It was rewritten to lead with the lookup — "which response header does each of
   the three `written_*` metrics read its value from" — and a fourth expectation was added for
   the histograms header, which the new prompt brings into scope. The rewrite fixed retrieval
   and produced the null result above. The instrument was changed once, for a stated reason;
   no case was re-run in the hope of a better number.

3. **The case-3 proposed arm was rebuilt.** Its first batch ran against an arm copied from the
   working tree, which also held 28 data files that are not part of this pull request —
   other components' inventories that are untracked locally. The `origin/main` arm came from a
   clean worktree and held none of them, so the two arms differed by more than the target
   change. The arm was rebuilt from commit `995864d7372a09b3257784a554dc58672784b7a9` with
   `git archive`, checked against that commit with `diff -r` and found identical, and the three
   proposed runs were repeated. The grade did not change: 12/12 before and after. The discarded
   outputs are preserved outside the repository. One wording difference is worth recording —
   the discarded batch held a run that wrote "All 14 metrics" in a closing note while its own
   table listed all 16 correctly; no run in the clean batch did.

A further method fix applied to the final batch: the skill's own `evals/` directory was removed
from all three arms. The proposed arm's copy carried the expected header names inside its
expectations while the `origin/main` copy did not, so leaving it in place would have graded the
proposed arm against its own answer key.

### Limitations

- Three cases, three repetitions per arm. Three repetitions is the minimum `CONTRIBUTING.md`
  asks for.
- The proposed arm that cases 1 and 2 ran against was overwritten while case 3 was being set
  up, so its exact file composition can no longer be checked. The case-3 arm is verified
  against commit `995864d7372a09b3257784a554dc58672784b7a9`; the cases 1-2 arm is not, and it
  is stated here rather than assumed to have been clean.
- One model and one harness. The result may differ on another model.
- `claude -p` prints the final answer only. The saved output holds no tool calls and no
  reasoning, so a reviewer sees what the agent concluded, not how it got there. The leak in the
  first batch was found in the session logs, not in these outputs.
- All 170 other skills were present in every arm. The set was identical across arms, so it
  cannot explain a difference between them — but it does explain case 2's original failure,
  since `otel-collector` also covers this component.
- The cases test one component at two versions, v0.159.0 and v0.160.0. They do not test the
  other five version files this PR corrects.
- The strongest observation in this report — the wording propagating from the data file into
  answers — is not covered by any expectation. Adding one to case 1 would penalise a correct
  answer for omitting something the prompt never requested.

### Transcripts

The 27 final answers hold no credentials, no local paths, no customer data and no private
repository content. They were checked for all four before this summary was written.

## PR #235 — prometheusremotewriteexporter inventory

Run on 2026-09-02 with Claude Code 2.1.258 driving `claude-sonnet-5`. Every repetition used a
fresh session, an isolated `CLAUDE_CONFIG_DIR`, an empty working directory outside this
repository, and the same tool access: `Read`, `Glob` and `Grep` only. No arm had network
access, so no arm could read the upstream source. The prompt, the model and the tool set were
identical in all three arms. Only the target skill changed.

The withheld arm removed `otel-telemetry-emissions` alone. The other 170 skills stayed in
place in every arm.

A deterministic grader marked a repetition passing only when all four expectations in
`evals.json` were present in the final answer. No repetition was retried, and no repetition
was excluded.

| Arm | Target-skill revision / state | Cases × reps | Pass | Fail | Unknown |
|---|---|---:|---:|---:|---:|
| Target skill withheld | `Withheld` | 1 × 3 | 0 | 3 | 0 |
| Current `origin/main` skill | `55e1d7e411b5cddefb3ae95f128b220da8354044` | 1 × 3 | 0 | 3 | 0 |
| Proposed PR skill | `029f34324742a15f49eea0e181947efb83e8ae1c` | 1 × 3 | 3 | 0 | 0 |

### Per-attempt grading

`A` is all 16 metric names, `B` is the `wal` condition with the v0.159.0 `exporter` attribute,
`C` is the Remote Write 2.0 gate and config, and `D` is the instrument types and units.

| Attempt | Names found | A | B | C | D | Result |
|---|---:|---|---|---|---|---|
| `withheld-1` | 2/16 | fail | fail | fail | fail | fail |
| `withheld-2` | 0/16 | fail | fail | fail | fail | fail |
| `withheld-3` | 0/16 | fail | fail | fail | fail | fail |
| `current-1` | 0/16 | fail | fail | fail | fail | fail |
| `current-2` | 0/16 | fail | fail | fail | fail | fail |
| `current-3` | 0/16 | fail | fail | fail | fail | fail |
| `proposed-1` | 16/16 | pass | pass | pass | pass | pass |
| `proposed-2` | 16/16 | pass | pass | pass | pass | pass |
| `proposed-3` | 16/16 | pass | pass | pass | pass | pass |

### What differed

**The withheld arm could not do the task.** `withheld-1` gave two generic exporter metrics,
`otelcol_exporter_sent_metric_points` and `otelcol_exporter_send_failed_metric_points`, which
every exporter emits and which the question did not ask for. It then named only two of the 16
component metrics, with no type, unit or attribute. It inferred from the `wal.lag_record_frequency`
config key that a WAL lag metric must exist, and refused to name it. `withheld-2` and
`withheld-3` gave no answer at all. They asked for permission to fetch the upstream source.

**The `origin/main` arm failed correctly.** `current-1` and `current-2` reported that the
component is not in the registry, and refused to guess. This is the behavior that
`SKILL.md` asks for: "If the component or version is not covered at all, say so — do not infer
telemetry from semantic conventions." So these are not defects in the shipping skill. They are
the shipping skill telling the truth about a coverage gap. `current-3` asked to fetch the
source, like the withheld arm.

**The proposed arm answered completely, three times out of three.** Every repetition named all
16 metrics, separated the four unconditional metrics from the nine WAL metrics and the three
Remote Write 2.0 metrics, gave the instrument type and unit for each, and stated that v0.159.0
adds the `exporter` attribute to the WAL metrics that earlier versions emit unattributed. Two
repetitions also gave the histogram bucket boundaries.

**No regression.** The proposed arm did not lose any behavior that the `origin/main` arm had.
The `origin/main` arm gave no component data to lose. The "say so when not covered" rule stays
in the skill and is unchanged by this PR.

### Failing runs kept, and why

All six failures are preserved. None was retried.

- `withheld-2`, `withheld-3` and `current-3` stopped to ask for network permission instead of
  answering. This is a genuine miss, not a harness failure. The agent had no source and would
  not guess. The exit code was 0 in each.
- `withheld-1`, `current-1` and `current-2` gave an answer that failed all four expectations.

### Limitations

- One case, three repetitions per arm. This is the minimum that `CONTRIBUTING.md` asks for.
- One model and one harness. The result may differ on another model.
- `claude -p` prints the final answer only. The saved output holds no tool calls and no
  reasoning, so a reviewer sees what the agent concluded, not how it got there.
- All 170 other skills were present in every arm. Their descriptions add trigger surface. The
  set was identical across arms, so it cannot explain the difference between them.
- The case tests retrieval of one component at one version. It does not test the accuracy of
  the other 5 versions in this PR, and it does not test any other component.

### Transcripts

The nine final answers hold no credentials, no local paths, no customer data and no private
repository content. They were checked for all four before this summary was written.
  • opentelemetry-collector
    • exporter
      • debugexporter
        • v0.153.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/debugexporter
version: v0.153.0
scope_name: go.opentelemetry.io/collector/exporter/debugexporter
commit_sha: 452cae1662730600abfb76517f5d20bf7d64ed09
last_verified: 2026-08-11
---

# Debug Exporter

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `Traces` | `resource spans`; `spans` | INFO summary emitted for each received trace batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |
| `Metrics` | `resource metrics`; `metrics`; `data points` | INFO summary emitted for each received metrics batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |
| `Logs` | `resource logs`; `log records` | INFO summary emitted for each received logs batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |
| `Profiles` | `resource profiles`; `sample records` | INFO summary emitted for each received profiles batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |

## Sources

- `exporter/debugexporter/exporter.go`
- `exporter/debugexporter/factory.go`
- `exporter/debugexporter/config.go`
- `exporter/debugexporter/README.md`
- `exporter/debugexporter/metadata.yaml`
        • v0.154.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/debugexporter
version: v0.154.0
scope_name: go.opentelemetry.io/collector/exporter/debugexporter
commit_sha: dbed6ad641b872a581f79e7b6f28f315c1592e02
last_verified: 2026-08-11
---

# Debug Exporter

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `Traces` | `resource spans`; `spans` | INFO summary emitted for each received trace batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |
| `Metrics` | `resource metrics`; `metrics`; `data points` | INFO summary emitted for each received metrics batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |
| `Logs` | `resource logs`; `log records` | INFO summary emitted for each received logs batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |
| `Profiles` | `resource profiles`; `sample records` | INFO summary emitted for each received profiles batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |

## Sources

- `exporter/debugexporter/exporter.go`
- `exporter/debugexporter/factory.go`
- `exporter/debugexporter/config.go`
- `exporter/debugexporter/README.md`
- `exporter/debugexporter/metadata.yaml`
        • v0.155.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/debugexporter
version: v0.155.0
scope_name: go.opentelemetry.io/collector/exporter/debugexporter
commit_sha: 41da2fbd7dd58a5dd299587ebb159025b28521d2
last_verified: 2026-08-11
---

# Debug Exporter

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `Traces` | `resource spans`; `spans` | INFO summary emitted for each received trace batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |
| `Metrics` | `resource metrics`; `metrics`; `data points` | INFO summary emitted for each received metrics batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |
| `Logs` | `resource logs`; `log records` | INFO summary emitted for each received logs batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |
| `Profiles` | `resource profiles`; `sample records` | INFO summary emitted for each received profiles batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |

## Sources

- `exporter/debugexporter/exporter.go`
- `exporter/debugexporter/factory.go`
- `exporter/debugexporter/config.go`
- `exporter/debugexporter/README.md`
- `exporter/debugexporter/metadata.yaml`
        • v0.156.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/debugexporter
version: v0.156.0
scope_name: go.opentelemetry.io/collector/exporter/debugexporter
commit_sha: 0a6056f97e2e5fe8f3a52a45bc26d3fb64b731d4
last_verified: 2026-08-11
---

# Debug Exporter

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `Traces` | `resource spans`; `spans` | INFO summary emitted for each received trace batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |
| `Metrics` | `resource metrics`; `metrics`; `data points` | INFO summary emitted for each received metrics batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |
| `Logs` | `resource logs`; `log records` | INFO summary emitted for each received logs batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |
| `Profiles` | `resource profiles`; `sample records` | INFO summary emitted for each received profiles batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |

## Sources

- `exporter/debugexporter/exporter.go`
- `exporter/debugexporter/factory.go`
- `exporter/debugexporter/config.go`
- `exporter/debugexporter/README.md`
- `exporter/debugexporter/metadata.yaml`
        • v0.157.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/debugexporter
version: v0.157.0
scope_name: go.opentelemetry.io/collector/exporter/debugexporter
commit_sha: 4908404e59e544297b989a6961ee918b6f84b606
last_verified: 2026-08-11
---

# Debug Exporter

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `Traces` | `resource spans`; `spans` | INFO summary emitted for each received trace batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |
| `Metrics` | `resource metrics`; `metrics`; `data points` | INFO summary emitted for each received metrics batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |
| `Logs` | `resource logs`; `log records` | INFO summary emitted for each received logs batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |
| `Profiles` | `resource profiles`; `sample records` | INFO summary emitted for each received profiles batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |

## Sources

- `exporter/debugexporter/exporter.go`
- `exporter/debugexporter/factory.go`
- `exporter/debugexporter/config.go`
- `exporter/debugexporter/README.md`
- `exporter/debugexporter/metadata.yaml`
        • v0.158.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/debugexporter
version: v0.158.0
scope_name: go.opentelemetry.io/collector/exporter/debugexporter
commit_sha: 0378e9add75d42e35f621a2df1c9ae819aa10778
last_verified: 2026-08-11
---

# Debug Exporter

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `Traces` | `resource spans`; `spans` | INFO summary emitted for each received trace batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |
| `Metrics` | `resource metrics`; `metrics`; `data points` | INFO summary emitted for each received metrics batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |
| `Logs` | `resource logs`; `log records` | INFO summary emitted for each received logs batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |
| `Profiles` | `resource profiles`; `sample records` | INFO summary emitted for each received profiles batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |

## Sources

- `exporter/debugexporter/exporter.go`
- `exporter/debugexporter/factory.go`
- `exporter/debugexporter/config.go`
- `exporter/debugexporter/README.md`
- `exporter/debugexporter/metadata.yaml`
        • v0.159.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/debugexporter
version: v0.159.0
scope_name: go.opentelemetry.io/collector/exporter/debugexporter
commit_sha: 69c0873044e80fe1f0647a0bc5afec6244bcad76
last_verified: 2026-08-24
---

# Debug Exporter

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `Traces` | `resource spans`; `spans` | INFO summary emitted for each received trace batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |
| `Metrics` | `resource metrics`; `metrics`; `data points` | INFO summary emitted for each received metrics batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |
| `Logs` | `resource logs`; `log records` | INFO summary emitted for each received logs batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |
| `Profiles` | `resource profiles`; `sample records` | INFO summary emitted for each received profiles batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |

## Sources

- `exporter/debugexporter/exporter.go`
- `exporter/debugexporter/factory.go`
- `exporter/debugexporter/config.go`
- `exporter/debugexporter/README.md`
- `exporter/debugexporter/metadata.yaml`
        • v0.160.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/debugexporter
version: v0.160.0
scope_name: go.opentelemetry.io/collector/exporter/debugexporter
commit_sha: cd3455cf3a7f672208140b1ebb1581c542b2b0ed
last_verified: 2026-09-03
---

# Debug Exporter

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `Traces` | `resource spans`; `spans` | INFO summary emitted for each received trace batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |
| `Metrics` | `resource metrics`; `metrics`; `data points` | INFO summary emitted for each received metrics batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |
| `Logs` | `resource logs`; `log records` | INFO summary emitted for each received logs batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |
| `Profiles` | `resource profiles`; `sample records` | INFO summary emitted for each received profiles batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |

## Sources

- `exporter/debugexporter/exporter.go`
- `exporter/debugexporter/factory.go`
- `exporter/debugexporter/config.go`
- `exporter/debugexporter/README.md`
- `exporter/debugexporter/metadata.yaml`
        • v0.161.0.md 2.1 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/debugexporter
version: v0.161.0
scope_name: go.opentelemetry.io/collector/exporter/debugexporter
commit_sha: 0bf928af5487d3c4e0b4174eabb7ba075c322517
last_verified: 2026-10-03
---

# Debug Exporter

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `Traces` | `resource spans`; `spans` | INFO summary emitted for each received trace batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; `sampling_initial`/`sampling_thereafter` sample per log level and message, so they throttle repeated summary messages but do not reliably cap payload output (each distinct payload is its own sampling key). |
| `Metrics` | `resource metrics`; `metrics`; `data points` | INFO summary emitted for each received metrics batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; `sampling_initial`/`sampling_thereafter` sample per log level and message, so they throttle repeated summary messages but do not reliably cap payload output (each distinct payload is its own sampling key). |
| `Logs` | `resource logs`; `log records` | INFO summary emitted for each received logs batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; `sampling_initial`/`sampling_thereafter` sample per log level and message, so they throttle repeated summary messages but do not reliably cap payload output (each distinct payload is its own sampling key). |
| `Profiles` | `resource profiles`; `sample records` | INFO summary emitted for each received profiles batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; `sampling_initial`/`sampling_thereafter` sample per log level and message, so they throttle repeated summary messages but do not reliably cap payload output (each distinct payload is its own sampling key). |

## Sources

- `exporter/debugexporter/exporter.go`
- `exporter/debugexporter/factory.go`
- `exporter/debugexporter/config.go`
- `exporter/debugexporter/README.md`
- `exporter/debugexporter/metadata.yaml`
        • v0.162.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/debugexporter
version: v0.162.0
scope_name: go.opentelemetry.io/collector/exporter/debugexporter
commit_sha: 62cdad2ea133239380b44d20d84eb26e114779b6
last_verified: 2026-10-03
---

# Debug Exporter

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `Traces` | `resource spans`; `spans` | INFO summary emitted for each received trace batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |
| `Metrics` | `resource metrics`; `metrics`; `data points` | INFO summary emitted for each received metrics batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |
| `Logs` | `resource logs`; `log records` | INFO summary emitted for each received logs batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |
| `Profiles` | `resource profiles`; `sample records` | INFO summary emitted for each received profiles batch. With `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; output is subject to `sampling_initial` and `sampling_thereafter`. |

## Sources

- `exporter/debugexporter/exporter.go`
- `exporter/debugexporter/factory.go`
- `exporter/debugexporter/config.go`
- `exporter/debugexporter/README.md`
- `exporter/debugexporter/metadata.yaml`
        • v0.163.0.md 1.7 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/debugexporter
version: v0.163.0
scope_name: go.opentelemetry.io/collector/exporter/debugexporter
commit_sha: 5177a6a85ca3783068077e25aec6cebbe1d50d1f
last_verified: null
---

# Debug Exporter

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `Traces` | `resource spans`; `spans` | INFO summary emitted for each received trace batch. At `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; suppressed at `basic`. Output is subject to `sampling_initial` and `sampling_thereafter` when using either logger. |
| `Metrics` | `resource metrics`; `metrics`; `data points` | INFO summary emitted for each received metrics batch. At `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; suppressed at `basic`. Output is subject to `sampling_initial` and `sampling_thereafter` when using either logger. |
| `Logs` | `resource logs`; `log records` | INFO summary emitted for each received logs batch. At `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; suppressed at `basic`. Output is subject to `sampling_initial` and `sampling_thereafter` when using either logger. |
| `Profiles` | `resource profiles`; `sample records` | INFO summary emitted for each received profiles batch. At `verbosity: normal` or `detailed`, an additional INFO message contains the marshaled input; suppressed at `basic`. Output is subject to `sampling_initial` and `sampling_thereafter` when using either logger. |

## Sources

- `exporter/debugexporter/exporter.go`
- `exporter/debugexporter/factory.go`
- `exporter/debugexporter/config.go`
- `exporter/debugexporter/metadata.yaml`
      • otlpexporter
        • v0.153.0.md 4 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/otlpexporter
version: v0.153.0
scope_name: go.opentelemetry.io/collector/exporter/exporterhelper
commit_sha: 452cae1662730600abfb76517f5d20bf7d64ed09
last_verified: 2026-10-14
---

# OTLP exporter

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `exporter/<exporter ID>/<signal>` | INTERNAL | `exporter=<exporter ID>`; `data_type=<traces\|metrics\|logs\|profiles>` | Created by exporterhelper for each export request; includes queue links when queued. Sets `items.sent` and `items.failed`; errors set span status to ERROR. |
| `exporter/enqueue` | INTERNAL | - | Created when a sending queue is configured, for each queue offer. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_exporter_enqueue_failed_log_records` | Counter | `{record}` | `exporter` | Queue configured; emitted when log records cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_metric_points` | Counter | `{datapoint}` | `exporter` | Queue configured; emitted when metric points cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_profile_samples` | Counter | `{sample}` | `exporter` | Queue configured; emitted when profile samples cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_spans` | Counter | `{span}` | `exporter` | Queue configured; emitted when spans cannot be enqueued. |
| `otelcol_exporter_in_flight_requests` | UpDownCounter | `{request}` | `exporter`; `data_type` | Includes requests in retry backoff. |
| `otelcol_exporter_queue_batch_send_size` | Histogram | `{unit}` | `exporter` | Queue configured; records units in each offered batch. |
| `otelcol_exporter_queue_batch_send_size_bytes` | Histogram | `By` | `exporter` | Queue configured; records serialized batch size. Available at detailed telemetry level. |
| `otelcol_exporter_queue_capacity` | Gauge | `{batch}` | `exporter`; `data_type` | Queue configured; asynchronous fixed retry-queue capacity. |
| `otelcol_exporter_queue_size` | Gauge | `{batch}` | `exporter`; `data_type` | Queue configured; asynchronous current retry-queue size. |
| `otelcol_exporter_send_failed_log_records` | Counter | `{record}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | `error.type` and `error.permanent` are included at detailed telemetry level; emitted for failed sends. |
| `otelcol_exporter_send_failed_metric_points` | Counter | `{datapoint}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | `error.type` and `error.permanent` are included at detailed telemetry level; emitted for failed sends. |
| `otelcol_exporter_send_failed_profile_samples` | Counter | `{sample}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | `error.type` and `error.permanent` are included at detailed telemetry level; emitted for failed sends. |
| `otelcol_exporter_send_failed_spans` | Counter | `{span}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | `error.type` and `error.permanent` are included at detailed telemetry level; emitted for failed sends. |
| `otelcol_exporter_sent_log_records` | Counter | `{record}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent log records. |
| `otelcol_exporter_sent_metric_points` | Counter | `{datapoint}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent metric points. |
| `otelcol_exporter_sent_profile_samples` | Counter | `{sample}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent profile samples. |
| `otelcol_exporter_sent_spans` | Counter | `{span}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent spans. |

## Sources

- `exporter/otlpexporter/factory.go`
- `exporter/otlpexporter/otlp.go`
- `exporter/otlpexporter/internal/metadata/generated_status.go`
- `exporter/exporterhelper/metadata.yaml`
- `exporter/exporterhelper/internal/obs_report_sender.go`
- `exporter/exporterhelper/internal/queue/obs_queue.go`
        • v0.154.0.md 4 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/otlpexporter
version: v0.154.0
scope_name: go.opentelemetry.io/collector/exporter/exporterhelper
commit_sha: dbed6ad641b872a581f79e7b6f28f315c1592e02
last_verified: 2026-10-14
---

# OTLP exporter

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `exporter/<exporter ID>/<signal>` | INTERNAL | `exporter=<exporter ID>`; `data_type=<traces\|metrics\|logs\|profiles>` | Created by exporterhelper for each export request; includes queue links when queued. Sets `items.sent` and `items.failed`; errors set span status to ERROR. |
| `exporter/enqueue` | INTERNAL | - | Created when a sending queue is configured, for each queue offer. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_exporter_enqueue_failed_log_records` | Counter | `{record}` | `exporter` | Queue configured; emitted when log records cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_metric_points` | Counter | `{datapoint}` | `exporter` | Queue configured; emitted when metric points cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_profile_samples` | Counter | `{sample}` | `exporter` | Queue configured; emitted when profile samples cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_spans` | Counter | `{span}` | `exporter` | Queue configured; emitted when spans cannot be enqueued. |
| `otelcol_exporter_in_flight_requests` | UpDownCounter | `{request}` | `exporter`; `data_type` | Includes requests in retry backoff. |
| `otelcol_exporter_queue_batch_send_size` | Histogram | `{unit}` | `exporter` | Queue configured; records units in each offered batch. |
| `otelcol_exporter_queue_batch_send_size_bytes` | Histogram | `By` | `exporter` | Queue configured; records serialized batch size. Available at detailed telemetry level. |
| `otelcol_exporter_queue_capacity` | Gauge | `{batch}` | `exporter`; `data_type` | Queue configured; asynchronous fixed retry-queue capacity. |
| `otelcol_exporter_queue_size` | Gauge | `{batch}` | `exporter`; `data_type` | Queue configured; asynchronous current retry-queue size. |
| `otelcol_exporter_send_failed_log_records` | Counter | `{record}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | `error.type` and `error.permanent` are included at detailed telemetry level; emitted for failed sends. |
| `otelcol_exporter_send_failed_metric_points` | Counter | `{datapoint}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | `error.type` and `error.permanent` are included at detailed telemetry level; emitted for failed sends. |
| `otelcol_exporter_send_failed_profile_samples` | Counter | `{sample}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | `error.type` and `error.permanent` are included at detailed telemetry level; emitted for failed sends. |
| `otelcol_exporter_send_failed_spans` | Counter | `{span}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | `error.type` and `error.permanent` are included at detailed telemetry level; emitted for failed sends. |
| `otelcol_exporter_sent_log_records` | Counter | `{record}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent log records. |
| `otelcol_exporter_sent_metric_points` | Counter | `{datapoint}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent metric points. |
| `otelcol_exporter_sent_profile_samples` | Counter | `{sample}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent profile samples. |
| `otelcol_exporter_sent_spans` | Counter | `{span}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent spans. |

## Sources

- `exporter/otlpexporter/factory.go`
- `exporter/otlpexporter/otlp.go`
- `exporter/otlpexporter/internal/metadata/generated_status.go`
- `exporter/exporterhelper/metadata.yaml`
- `exporter/exporterhelper/internal/obs_report_sender.go`
- `exporter/exporterhelper/internal/queue/obs_queue.go`
        • v0.155.0.md 4 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/otlpexporter
version: v0.155.0
scope_name: go.opentelemetry.io/collector/exporter/exporterhelper
commit_sha: 41da2fbd7dd58a5dd299587ebb159025b28521d2
last_verified: 2026-10-14
---

# OTLP exporter

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `exporter/<exporter ID>/<signal>` | INTERNAL | `exporter=<exporter ID>`; `data_type=<traces\|metrics\|logs\|profiles>` | Created by exporterhelper for each export request; includes queue links when queued. Sets `items.sent` and `items.failed`; errors set span status to ERROR. |
| `exporter/enqueue` | INTERNAL | - | Created when a sending queue is configured, for each queue offer. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_exporter_enqueue_failed_log_records` | Counter | `{record}` | `exporter` | Queue configured; emitted when log records cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_metric_points` | Counter | `{datapoint}` | `exporter` | Queue configured; emitted when metric points cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_profile_samples` | Counter | `{sample}` | `exporter` | Queue configured; emitted when profile samples cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_spans` | Counter | `{span}` | `exporter` | Queue configured; emitted when spans cannot be enqueued. |
| `otelcol_exporter_in_flight_requests` | UpDownCounter | `{request}` | `exporter`; `data_type` | Includes requests in retry backoff. |
| `otelcol_exporter_queue_batch_send_size` | Histogram | `{unit}` | `exporter` | Queue configured; records units in each offered batch. |
| `otelcol_exporter_queue_batch_send_size_bytes` | Histogram | `By` | `exporter` | Queue configured; records serialized batch size. Available at detailed telemetry level. |
| `otelcol_exporter_queue_capacity` | Gauge | `{batch}` | `exporter`; `data_type` | Queue configured; asynchronous fixed retry-queue capacity. |
| `otelcol_exporter_queue_size` | Gauge | `{batch}` | `exporter`; `data_type` | Queue configured; asynchronous current retry-queue size. |
| `otelcol_exporter_send_failed_log_records` | Counter | `{record}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | `error.type` and `error.permanent` are included at detailed telemetry level; emitted for failed sends. |
| `otelcol_exporter_send_failed_metric_points` | Counter | `{datapoint}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | `error.type` and `error.permanent` are included at detailed telemetry level; emitted for failed sends. |
| `otelcol_exporter_send_failed_profile_samples` | Counter | `{sample}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | `error.type` and `error.permanent` are included at detailed telemetry level; emitted for failed sends. |
| `otelcol_exporter_send_failed_spans` | Counter | `{span}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | `error.type` and `error.permanent` are included at detailed telemetry level; emitted for failed sends. |
| `otelcol_exporter_sent_log_records` | Counter | `{record}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent log records. |
| `otelcol_exporter_sent_metric_points` | Counter | `{datapoint}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent metric points. |
| `otelcol_exporter_sent_profile_samples` | Counter | `{sample}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent profile samples. |
| `otelcol_exporter_sent_spans` | Counter | `{span}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent spans. |

## Sources

- `exporter/otlpexporter/factory.go`
- `exporter/otlpexporter/otlp.go`
- `exporter/otlpexporter/internal/metadata/generated_status.go`
- `exporter/exporterhelper/metadata.yaml`
- `exporter/exporterhelper/internal/obs_report_sender.go`
- `exporter/exporterhelper/internal/queue/obs_queue.go`
        • v0.156.0.md 4 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/otlpexporter
version: v0.156.0
scope_name: go.opentelemetry.io/collector/exporter/exporterhelper
commit_sha: 0a6056f97e2e5fe8f3a52a45bc26d3fb64b731d4
last_verified: 2026-10-14
---

# OTLP exporter

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `exporter/<exporter ID>/<signal>` | INTERNAL | `exporter=<exporter ID>`; `data_type=<traces\|metrics\|logs\|profiles>` | Created by exporterhelper for each export request; includes queue links when queued. Sets `items.sent` and `items.failed`; errors set span status to ERROR. |
| `exporter/enqueue` | INTERNAL | - | Created when a sending queue is configured, for each queue offer. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_exporter_enqueue_failed_log_records` | Counter | `{record}` | `exporter` | Queue configured; emitted when log records cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_metric_points` | Counter | `{datapoint}` | `exporter` | Queue configured; emitted when metric points cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_profile_samples` | Counter | `{sample}` | `exporter` | Queue configured; emitted when profile samples cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_spans` | Counter | `{span}` | `exporter` | Queue configured; emitted when spans cannot be enqueued. |
| `otelcol_exporter_in_flight_requests` | UpDownCounter | `{request}` | `exporter`; `data_type` | Includes requests in retry backoff. |
| `otelcol_exporter_queue_batch_send_size` | Histogram | `{unit}` | `exporter` | Queue configured; records units in each offered batch. |
| `otelcol_exporter_queue_batch_send_size_bytes` | Histogram | `By` | `exporter` | Queue configured; records serialized batch size. Available at detailed telemetry level. |
| `otelcol_exporter_queue_capacity` | Gauge | `{batch}` | `exporter`; `data_type` | Queue configured; asynchronous fixed retry-queue capacity. |
| `otelcol_exporter_queue_size` | Gauge | `{batch}` | `exporter`; `data_type` | Queue configured; asynchronous current retry-queue size. |
| `otelcol_exporter_send_failed_log_records` | Counter | `{record}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | `error.type` and `error.permanent` are included at detailed telemetry level; emitted for failed sends. |
| `otelcol_exporter_send_failed_metric_points` | Counter | `{datapoint}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | `error.type` and `error.permanent` are included at detailed telemetry level; emitted for failed sends. |
| `otelcol_exporter_send_failed_profile_samples` | Counter | `{sample}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | `error.type` and `error.permanent` are included at detailed telemetry level; emitted for failed sends. |
| `otelcol_exporter_send_failed_spans` | Counter | `{span}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | `error.type` and `error.permanent` are included at detailed telemetry level; emitted for failed sends. |
| `otelcol_exporter_sent_log_records` | Counter | `{record}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent log records. |
| `otelcol_exporter_sent_metric_points` | Counter | `{datapoint}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent metric points. |
| `otelcol_exporter_sent_profile_samples` | Counter | `{sample}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent profile samples. |
| `otelcol_exporter_sent_spans` | Counter | `{span}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent spans. |

## Sources

- `exporter/otlpexporter/factory.go`
- `exporter/otlpexporter/otlp.go`
- `exporter/otlpexporter/internal/metadata/generated_status.go`
- `exporter/exporterhelper/metadata.yaml`
- `exporter/exporterhelper/internal/obs_report_sender.go`
- `exporter/exporterhelper/internal/queue/obs_queue.go`
        • v0.157.0.md 4 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/otlpexporter
version: v0.157.0
scope_name: go.opentelemetry.io/collector/exporter/exporterhelper
commit_sha: 4908404e59e544297b989a6961ee918b6f84b606
last_verified: 2026-10-14
---

# OTLP exporter

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `exporter/<exporter ID>/<signal>` | INTERNAL | `exporter=<exporter ID>`; `data_type=<traces\|metrics\|logs\|profiles>` | Created by exporterhelper for each export request; includes queue links when queued. Sets `items.sent` and `items.failed`; errors set span status to ERROR. |
| `exporter/enqueue` | INTERNAL | - | Created when a sending queue is configured, for each queue offer. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_exporter_enqueue_failed_log_records` | Counter | `{record}` | `exporter` | Queue configured; emitted when log records cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_metric_points` | Counter | `{datapoint}` | `exporter` | Queue configured; emitted when metric points cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_profile_samples` | Counter | `{sample}` | `exporter` | Queue configured; emitted when profile samples cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_spans` | Counter | `{span}` | `exporter` | Queue configured; emitted when spans cannot be enqueued. |
| `otelcol_exporter_in_flight_requests` | UpDownCounter | `{request}` | `exporter`; `data_type` | Includes requests in retry backoff. |
| `otelcol_exporter_queue_batch_send_size` | Histogram | `{unit}` | `exporter` | Queue configured; records units in each offered batch. |
| `otelcol_exporter_queue_batch_send_size_bytes` | Histogram | `By` | `exporter` | Queue configured; records serialized batch size. Available at detailed telemetry level. |
| `otelcol_exporter_queue_capacity` | Gauge | `{batch}` | `exporter`; `data_type` | Queue configured; asynchronous fixed retry-queue capacity. |
| `otelcol_exporter_queue_size` | Gauge | `{batch}` | `exporter`; `data_type` | Queue configured; asynchronous current retry-queue size. |
| `otelcol_exporter_send_failed_log_records` | Counter | `{record}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | `error.type` and `error.permanent` are included at detailed telemetry level; emitted for failed sends. |
| `otelcol_exporter_send_failed_metric_points` | Counter | `{datapoint}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | `error.type` and `error.permanent` are included at detailed telemetry level; emitted for failed sends. |
| `otelcol_exporter_send_failed_profile_samples` | Counter | `{sample}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | `error.type` and `error.permanent` are included at detailed telemetry level; emitted for failed sends. |
| `otelcol_exporter_send_failed_spans` | Counter | `{span}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | `error.type` and `error.permanent` are included at detailed telemetry level; emitted for failed sends. |
| `otelcol_exporter_sent_log_records` | Counter | `{record}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent log records. |
| `otelcol_exporter_sent_metric_points` | Counter | `{datapoint}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent metric points. |
| `otelcol_exporter_sent_profile_samples` | Counter | `{sample}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent profile samples. |
| `otelcol_exporter_sent_spans` | Counter | `{span}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent spans. |

## Sources

- `exporter/otlpexporter/factory.go`
- `exporter/otlpexporter/otlp.go`
- `exporter/otlpexporter/internal/metadata/generated_status.go`
- `exporter/exporterhelper/metadata.yaml`
- `exporter/exporterhelper/internal/obs_report_sender.go`
- `exporter/exporterhelper/internal/queue/obs_queue.go`
        • v0.158.0.md 4 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/otlpexporter
version: v0.158.0
scope_name: go.opentelemetry.io/collector/exporter/exporterhelper
commit_sha: 0378e9add75d42e35f621a2df1c9ae819aa10778
last_verified: 2026-10-14
---

# OTLP exporter

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `exporter/<exporter ID>/<signal>` | INTERNAL | `exporter=<exporter ID>`; `data_type=<traces\|metrics\|logs\|profiles>` | Created by exporterhelper for each export request; includes queue links when queued. Sets `items.sent` and `items.failed`; errors set span status to ERROR. |
| `exporter/enqueue` | INTERNAL | - | Created when a sending queue is configured, for each queue offer. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_exporter_enqueue_failed_log_records` | Counter | `{record}` | `exporter` | Queue configured; emitted when log records cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_metric_points` | Counter | `{datapoint}` | `exporter` | Queue configured; emitted when metric points cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_profile_samples` | Counter | `{sample}` | `exporter` | Queue configured; emitted when profile samples cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_spans` | Counter | `{span}` | `exporter` | Queue configured; emitted when spans cannot be enqueued. |
| `otelcol_exporter_in_flight_requests` | UpDownCounter | `{request}` | `exporter`; `data_type` | Includes requests in retry backoff. |
| `otelcol_exporter_queue_batch_send_size` | Histogram | `{unit}` | `exporter` | Queue configured; records units in each offered batch. |
| `otelcol_exporter_queue_batch_send_size_bytes` | Histogram | `By` | `exporter` | Queue configured; records serialized batch size. Available at detailed telemetry level. |
| `otelcol_exporter_queue_capacity` | Gauge | `{batch}` | `exporter`; `data_type` | Queue configured; asynchronous fixed retry-queue capacity. |
| `otelcol_exporter_queue_size` | Gauge | `{batch}` | `exporter`; `data_type` | Queue configured; asynchronous current retry-queue size. |
| `otelcol_exporter_send_failed_log_records` | Counter | `{record}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | `error.type` and `error.permanent` are included at detailed telemetry level; emitted for failed sends. |
| `otelcol_exporter_send_failed_metric_points` | Counter | `{datapoint}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | `error.type` and `error.permanent` are included at detailed telemetry level; emitted for failed sends. |
| `otelcol_exporter_send_failed_profile_samples` | Counter | `{sample}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | `error.type` and `error.permanent` are included at detailed telemetry level; emitted for failed sends. |
| `otelcol_exporter_send_failed_spans` | Counter | `{span}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | `error.type` and `error.permanent` are included at detailed telemetry level; emitted for failed sends. |
| `otelcol_exporter_sent_log_records` | Counter | `{record}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent log records. |
| `otelcol_exporter_sent_metric_points` | Counter | `{datapoint}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent metric points. |
| `otelcol_exporter_sent_profile_samples` | Counter | `{sample}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent profile samples. |
| `otelcol_exporter_sent_spans` | Counter | `{span}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent spans. |

## Sources

- `exporter/otlpexporter/factory.go`
- `exporter/otlpexporter/otlp.go`
- `exporter/otlpexporter/internal/metadata/generated_status.go`
- `exporter/exporterhelper/metadata.yaml`
- `exporter/exporterhelper/internal/obs_report_sender.go`
- `exporter/exporterhelper/internal/queue/obs_queue.go`
        • v0.159.0.md 4.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/otlpexporter
version: v0.159.0
scope_name: go.opentelemetry.io/collector/exporter/exporterhelper
commit_sha: 69c0873044e80fe1f0647a0bc5afec6244bcad76
last_verified: 2026-10-14
---

# OTLP exporter

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `exporter/<exporter ID>/<signal>` | INTERNAL | `exporter=<exporter ID>`; `data_type=<traces\|metrics\|logs\|profiles>` | Created by exporterhelper for each export request; includes queue links when queued. Sets `items.sent` and `items.failed`; errors set span status to ERROR. |
| `exporter/enqueue` | INTERNAL | - | Created when a sending queue is configured, for each queue offer. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_exporter_enqueue_failed_log_records` | Counter | `{record}` | `exporter` | Queue configured; emitted when log records cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_metric_points` | Counter | `{datapoint}` | `exporter` | Queue configured; emitted when metric points cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_profile_samples` | Counter | `{sample}` | `exporter` | Queue configured; emitted when profile samples cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_spans` | Counter | `{span}` | `exporter` | Queue configured; emitted when spans cannot be enqueued. |
| `otelcol_exporter_enqueue_size` | Histogram | `{unit}` | `exporter` | Queue configured; emitted at detailed telemetry level for each offered request. |
| `otelcol_exporter_enqueue_size_bytes` | Histogram | `By` | `exporter` | Queue configured; emitted at detailed telemetry level for each offered request. |
| `otelcol_exporter_in_flight_requests` | UpDownCounter | `{request}` | `exporter`; `data_type` | Includes requests in retry backoff. |
| `otelcol_exporter_queue_batch_send_size` | Histogram | `{unit}` | `exporter` | Queue configured and batching enabled; emitted at detailed telemetry level. The default queue batching behavior is controlled by feature gate `pkg.exporterhelper.queueBatchEnabled`. |
| `otelcol_exporter_queue_batch_send_size_bytes` | Histogram | `By` | `exporter` | Queue configured and batching enabled; emitted at detailed telemetry level. The default queue batching behavior is controlled by feature gate `pkg.exporterhelper.queueBatchEnabled`. |
| `otelcol_exporter_queue_capacity` | Gauge | `{batch}` | `exporter`; `data_type` | Queue configured; asynchronous fixed retry-queue capacity. |
| `otelcol_exporter_queue_size` | Gauge | `{batch}` | `exporter`; `data_type` | Queue configured; asynchronous current retry-queue size. |
| `otelcol_exporter_send_failed_log_records` | Counter | `{record}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | Emitted for failed sends; `error.type` and `error.permanent` are included at detailed telemetry level. |
| `otelcol_exporter_send_failed_metric_points` | Counter | `{datapoint}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | Emitted for failed sends; `error.type` and `error.permanent` are included at detailed telemetry level. |
| `otelcol_exporter_send_failed_profile_samples` | Counter | `{sample}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | Emitted for failed sends; `error.type` and `error.permanent` are included at detailed telemetry level. |
| `otelcol_exporter_send_failed_spans` | Counter | `{span}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | Emitted for failed sends; `error.type` and `error.permanent` are included at detailed telemetry level. |
| `otelcol_exporter_sent_log_records` | Counter | `{record}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent log records. |
| `otelcol_exporter_sent_metric_points` | Counter | `{datapoint}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent metric points. |
| `otelcol_exporter_sent_profile_samples` | Counter | `{sample}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent profile samples. |
| `otelcol_exporter_sent_spans` | Counter | `{span}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent spans. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `Partial success response` | `message`; one of `dropped_spans`, `dropped_data_points`, `dropped_log_records`, or `dropped_profiles` | Emitted at WARN level when the OTLP response reports an error message or rejected items. |

## Sources

- `exporter/otlpexporter/factory.go`
- `exporter/otlpexporter/otlp.go`
- `exporter/otlpexporter/internal/metadata/generated_status.go`
- `exporter/exporterhelper/metadata.yaml`
- `exporter/exporterhelper/internal/metadata/generated_telemetry.go`
- `exporter/exporterhelper/internal/metadata/generated_feature_gates.go`
- `exporter/exporterhelper/internal/obs_report_sender.go`
- `exporter/exporterhelper/internal/queue/obs_queue.go`
        • v0.160.0.md 4.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/otlpexporter
version: v0.160.0
scope_name: go.opentelemetry.io/collector/exporter/exporterhelper
commit_sha: cd3455cf3a7f672208140b1ebb1581c542b2b0ed
last_verified: 2026-10-14
---

# OTLP exporter

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `exporter/<exporter ID>/<signal>` | INTERNAL | `exporter=<exporter ID>`; `data_type=<traces\|metrics\|logs\|profiles>` | Created by exporterhelper for each export request; includes queue links when queued. Sets `items.sent` and `items.failed`; errors set span status to ERROR. |
| `exporter/enqueue` | INTERNAL | - | Created when a sending queue is configured, for each queue offer. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_exporter_enqueue_failed_log_records` | Counter | `{record}` | `exporter` | Queue configured; emitted when log records cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_metric_points` | Counter | `{datapoint}` | `exporter` | Queue configured; emitted when metric points cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_profile_samples` | Counter | `{sample}` | `exporter` | Queue configured; emitted when profile samples cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_spans` | Counter | `{span}` | `exporter` | Queue configured; emitted when spans cannot be enqueued. |
| `otelcol_exporter_enqueue_size` | Histogram | `{unit}` | `exporter` | Queue configured; emitted at detailed telemetry level for each offered request. |
| `otelcol_exporter_enqueue_size_bytes` | Histogram | `By` | `exporter` | Queue configured; emitted at detailed telemetry level for each offered request. |
| `otelcol_exporter_in_flight_requests` | UpDownCounter | `{request}` | `exporter`; `data_type` | Includes requests in retry backoff. |
| `otelcol_exporter_queue_batch_send_size` | Histogram | `{unit}` | `exporter` | Queue configured and batching enabled; emitted at detailed telemetry level. The default queue batching behavior is controlled by feature gate `pkg.exporterhelper.queueBatchEnabled`. |
| `otelcol_exporter_queue_batch_send_size_bytes` | Histogram | `By` | `exporter` | Queue configured and batching enabled; emitted at detailed telemetry level. The default queue batching behavior is controlled by feature gate `pkg.exporterhelper.queueBatchEnabled`. |
| `otelcol_exporter_queue_capacity` | Gauge | `{batch}` | `exporter`; `data_type` | Queue configured; asynchronous fixed retry-queue capacity. |
| `otelcol_exporter_queue_size` | Gauge | `{batch}` | `exporter`; `data_type` | Queue configured; asynchronous current retry-queue size. |
| `otelcol_exporter_send_failed_log_records` | Counter | `{record}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | Emitted for failed sends; `error.type` and `error.permanent` are included at detailed telemetry level. |
| `otelcol_exporter_send_failed_metric_points` | Counter | `{datapoint}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | Emitted for failed sends; `error.type` and `error.permanent` are included at detailed telemetry level. |
| `otelcol_exporter_send_failed_profile_samples` | Counter | `{sample}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | Emitted for failed sends; `error.type` and `error.permanent` are included at detailed telemetry level. |
| `otelcol_exporter_send_failed_spans` | Counter | `{span}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | Emitted for failed sends; `error.type` and `error.permanent` are included at detailed telemetry level. |
| `otelcol_exporter_sent_log_records` | Counter | `{record}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent log records. |
| `otelcol_exporter_sent_metric_points` | Counter | `{datapoint}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent metric points. |
| `otelcol_exporter_sent_profile_samples` | Counter | `{sample}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent profile samples. |
| `otelcol_exporter_sent_spans` | Counter | `{span}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent spans. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `Partial success response` | `message`; one of `dropped_spans`, `dropped_data_points`, `dropped_log_records`, or `dropped_profiles` | Emitted at WARN level when the OTLP response reports an error message or rejected items. |

## Sources

- `exporter/otlpexporter/factory.go`
- `exporter/otlpexporter/otlp.go`
- `exporter/otlpexporter/internal/metadata/generated_status.go`
- `exporter/exporterhelper/metadata.yaml`
- `exporter/exporterhelper/internal/metadata/generated_telemetry.go`
- `exporter/exporterhelper/internal/metadata/generated_feature_gates.go`
- `exporter/exporterhelper/internal/obs_report_sender.go`
- `exporter/exporterhelper/internal/queue/obs_queue.go`
        • v0.161.0.md 4.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/otlpexporter
version: v0.161.0
scope_name: go.opentelemetry.io/collector/exporter/exporterhelper
commit_sha: 0bf928af5487d3c4e0b4174eabb7ba075c322517
last_verified: 2026-10-14
---

# OTLP exporter

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `exporter/<exporter ID>/<signal>` | INTERNAL | `exporter=<exporter ID>`; `data_type=<traces\|metrics\|logs\|profiles>` | Created by exporterhelper for each export request; includes queue links when queued. Sets `items.sent` and `items.failed`; errors set span status to ERROR. |
| `exporter/enqueue` | INTERNAL | - | Created when a sending queue is configured, for each queue offer. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_exporter_enqueue_failed_log_records` | Counter | `{record}` | `exporter` | Queue configured; emitted when log records cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_metric_points` | Counter | `{datapoint}` | `exporter` | Queue configured; emitted when metric points cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_profile_samples` | Counter | `{sample}` | `exporter` | Queue configured; emitted when profile samples cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_spans` | Counter | `{span}` | `exporter` | Queue configured; emitted when spans cannot be enqueued. |
| `otelcol_exporter_enqueue_size` | Histogram | `{unit}` | `exporter` | Queue configured; emitted at detailed telemetry level for each offered request. |
| `otelcol_exporter_enqueue_size_bytes` | Histogram | `By` | `exporter` | Queue configured; emitted at detailed telemetry level for each offered request. |
| `otelcol_exporter_in_flight_requests` | UpDownCounter | `{request}` | `exporter`; `data_type` | Includes requests in retry backoff. |
| `otelcol_exporter_queue_batch_send_size` | Histogram | `{unit}` | `exporter` | Queue configured and batching enabled; emitted at detailed telemetry level. The default queue batching behavior is controlled by feature gate `pkg.exporterhelper.queueBatchEnabled`. |
| `otelcol_exporter_queue_batch_send_size_bytes` | Histogram | `By` | `exporter` | Queue configured and batching enabled; emitted at detailed telemetry level. The default queue batching behavior is controlled by feature gate `pkg.exporterhelper.queueBatchEnabled`. |
| `otelcol_exporter_queue_capacity` | Gauge | `{batch}` | `exporter`; `data_type` | Queue configured; asynchronous fixed retry-queue capacity. |
| `otelcol_exporter_queue_size` | Gauge | `{batch}` | `exporter`; `data_type` | Queue configured; asynchronous current retry-queue size. |
| `otelcol_exporter_send_failed_log_records` | Counter | `{record}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | Emitted for failed sends; `error.type` and `error.permanent` are included at detailed telemetry level. |
| `otelcol_exporter_send_failed_metric_points` | Counter | `{datapoint}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | Emitted for failed sends; `error.type` and `error.permanent` are included at detailed telemetry level. |
| `otelcol_exporter_send_failed_profile_samples` | Counter | `{sample}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | Emitted for failed sends; `error.type` and `error.permanent` are included at detailed telemetry level. |
| `otelcol_exporter_send_failed_spans` | Counter | `{span}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | Emitted for failed sends; `error.type` and `error.permanent` are included at detailed telemetry level. |
| `otelcol_exporter_sent_log_records` | Counter | `{record}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent log records. |
| `otelcol_exporter_sent_metric_points` | Counter | `{datapoint}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent metric points. |
| `otelcol_exporter_sent_profile_samples` | Counter | `{sample}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent profile samples. |
| `otelcol_exporter_sent_spans` | Counter | `{span}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent spans. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `Partial success response` | `message`; one of `dropped_spans`, `dropped_data_points`, `dropped_log_records`, or `dropped_profiles` | Emitted at WARN level when the OTLP response reports an error message or rejected items. |

## Sources

- `exporter/otlpexporter/factory.go`
- `exporter/otlpexporter/otlp.go`
- `exporter/otlpexporter/internal/metadata/generated_status.go`
- `exporter/exporterhelper/metadata.yaml`
- `exporter/exporterhelper/internal/metadata/generated_telemetry.go`
- `exporter/exporterhelper/internal/metadata/generated_feature_gates.go`
- `exporter/exporterhelper/internal/obs_report_sender.go`
- `exporter/exporterhelper/internal/queue/obs_queue.go`
        • v0.162.0.md 5.4 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/otlpexporter
version: v0.162.0
scope_name: go.opentelemetry.io/collector/exporter/exporterhelper
commit_sha: 62cdad2ea133239380b44d20d84eb26e114779b6
last_verified: 2026-10-14
---

# OTLP exporter

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `exporter/<exporter ID>/<signal>` | INTERNAL | `exporter=<exporter ID>`; `data_type=<traces\|metrics\|logs\|profiles>` | Created by exporterhelper for each export request; includes queue links when queued. Sets `items.sent` and `items.failed`; errors set span status to ERROR. |
| `exporter/enqueue` | INTERNAL | - | Created when a sending queue is configured, for each queue offer. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_exporter_enqueue_failed_log_records` | Counter | `{record}` | `exporter` | Queue configured; emitted when log records cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_metric_points` | Counter | `{datapoint}` | `exporter` | Queue configured; emitted when metric points cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_profile_samples` | Counter | `{sample}` | `exporter` | Queue configured; emitted when profile samples cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_spans` | Counter | `{span}` | `exporter` | Queue configured; emitted when spans cannot be enqueued. |
| `otelcol_exporter_enqueue_size` | Histogram | `{unit}` | `exporter` | Queue configured; emitted at detailed telemetry level for each offered request. |
| `otelcol_exporter_enqueue_size_bytes` | Histogram | `By` | `exporter` | Queue configured; emitted at detailed telemetry level for each offered request. |
| `otelcol_exporter_in_flight_requests` | UpDownCounter | `{request}` | `exporter`; `data_type` | Includes requests in retry backoff. |
| `otelcol_exporter_queue_batch_partition_cache_capacity` | Gauge | `{partition}` | `exporter`; `data_type` | Batching configured with non-empty `sending_queue.batch.partition.metadata_keys`; asynchronous maximum number of active partition batchers in the LRU cache. |
| `otelcol_exporter_queue_batch_partition_cache_size` | Gauge | `{partition}` | `exporter`; `data_type` | Batching configured with non-empty `sending_queue.batch.partition.metadata_keys`; asynchronous current number of active partition batchers in the LRU cache. |
| `otelcol_exporter_queue_batch_send_size` | Histogram | `{unit}` | `exporter` | Queue configured and batching enabled; emitted at detailed telemetry level. The default queue batching behavior is controlled by feature gate `pkg.exporterhelper.queueBatchEnabled`. |
| `otelcol_exporter_queue_batch_send_size_bytes` | Histogram | `By` | `exporter` | Queue configured and batching enabled; emitted at detailed telemetry level. The default queue batching behavior is controlled by feature gate `pkg.exporterhelper.queueBatchEnabled`. |
| `otelcol_exporter_queue_capacity` | Gauge | `{batch}` | `exporter`; `data_type` | Queue configured; asynchronous fixed retry-queue capacity. |
| `otelcol_exporter_queue_size` | Gauge | `{batch}` | `exporter`; `data_type` | Queue configured; asynchronous current retry-queue size. |
| `otelcol_exporter_send_failed_log_records` | Counter | `{record}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | Emitted for failed sends; `error.type` and `error.permanent` are included at detailed telemetry level. |
| `otelcol_exporter_send_failed_metric_points` | Counter | `{datapoint}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | Emitted for failed sends; `error.type` and `error.permanent` are included at detailed telemetry level. |
| `otelcol_exporter_send_failed_profile_samples` | Counter | `{sample}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | Emitted for failed sends; `error.type` and `error.permanent` are included at detailed telemetry level. |
| `otelcol_exporter_send_failed_spans` | Counter | `{span}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | Emitted for failed sends; `error.type` and `error.permanent` are included at detailed telemetry level. |
| `otelcol_exporter_sent_log_records` | Counter | `{record}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent log records. |
| `otelcol_exporter_sent_metric_points` | Counter | `{datapoint}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent metric points. |
| `otelcol_exporter_sent_profile_samples` | Counter | `{sample}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent profile samples. |
| `otelcol_exporter_sent_spans` | Counter | `{span}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent spans. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `Partial success response` | `message`; one of `dropped_spans`, `dropped_data_points`, `dropped_log_records`, or `dropped_profiles` | Emitted at WARN level when the OTLP response reports an error message or rejected items. |

## Sources

- `exporter/otlpexporter/factory.go`
- `exporter/otlpexporter/otlp.go`
- `exporter/otlpexporter/internal/metadata/generated_status.go`
- `exporter/exporterhelper/metadata.yaml`
- `exporter/exporterhelper/internal/metadata/generated_telemetry.go`
- `exporter/exporterhelper/internal/metadata/generated_feature_gates.go`
- `exporter/exporterhelper/internal/obs_report_sender.go`
- `exporter/exporterhelper/internal/queue/obs_queue.go`
        • v0.163.0.md 5.4 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/otlpexporter
version: v0.163.0
scope_name: go.opentelemetry.io/collector/exporter/exporterhelper
commit_sha: 5177a6a85ca3783068077e25aec6cebbe1d50d1f
last_verified: 2026-10-14
---

# OTLP exporter

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `exporter/<exporter ID>/<signal>` | INTERNAL | `exporter=<exporter ID>`; `data_type=<traces\|metrics\|logs\|profiles>` | Created by exporterhelper for each export request; includes queue links when queued. Sets `items.sent` and `items.failed`; errors set span status to ERROR. |
| `exporter/enqueue` | INTERNAL | - | Created when a sending queue is configured, for each queue offer. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_exporter_enqueue_failed_log_records` | Counter | `{record}` | `exporter` | Queue configured; emitted when log records cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_metric_points` | Counter | `{datapoint}` | `exporter` | Queue configured; emitted when metric points cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_profile_samples` | Counter | `{sample}` | `exporter` | Queue configured; emitted when profile samples cannot be enqueued. |
| `otelcol_exporter_enqueue_failed_spans` | Counter | `{span}` | `exporter` | Queue configured; emitted when spans cannot be enqueued. |
| `otelcol_exporter_enqueue_size` | Histogram | `{unit}` | `exporter` | Queue configured; emitted at detailed telemetry level for each offered request. |
| `otelcol_exporter_enqueue_size_bytes` | Histogram | `By` | `exporter` | Queue configured; emitted at detailed telemetry level for each offered request. |
| `otelcol_exporter_in_flight_requests` | UpDownCounter | `{request}` | `exporter`; `data_type` | Includes requests in retry backoff. |
| `otelcol_exporter_queue_batch_partition_cache_capacity` | Gauge | `{partition}` | `exporter`; `data_type` | Batching configured with non-empty `sending_queue.batch.partition.metadata_keys`; asynchronous maximum number of active partition batchers in the LRU cache. |
| `otelcol_exporter_queue_batch_partition_cache_size` | Gauge | `{partition}` | `exporter`; `data_type` | Batching configured with non-empty `sending_queue.batch.partition.metadata_keys`; asynchronous current number of active partition batchers in the LRU cache. |
| `otelcol_exporter_queue_batch_send_size` | Histogram | `{unit}` | `exporter` | Queue configured and batching enabled; emitted at detailed telemetry level. The default queue batching behavior is controlled by feature gate `pkg.exporterhelper.queueBatchEnabled`. |
| `otelcol_exporter_queue_batch_send_size_bytes` | Histogram | `By` | `exporter` | Queue configured and batching enabled; emitted at detailed telemetry level. The default queue batching behavior is controlled by feature gate `pkg.exporterhelper.queueBatchEnabled`. |
| `otelcol_exporter_queue_capacity` | Gauge | `{batch}` | `exporter`; `data_type` | Queue configured; asynchronous fixed retry-queue capacity. |
| `otelcol_exporter_queue_size` | Gauge | `{batch}` | `exporter`; `data_type` | Queue configured; asynchronous current retry-queue size. |
| `otelcol_exporter_send_failed_log_records` | Counter | `{record}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | Emitted for failed sends; `error.type` and `error.permanent` are included at detailed telemetry level. |
| `otelcol_exporter_send_failed_metric_points` | Counter | `{datapoint}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | Emitted for failed sends; `error.type` and `error.permanent` are included at detailed telemetry level. |
| `otelcol_exporter_send_failed_profile_samples` | Counter | `{sample}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | Emitted for failed sends; `error.type` and `error.permanent` are included at detailed telemetry level. |
| `otelcol_exporter_send_failed_spans` | Counter | `{span}` | `exporter`; `server.address`; `server.port`; `error.type`; `error.permanent` | Emitted for failed sends; `error.type` and `error.permanent` are included at detailed telemetry level. |
| `otelcol_exporter_sent_log_records` | Counter | `{record}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent log records. |
| `otelcol_exporter_sent_metric_points` | Counter | `{datapoint}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent metric points. |
| `otelcol_exporter_sent_profile_samples` | Counter | `{sample}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent profile samples. |
| `otelcol_exporter_sent_spans` | Counter | `{span}` | `exporter`; `server.address`; `server.port` | Emitted for successfully sent spans. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `Partial success response` | `message`; one of `dropped_spans`, `dropped_data_points`, `dropped_log_records`, or `dropped_profiles` | Emitted at WARN level when the OTLP response reports an error message or rejected items. |

## Sources

- `exporter/otlpexporter/factory.go`
- `exporter/otlpexporter/otlp.go`
- `exporter/otlpexporter/internal/metadata/generated_status.go`
- `exporter/exporterhelper/metadata.yaml`
- `exporter/exporterhelper/internal/metadata/generated_telemetry.go`
- `exporter/exporterhelper/internal/metadata/generated_feature_gates.go`
- `exporter/exporterhelper/internal/obs_report_sender.go`
- `exporter/exporterhelper/internal/queue/obs_queue.go`
      • otlphttpexporter
        • v0.153.0.md 3.8 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/otlphttpexporter
version: v0.153.0
scope_name: go.opentelemetry.io/collector/exporter/otlphttpexporter
commit_sha: 452cae1662730600abfb76517f5d20bf7d64ed09
last_verified: 2026-08-11
---

# OTLP HTTP Exporter

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `exporter/<exporter-id>/<signal>` | Internal | `exporter`, `data_type`, `items.sent`, `items.failed` | Emitted by exporterhelper for traces, metrics, logs, and profiles; profile spans are used when the alpha profiles signal is enabled. |
| `exporter/enqueue` | Internal | - | Emitted when the sending queue is enabled; one span per queue offer. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_exporter_enqueue_failed_log_records` | Sum (monotonic) | `{record}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_enqueue_failed_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_enqueue_failed_profile_samples` | Sum (monotonic) | `{sample}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails; profiles are alpha. |
| `otelcol_exporter_enqueue_failed_spans` | Sum (monotonic) | `{span}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_in_flight_requests` | UpDownCounter | `{request}` | `exporter`, `data_type` | - |
| `otelcol_exporter_queue_batch_send_size` | Histogram | `{unit}` | `exporter` | Emitted when the sending queue is enabled. |
| `otelcol_exporter_queue_batch_send_size_bytes` | Histogram | `By` | `exporter` | Emitted when the sending queue is enabled and telemetry is at the detailed level. |
| `otelcol_exporter_queue_capacity` | Gauge (observable) | `{batch}` | `exporter`, `data_type` | Emitted when the sending queue is enabled. |
| `otelcol_exporter_queue_size` | Gauge (observable) | `{batch}` | `exporter`, `data_type` | Emitted when the sending queue is enabled. |
| `otelcol_exporter_send_failed_log_records` | Sum (monotonic) | `{record}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_send_failed_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_send_failed_profile_samples` | Sum (monotonic) | `{sample}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | Profiles are alpha. |
| `otelcol_exporter_send_failed_spans` | Sum (monotonic) | `{span}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_sent_log_records` | Sum (monotonic) | `{record}` | `exporter`, `server.address`, `url.path`, `server.port` | - |
| `otelcol_exporter_sent_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter`, `server.address`, `url.path`, `server.port` | - |
| `otelcol_exporter_sent_profile_samples` | Sum (monotonic) | `{sample}` | `exporter`, `server.address`, `url.path`, `server.port` | Profiles are alpha. |
| `otelcol_exporter_sent_spans` | Sum (monotonic) | `{span}` | `exporter`, `server.address`, `url.path`, `server.port` | - |

## Sources

- `exporter/otlphttpexporter/factory.go`
- `exporter/otlphttpexporter/metadata.yaml`
- `exporter/otlphttpexporter/internal/metadata/generated_status.go`
- `exporter/exporterhelper/metadata.yaml`
- `exporter/exporterhelper/internal/obs_report_sender.go`
- `exporter/exporterhelper/internal/queue/obs_queue.go`
- `exporter/exporterhelper/internal/metadata/generated_telemetry.go`
        • v0.154.0.md 3.8 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/otlphttpexporter
version: v0.154.0
scope_name: go.opentelemetry.io/collector/exporter/otlphttpexporter
commit_sha: dbed6ad641b872a581f79e7b6f28f315c1592e02
last_verified: 2026-08-11
---

# OTLP HTTP Exporter

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `exporter/<exporter-id>/<signal>` | Internal | `exporter`, `data_type`, `items.sent`, `items.failed` | Emitted by exporterhelper for traces, metrics, logs, and profiles; profile spans are used when the alpha profiles signal is enabled. |
| `exporter/enqueue` | Internal | - | Emitted when the sending queue is enabled; one span per queue offer. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_exporter_enqueue_failed_log_records` | Sum (monotonic) | `{record}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_enqueue_failed_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_enqueue_failed_profile_samples` | Sum (monotonic) | `{sample}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails; profiles are alpha. |
| `otelcol_exporter_enqueue_failed_spans` | Sum (monotonic) | `{span}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_in_flight_requests` | UpDownCounter | `{request}` | `exporter`, `data_type` | - |
| `otelcol_exporter_queue_batch_send_size` | Histogram | `{unit}` | `exporter` | Emitted when the sending queue is enabled. |
| `otelcol_exporter_queue_batch_send_size_bytes` | Histogram | `By` | `exporter` | Emitted when the sending queue is enabled and telemetry is at the detailed level. |
| `otelcol_exporter_queue_capacity` | Gauge (observable) | `{batch}` | `exporter`, `data_type` | Emitted when the sending queue is enabled. |
| `otelcol_exporter_queue_size` | Gauge (observable) | `{batch}` | `exporter`, `data_type` | Emitted when the sending queue is enabled. |
| `otelcol_exporter_send_failed_log_records` | Sum (monotonic) | `{record}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_send_failed_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_send_failed_profile_samples` | Sum (monotonic) | `{sample}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | Profiles are alpha. |
| `otelcol_exporter_send_failed_spans` | Sum (monotonic) | `{span}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_sent_log_records` | Sum (monotonic) | `{record}` | `exporter`, `server.address`, `url.path`, `server.port` | - |
| `otelcol_exporter_sent_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter`, `server.address`, `url.path`, `server.port` | - |
| `otelcol_exporter_sent_profile_samples` | Sum (monotonic) | `{sample}` | `exporter`, `server.address`, `url.path`, `server.port` | Profiles are alpha. |
| `otelcol_exporter_sent_spans` | Sum (monotonic) | `{span}` | `exporter`, `server.address`, `url.path`, `server.port` | - |

## Sources

- `exporter/otlphttpexporter/factory.go`
- `exporter/otlphttpexporter/metadata.yaml`
- `exporter/otlphttpexporter/internal/metadata/generated_status.go`
- `exporter/exporterhelper/metadata.yaml`
- `exporter/exporterhelper/internal/obs_report_sender.go`
- `exporter/exporterhelper/internal/queue/obs_queue.go`
- `exporter/exporterhelper/internal/metadata/generated_telemetry.go`
        • v0.155.0.md 3.8 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/otlphttpexporter
version: v0.155.0
scope_name: go.opentelemetry.io/collector/exporter/otlphttpexporter
commit_sha: 41da2fbd7dd58a5dd299587ebb159025b28521d2
last_verified: 2026-08-11
---

# OTLP HTTP Exporter

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `exporter/<exporter-id>/<signal>` | Internal | `exporter`, `data_type`, `items.sent`, `items.failed` | Emitted by exporterhelper for traces, metrics, logs, and profiles; profile spans are used when the alpha profiles signal is enabled. |
| `exporter/enqueue` | Internal | - | Emitted when the sending queue is enabled; one span per queue offer. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_exporter_enqueue_failed_log_records` | Sum (monotonic) | `{record}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_enqueue_failed_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_enqueue_failed_profile_samples` | Sum (monotonic) | `{sample}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails; profiles are alpha. |
| `otelcol_exporter_enqueue_failed_spans` | Sum (monotonic) | `{span}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_in_flight_requests` | UpDownCounter | `{request}` | `exporter`, `data_type` | - |
| `otelcol_exporter_queue_batch_send_size` | Histogram | `{unit}` | `exporter` | Emitted when the sending queue is enabled. |
| `otelcol_exporter_queue_batch_send_size_bytes` | Histogram | `By` | `exporter` | Emitted when the sending queue is enabled and telemetry is at the detailed level. |
| `otelcol_exporter_queue_capacity` | Gauge (observable) | `{batch}` | `exporter`, `data_type` | Emitted when the sending queue is enabled. |
| `otelcol_exporter_queue_size` | Gauge (observable) | `{batch}` | `exporter`, `data_type` | Emitted when the sending queue is enabled. |
| `otelcol_exporter_send_failed_log_records` | Sum (monotonic) | `{record}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_send_failed_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_send_failed_profile_samples` | Sum (monotonic) | `{sample}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | Profiles are alpha. |
| `otelcol_exporter_send_failed_spans` | Sum (monotonic) | `{span}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_sent_log_records` | Sum (monotonic) | `{record}` | `exporter`, `server.address`, `url.path`, `server.port` | - |
| `otelcol_exporter_sent_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter`, `server.address`, `url.path`, `server.port` | - |
| `otelcol_exporter_sent_profile_samples` | Sum (monotonic) | `{sample}` | `exporter`, `server.address`, `url.path`, `server.port` | Profiles are alpha. |
| `otelcol_exporter_sent_spans` | Sum (monotonic) | `{span}` | `exporter`, `server.address`, `url.path`, `server.port` | - |

## Sources

- `exporter/otlphttpexporter/factory.go`
- `exporter/otlphttpexporter/metadata.yaml`
- `exporter/otlphttpexporter/internal/metadata/generated_status.go`
- `exporter/exporterhelper/metadata.yaml`
- `exporter/exporterhelper/internal/obs_report_sender.go`
- `exporter/exporterhelper/internal/queue/obs_queue.go`
- `exporter/exporterhelper/internal/metadata/generated_telemetry.go`
        • v0.156.0.md 3.8 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/otlphttpexporter
version: v0.156.0
scope_name: go.opentelemetry.io/collector/exporter/otlphttpexporter
commit_sha: 0a6056f97e2e5fe8f3a52a45bc26d3fb64b731d4
last_verified: 2026-08-11
---

# OTLP HTTP Exporter

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `exporter/<exporter-id>/<signal>` | Internal | `exporter`, `data_type`, `items.sent`, `items.failed` | Emitted by exporterhelper for traces, metrics, logs, and profiles; profile spans are used when the alpha profiles signal is enabled. |
| `exporter/enqueue` | Internal | - | Emitted when the sending queue is enabled; one span per queue offer. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_exporter_enqueue_failed_log_records` | Sum (monotonic) | `{record}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_enqueue_failed_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_enqueue_failed_profile_samples` | Sum (monotonic) | `{sample}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails; profiles are alpha. |
| `otelcol_exporter_enqueue_failed_spans` | Sum (monotonic) | `{span}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_in_flight_requests` | UpDownCounter | `{request}` | `exporter`, `data_type` | - |
| `otelcol_exporter_queue_batch_send_size` | Histogram | `{unit}` | `exporter` | Emitted when the sending queue is enabled. |
| `otelcol_exporter_queue_batch_send_size_bytes` | Histogram | `By` | `exporter` | Emitted when the sending queue is enabled and telemetry is at the detailed level. |
| `otelcol_exporter_queue_capacity` | Gauge (observable) | `{batch}` | `exporter`, `data_type` | Emitted when the sending queue is enabled. |
| `otelcol_exporter_queue_size` | Gauge (observable) | `{batch}` | `exporter`, `data_type` | Emitted when the sending queue is enabled. |
| `otelcol_exporter_send_failed_log_records` | Sum (monotonic) | `{record}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_send_failed_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_send_failed_profile_samples` | Sum (monotonic) | `{sample}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | Profiles are alpha. |
| `otelcol_exporter_send_failed_spans` | Sum (monotonic) | `{span}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_sent_log_records` | Sum (monotonic) | `{record}` | `exporter`, `server.address`, `url.path`, `server.port` | - |
| `otelcol_exporter_sent_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter`, `server.address`, `url.path`, `server.port` | - |
| `otelcol_exporter_sent_profile_samples` | Sum (monotonic) | `{sample}` | `exporter`, `server.address`, `url.path`, `server.port` | Profiles are alpha. |
| `otelcol_exporter_sent_spans` | Sum (monotonic) | `{span}` | `exporter`, `server.address`, `url.path`, `server.port` | - |

## Sources

- `exporter/otlphttpexporter/factory.go`
- `exporter/otlphttpexporter/metadata.yaml`
- `exporter/otlphttpexporter/internal/metadata/generated_status.go`
- `exporter/exporterhelper/metadata.yaml`
- `exporter/exporterhelper/internal/obs_report_sender.go`
- `exporter/exporterhelper/internal/queue/obs_queue.go`
- `exporter/exporterhelper/internal/metadata/generated_telemetry.go`
        • v0.157.0.md 3.8 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/otlphttpexporter
version: v0.157.0
scope_name: go.opentelemetry.io/collector/exporter/otlphttpexporter
commit_sha: 4908404e59e544297b989a6961ee918b6f84b606
last_verified: 2026-08-11
---

# OTLP HTTP Exporter

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `exporter/<exporter-id>/<signal>` | Internal | `exporter`, `data_type`, `items.sent`, `items.failed` | Emitted by exporterhelper for traces, metrics, logs, and profiles; profile spans are used when the alpha profiles signal is enabled. |
| `exporter/enqueue` | Internal | - | Emitted when the sending queue is enabled; one span per queue offer. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_exporter_enqueue_failed_log_records` | Sum (monotonic) | `{record}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_enqueue_failed_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_enqueue_failed_profile_samples` | Sum (monotonic) | `{sample}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails; profiles are alpha. |
| `otelcol_exporter_enqueue_failed_spans` | Sum (monotonic) | `{span}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_in_flight_requests` | UpDownCounter | `{request}` | `exporter`, `data_type` | - |
| `otelcol_exporter_queue_batch_send_size` | Histogram | `{unit}` | `exporter` | Emitted when the sending queue is enabled. |
| `otelcol_exporter_queue_batch_send_size_bytes` | Histogram | `By` | `exporter` | Emitted when the sending queue is enabled and telemetry is at the detailed level. |
| `otelcol_exporter_queue_capacity` | Gauge (observable) | `{batch}` | `exporter`, `data_type` | Emitted when the sending queue is enabled. |
| `otelcol_exporter_queue_size` | Gauge (observable) | `{batch}` | `exporter`, `data_type` | Emitted when the sending queue is enabled. |
| `otelcol_exporter_send_failed_log_records` | Sum (monotonic) | `{record}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_send_failed_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_send_failed_profile_samples` | Sum (monotonic) | `{sample}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | Profiles are alpha. |
| `otelcol_exporter_send_failed_spans` | Sum (monotonic) | `{span}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_sent_log_records` | Sum (monotonic) | `{record}` | `exporter`, `server.address`, `url.path`, `server.port` | - |
| `otelcol_exporter_sent_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter`, `server.address`, `url.path`, `server.port` | - |
| `otelcol_exporter_sent_profile_samples` | Sum (monotonic) | `{sample}` | `exporter`, `server.address`, `url.path`, `server.port` | Profiles are alpha. |
| `otelcol_exporter_sent_spans` | Sum (monotonic) | `{span}` | `exporter`, `server.address`, `url.path`, `server.port` | - |

## Sources

- `exporter/otlphttpexporter/factory.go`
- `exporter/otlphttpexporter/metadata.yaml`
- `exporter/otlphttpexporter/internal/metadata/generated_status.go`
- `exporter/exporterhelper/metadata.yaml`
- `exporter/exporterhelper/internal/obs_report_sender.go`
- `exporter/exporterhelper/internal/queue/obs_queue.go`
- `exporter/exporterhelper/internal/metadata/generated_telemetry.go`
        • v0.158.0.md 3.8 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/otlphttpexporter
version: v0.158.0
scope_name: go.opentelemetry.io/collector/exporter/otlphttpexporter
commit_sha: 0378e9add75d42e35f621a2df1c9ae819aa10778
last_verified: 2026-08-11
---

# OTLP HTTP Exporter

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `exporter/<exporter-id>/<signal>` | Internal | `exporter`, `data_type`, `items.sent`, `items.failed` | Emitted by exporterhelper for traces, metrics, logs, and profiles; profile spans are used when the alpha profiles signal is enabled. |
| `exporter/enqueue` | Internal | - | Emitted when the sending queue is enabled; one span per queue offer. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_exporter_enqueue_failed_log_records` | Sum (monotonic) | `{record}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_enqueue_failed_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_enqueue_failed_profile_samples` | Sum (monotonic) | `{sample}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails; profiles are alpha. |
| `otelcol_exporter_enqueue_failed_spans` | Sum (monotonic) | `{span}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_in_flight_requests` | UpDownCounter | `{request}` | `exporter`, `data_type` | - |
| `otelcol_exporter_queue_batch_send_size` | Histogram | `{unit}` | `exporter` | Emitted when the sending queue is enabled. |
| `otelcol_exporter_queue_batch_send_size_bytes` | Histogram | `By` | `exporter` | Emitted when the sending queue is enabled and telemetry is at the detailed level. |
| `otelcol_exporter_queue_capacity` | Gauge (observable) | `{batch}` | `exporter`, `data_type` | Emitted when the sending queue is enabled. |
| `otelcol_exporter_queue_size` | Gauge (observable) | `{batch}` | `exporter`, `data_type` | Emitted when the sending queue is enabled. |
| `otelcol_exporter_send_failed_log_records` | Sum (monotonic) | `{record}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_send_failed_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_send_failed_profile_samples` | Sum (monotonic) | `{sample}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | Profiles are alpha. |
| `otelcol_exporter_send_failed_spans` | Sum (monotonic) | `{span}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_sent_log_records` | Sum (monotonic) | `{record}` | `exporter`, `server.address`, `url.path`, `server.port` | - |
| `otelcol_exporter_sent_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter`, `server.address`, `url.path`, `server.port` | - |
| `otelcol_exporter_sent_profile_samples` | Sum (monotonic) | `{sample}` | `exporter`, `server.address`, `url.path`, `server.port` | Profiles are alpha. |
| `otelcol_exporter_sent_spans` | Sum (monotonic) | `{span}` | `exporter`, `server.address`, `url.path`, `server.port` | - |

## Sources

- `exporter/otlphttpexporter/factory.go`
- `exporter/otlphttpexporter/metadata.yaml`
- `exporter/otlphttpexporter/internal/metadata/generated_status.go`
- `exporter/exporterhelper/metadata.yaml`
- `exporter/exporterhelper/internal/obs_report_sender.go`
- `exporter/exporterhelper/internal/queue/obs_queue.go`
- `exporter/exporterhelper/internal/metadata/generated_telemetry.go`
        • v0.159.0.md 4 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/otlphttpexporter
version: v0.159.0
scope_name: go.opentelemetry.io/collector/exporter/otlphttpexporter
commit_sha: 69c0873044e80fe1f0647a0bc5afec6244bcad76
last_verified: 2026-08-24
---

# OTLP HTTP Exporter

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `exporter/<exporter-id>/<signal>` | Internal | `exporter`, `data_type`, `items.sent`, `items.failed` | Emitted by exporterhelper for traces, metrics, logs, and profiles; profile spans are used when the alpha profiles signal is enabled. |
| `exporter/enqueue` | Internal | - | Emitted when the sending queue is enabled; one span per queue offer. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_exporter_enqueue_failed_log_records` | Sum (monotonic) | `{record}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_enqueue_failed_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_enqueue_failed_profile_samples` | Sum (monotonic) | `{sample}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails; profiles are alpha. |
| `otelcol_exporter_enqueue_failed_spans` | Sum (monotonic) | `{span}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_enqueue_size` | Histogram | `{unit}` | `exporter` | Emitted when the sending queue is enabled; available at the detailed telemetry level. |
| `otelcol_exporter_enqueue_size_bytes` | Histogram | `By` | `exporter` | Emitted when the sending queue is enabled and at the detailed telemetry level. |
| `otelcol_exporter_in_flight_requests` | UpDownCounter | `{request}` | `exporter`, `data_type` | - |
| `otelcol_exporter_queue_batch_send_size` | Histogram | `{unit}` | `exporter` | Emitted when exporter batching is enabled and at the detailed telemetry level. |
| `otelcol_exporter_queue_batch_send_size_bytes` | Histogram | `By` | `exporter` | Emitted when exporter batching is enabled and at the detailed telemetry level. |
| `otelcol_exporter_queue_capacity` | Gauge (observable) | `{batch}` | `exporter`, `data_type` | Emitted when the sending queue is enabled. |
| `otelcol_exporter_queue_size` | Gauge (observable) | `{batch}` | `exporter`, `data_type` | Emitted when the sending queue is enabled. |
| `otelcol_exporter_send_failed_log_records` | Sum (monotonic) | `{record}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_send_failed_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_send_failed_profile_samples` | Sum (monotonic) | `{sample}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | Profiles are alpha. |
| `otelcol_exporter_send_failed_spans` | Sum (monotonic) | `{span}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_sent_log_records` | Sum (monotonic) | `{record}` | `exporter`, `server.address`, `url.path`, `server.port` | - |
| `otelcol_exporter_sent_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter`, `server.address`, `url.path`, `server.port` | - |
| `otelcol_exporter_sent_profile_samples` | Sum (monotonic) | `{sample}` | `exporter`, `server.address`, `url.path`, `server.port` | Profiles are alpha. |
| `otelcol_exporter_sent_spans` | Sum (monotonic) | `{span}` | `exporter`, `server.address`, `url.path`, `server.port` | - |

## Sources

- `exporter/otlphttpexporter/factory.go`
- `exporter/otlphttpexporter/metadata.yaml`
- `exporter/exporterhelper/internal/obs_report_sender.go`
- `exporter/exporterhelper/internal/queue/obs_queue.go`
- `exporter/exporterhelper/internal/metadata/generated_telemetry.go`
        • v0.160.0.md 4 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/otlphttpexporter
version: v0.160.0
scope_name: go.opentelemetry.io/collector/exporter/otlphttpexporter
commit_sha: cd3455cf3a7f672208140b1ebb1581c542b2b0ed
last_verified: 2026-09-03
---

# OTLP HTTP Exporter

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `exporter/<exporter-id>/<signal>` | Internal | `exporter`, `data_type`, `items.sent`, `items.failed` | Emitted by exporterhelper for traces, metrics, logs, and profiles; profile spans are used when the alpha profiles signal is enabled. |
| `exporter/enqueue` | Internal | - | Emitted when the sending queue is enabled; one span per queue offer. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_exporter_enqueue_failed_log_records` | Sum (monotonic) | `{record}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_enqueue_failed_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_enqueue_failed_profile_samples` | Sum (monotonic) | `{sample}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails; profiles are alpha. |
| `otelcol_exporter_enqueue_failed_spans` | Sum (monotonic) | `{span}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_enqueue_size` | Histogram | `{unit}` | `exporter` | Emitted when the sending queue is enabled; available at the detailed telemetry level. |
| `otelcol_exporter_enqueue_size_bytes` | Histogram | `By` | `exporter` | Emitted when the sending queue is enabled and at the detailed telemetry level. |
| `otelcol_exporter_in_flight_requests` | UpDownCounter | `{request}` | `exporter`, `data_type` | - |
| `otelcol_exporter_queue_batch_send_size` | Histogram | `{unit}` | `exporter` | Emitted when exporter batching is enabled and at the detailed telemetry level. |
| `otelcol_exporter_queue_batch_send_size_bytes` | Histogram | `By` | `exporter` | Emitted when exporter batching is enabled and at the detailed telemetry level. |
| `otelcol_exporter_queue_capacity` | Gauge (observable) | `{batch}` | `exporter`, `data_type` | Emitted when the sending queue is enabled. |
| `otelcol_exporter_queue_size` | Gauge (observable) | `{batch}` | `exporter`, `data_type` | Emitted when the sending queue is enabled. |
| `otelcol_exporter_send_failed_log_records` | Sum (monotonic) | `{record}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_send_failed_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_send_failed_profile_samples` | Sum (monotonic) | `{sample}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | Profiles are alpha. |
| `otelcol_exporter_send_failed_spans` | Sum (monotonic) | `{span}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_sent_log_records` | Sum (monotonic) | `{record}` | `exporter`, `server.address`, `url.path`, `server.port` | - |
| `otelcol_exporter_sent_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter`, `server.address`, `url.path`, `server.port` | - |
| `otelcol_exporter_sent_profile_samples` | Sum (monotonic) | `{sample}` | `exporter`, `server.address`, `url.path`, `server.port` | Profiles are alpha. |
| `otelcol_exporter_sent_spans` | Sum (monotonic) | `{span}` | `exporter`, `server.address`, `url.path`, `server.port` | - |

## Sources

- `exporter/otlphttpexporter/factory.go`
- `exporter/otlphttpexporter/metadata.yaml`
- `exporter/exporterhelper/internal/obs_report_sender.go`
- `exporter/exporterhelper/internal/queue/obs_queue.go`
- `exporter/exporterhelper/internal/metadata/generated_telemetry.go`
        • v0.161.0.md 4 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/otlphttpexporter
version: v0.161.0
scope_name: go.opentelemetry.io/collector/exporter/otlphttpexporter
commit_sha: 0bf928af5487d3c4e0b4174eabb7ba075c322517
last_verified: 2026-10-03
---

# OTLP HTTP Exporter

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `exporter/<exporter-id>/<signal>` | Internal | `exporter`, `data_type`, `items.sent`, `items.failed` | Emitted by exporterhelper for traces, metrics, logs, and profiles; profile spans are used when the alpha profiles signal is enabled. |
| `exporter/enqueue` | Internal | - | Emitted when the sending queue is enabled; one span per queue offer. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_exporter_enqueue_failed_log_records` | Sum (monotonic) | `{record}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_enqueue_failed_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_enqueue_failed_profile_samples` | Sum (monotonic) | `{sample}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails; profiles are alpha. |
| `otelcol_exporter_enqueue_failed_spans` | Sum (monotonic) | `{span}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_enqueue_size` | Histogram | `{unit}` | `exporter` | Emitted when the sending queue is enabled; available at the detailed telemetry level. |
| `otelcol_exporter_enqueue_size_bytes` | Histogram | `By` | `exporter` | Emitted when the sending queue is enabled and at the detailed telemetry level. |
| `otelcol_exporter_in_flight_requests` | UpDownCounter | `{request}` | `exporter`, `data_type` | - |
| `otelcol_exporter_queue_batch_send_size` | Histogram | `{unit}` | `exporter` | Emitted when exporter batching is enabled and at the detailed telemetry level. |
| `otelcol_exporter_queue_batch_send_size_bytes` | Histogram | `By` | `exporter` | Emitted when exporter batching is enabled and at the detailed telemetry level. |
| `otelcol_exporter_queue_capacity` | Gauge (observable) | `{batch}` | `exporter`, `data_type` | Emitted when the sending queue is enabled. |
| `otelcol_exporter_queue_size` | Gauge (observable) | `{batch}` | `exporter`, `data_type` | Emitted when the sending queue is enabled. |
| `otelcol_exporter_send_failed_log_records` | Sum (monotonic) | `{record}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_send_failed_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_send_failed_profile_samples` | Sum (monotonic) | `{sample}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | Profiles are alpha. |
| `otelcol_exporter_send_failed_spans` | Sum (monotonic) | `{span}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_sent_log_records` | Sum (monotonic) | `{record}` | `exporter`, `server.address`, `url.path`, `server.port` | - |
| `otelcol_exporter_sent_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter`, `server.address`, `url.path`, `server.port` | - |
| `otelcol_exporter_sent_profile_samples` | Sum (monotonic) | `{sample}` | `exporter`, `server.address`, `url.path`, `server.port` | Profiles are alpha. |
| `otelcol_exporter_sent_spans` | Sum (monotonic) | `{span}` | `exporter`, `server.address`, `url.path`, `server.port` | - |

## Sources

- `exporter/otlphttpexporter/factory.go`
- `exporter/otlphttpexporter/metadata.yaml`
- `exporter/exporterhelper/internal/obs_report_sender.go`
- `exporter/exporterhelper/internal/queue/obs_queue.go`
- `exporter/exporterhelper/internal/metadata/generated_telemetry.go`
        • v0.162.0.md 4.5 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/otlphttpexporter
version: v0.162.0
scope_name: go.opentelemetry.io/collector/exporter/otlphttpexporter
commit_sha: 62cdad2ea133239380b44d20d84eb26e114779b6
last_verified: 2026-10-03
---

# OTLP HTTP Exporter

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `exporter/<exporter-id>/<signal>` | Internal | `exporter`, `data_type`, `items.sent`, `items.failed` | Emitted by exporterhelper for traces, metrics, logs, and profiles; profile spans are used when the alpha profiles signal is enabled. |
| `exporter/enqueue` | Internal | - | Emitted when the sending queue is enabled; one span per queue offer. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_exporter_enqueue_failed_log_records` | Sum (monotonic) | `{record}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_enqueue_failed_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_enqueue_failed_profile_samples` | Sum (monotonic) | `{sample}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails; profiles are alpha. |
| `otelcol_exporter_enqueue_failed_spans` | Sum (monotonic) | `{span}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_enqueue_size` | Histogram | `{unit}` | `exporter` | Emitted when the sending queue is enabled; available at the detailed telemetry level. |
| `otelcol_exporter_enqueue_size_bytes` | Histogram | `By` | `exporter` | Emitted when the sending queue is enabled and at the detailed telemetry level. |
| `otelcol_exporter_in_flight_requests` | UpDownCounter | `{request}` | `exporter`, `data_type` | - |
| `otelcol_exporter_queue_batch_partition_cache_capacity` | Gauge (observable) | `{partition}` | `exporter`, `data_type` | Emitted when batching is enabled with non-empty `sending_queue.batch.partition.metadata_keys`; maximum number of active partition batchers in the LRU cache. |
| `otelcol_exporter_queue_batch_partition_cache_size` | Gauge (observable) | `{partition}` | `exporter`, `data_type` | Emitted when batching is enabled with non-empty `sending_queue.batch.partition.metadata_keys`; current number of active partition batchers in the LRU cache. |
| `otelcol_exporter_queue_batch_send_size` | Histogram | `{unit}` | `exporter` | Emitted when exporter batching is enabled and at the detailed telemetry level. |
| `otelcol_exporter_queue_batch_send_size_bytes` | Histogram | `By` | `exporter` | Emitted when exporter batching is enabled and at the detailed telemetry level. |
| `otelcol_exporter_queue_capacity` | Gauge (observable) | `{batch}` | `exporter`, `data_type` | Emitted when the sending queue is enabled. |
| `otelcol_exporter_queue_size` | Gauge (observable) | `{batch}` | `exporter`, `data_type` | Emitted when the sending queue is enabled. |
| `otelcol_exporter_send_failed_log_records` | Sum (monotonic) | `{record}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_send_failed_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_send_failed_profile_samples` | Sum (monotonic) | `{sample}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | Profiles are alpha. |
| `otelcol_exporter_send_failed_spans` | Sum (monotonic) | `{span}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_sent_log_records` | Sum (monotonic) | `{record}` | `exporter`, `server.address`, `url.path`, `server.port` | - |
| `otelcol_exporter_sent_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter`, `server.address`, `url.path`, `server.port` | - |
| `otelcol_exporter_sent_profile_samples` | Sum (monotonic) | `{sample}` | `exporter`, `server.address`, `url.path`, `server.port` | Profiles are alpha. |
| `otelcol_exporter_sent_spans` | Sum (monotonic) | `{span}` | `exporter`, `server.address`, `url.path`, `server.port` | - |

## Sources

- `exporter/otlphttpexporter/factory.go`
- `exporter/otlphttpexporter/metadata.yaml`
- `exporter/exporterhelper/internal/obs_report_sender.go`
- `exporter/exporterhelper/internal/queue/obs_queue.go`
- `exporter/exporterhelper/internal/metadata/generated_telemetry.go`
        • v0.163.0.md 4.5 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: exporter/otlphttpexporter
version: v0.163.0
scope_name: go.opentelemetry.io/collector/exporter/otlphttpexporter
commit_sha: 5177a6a85ca3783068077e25aec6cebbe1d50d1f
last_verified: 2026-10-14
---

# OTLP HTTP Exporter

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `exporter/<exporter-id>/<signal>` | Internal | `exporter`, `data_type`, `items.sent`, `items.failed` | Emitted by exporterhelper for traces, metrics, logs, and profiles; profile spans are used when the alpha profiles signal is enabled. |
| `exporter/enqueue` | Internal | - | Emitted when the sending queue is enabled; one span per queue offer. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_exporter_enqueue_failed_log_records` | Sum (monotonic) | `{record}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_enqueue_failed_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_enqueue_failed_profile_samples` | Sum (monotonic) | `{sample}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails; profiles are alpha. |
| `otelcol_exporter_enqueue_failed_spans` | Sum (monotonic) | `{span}` | `exporter` | Emitted when the sending queue is enabled and enqueue fails. |
| `otelcol_exporter_enqueue_size` | Histogram | `{unit}` | `exporter` | Emitted when the sending queue is enabled; available at the detailed telemetry level. |
| `otelcol_exporter_enqueue_size_bytes` | Histogram | `By` | `exporter` | Emitted when the sending queue is enabled and at the detailed telemetry level. |
| `otelcol_exporter_in_flight_requests` | UpDownCounter | `{request}` | `exporter`, `data_type` | - |
| `otelcol_exporter_queue_batch_partition_cache_capacity` | Gauge (observable) | `{partition}` | `exporter`, `data_type` | Emitted when batching is enabled with non-empty `sending_queue.batch.partition.metadata_keys`; maximum number of active partition batchers in the LRU cache. |
| `otelcol_exporter_queue_batch_partition_cache_size` | Gauge (observable) | `{partition}` | `exporter`, `data_type` | Emitted when batching is enabled with non-empty `sending_queue.batch.partition.metadata_keys`; current number of active partition batchers in the LRU cache. |
| `otelcol_exporter_queue_batch_send_size` | Histogram | `{unit}` | `exporter` | Emitted when exporter batching is enabled and at the detailed telemetry level. |
| `otelcol_exporter_queue_batch_send_size_bytes` | Histogram | `By` | `exporter` | Emitted when exporter batching is enabled and at the detailed telemetry level. |
| `otelcol_exporter_queue_capacity` | Gauge (observable) | `{batch}` | `exporter`, `data_type` | Emitted when the sending queue is enabled. |
| `otelcol_exporter_queue_size` | Gauge (observable) | `{batch}` | `exporter`, `data_type` | Emitted when the sending queue is enabled. |
| `otelcol_exporter_send_failed_log_records` | Sum (monotonic) | `{record}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_send_failed_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_send_failed_profile_samples` | Sum (monotonic) | `{sample}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | Profiles are alpha. |
| `otelcol_exporter_send_failed_spans` | Sum (monotonic) | `{span}` | `exporter`, `server.address`, `url.path`, `server.port`; at detailed level also `error.type`, `error.permanent` | - |
| `otelcol_exporter_sent_log_records` | Sum (monotonic) | `{record}` | `exporter`, `server.address`, `url.path`, `server.port` | - |
| `otelcol_exporter_sent_metric_points` | Sum (monotonic) | `{datapoint}` | `exporter`, `server.address`, `url.path`, `server.port` | - |
| `otelcol_exporter_sent_profile_samples` | Sum (monotonic) | `{sample}` | `exporter`, `server.address`, `url.path`, `server.port` | Profiles are alpha. |
| `otelcol_exporter_sent_spans` | Sum (monotonic) | `{span}` | `exporter`, `server.address`, `url.path`, `server.port` | - |

## Sources

- `exporter/otlphttpexporter/factory.go`
- `exporter/otlphttpexporter/metadata.yaml`
- `exporter/exporterhelper/internal/obs_report_sender.go`
- `exporter/exporterhelper/internal/queue/obs_queue.go`
- `exporter/exporterhelper/internal/metadata/generated_telemetry.go`
    • processor
      • batchprocessor
        • v0.153.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: processor/batchprocessor
version: v0.153.0
scope_name: go.opentelemetry.io/collector/processor/batchprocessor
commit_sha: 452cae1662730600abfb76517f5d20bf7d64ed09
last_verified: 2026-08-11
---

# Batch processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_batch_batch_send_size` | Histogram (int) | `{unit}` | `processor` | Recorded after each successfully exported batch; counts telemetry units (spans, metric data points, or log records). |
| `otelcol_processor_batch_batch_send_size_bytes` | Histogram (int) | `By` | `processor` | Recorded after each successfully exported batch; only calculated and emitted when the instrument is enabled (detailed telemetry level). |
| `otelcol_processor_batch_batch_size_trigger_send` | Counter (int) | `{time}` | `processor` | Recorded when a batch is successfully sent because the configured batch size was reached. |
| `otelcol_processor_batch_metadata_cardinality` | Observable UpDownCounter (int) | `{combination}` | `processor` | Asynchronously observes the number of distinct metadata value combinations currently being processed. |
| `otelcol_processor_batch_timeout_trigger_send` | Counter (int) | `{time}` | `processor` | Recorded when a batch is successfully sent because the timeout expired. |

## Sources

- `processor/batchprocessor/metrics.go`
- `processor/batchprocessor/batch_processor.go`
- `processor/batchprocessor/metadata.yaml`
- `processor/batchprocessor/internal/metadata/generated_telemetry.go`
- `processor/batchprocessor/internal/metadata/generated_status.go`
        • v0.154.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: processor/batchprocessor
version: v0.154.0
scope_name: go.opentelemetry.io/collector/processor/batchprocessor
commit_sha: dbed6ad641b872a581f79e7b6f28f315c1592e02
last_verified: 2026-08-11
---

# Batch processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_batch_batch_send_size` | Histogram (int) | `{unit}` | `processor` | Recorded after each successfully exported batch; counts telemetry units (spans, metric data points, or log records). |
| `otelcol_processor_batch_batch_send_size_bytes` | Histogram (int) | `By` | `processor` | Recorded after each successfully exported batch; only calculated and emitted when the instrument is enabled (detailed telemetry level). |
| `otelcol_processor_batch_batch_size_trigger_send` | Counter (int) | `{time}` | `processor` | Recorded when a batch is successfully sent because the configured batch size was reached. |
| `otelcol_processor_batch_metadata_cardinality` | Observable UpDownCounter (int) | `{combination}` | `processor` | Asynchronously observes the number of distinct metadata value combinations currently being processed. |
| `otelcol_processor_batch_timeout_trigger_send` | Counter (int) | `{time}` | `processor` | Recorded when a batch is successfully sent because the timeout expired. |

## Sources

- `processor/batchprocessor/metrics.go`
- `processor/batchprocessor/batch_processor.go`
- `processor/batchprocessor/metadata.yaml`
- `processor/batchprocessor/internal/metadata/generated_telemetry.go`
- `processor/batchprocessor/internal/metadata/generated_status.go`
        • v0.155.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: processor/batchprocessor
version: v0.155.0
scope_name: go.opentelemetry.io/collector/processor/batchprocessor
commit_sha: 41da2fbd7dd58a5dd299587ebb159025b28521d2
last_verified: 2026-08-11
---

# Batch processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_batch_batch_send_size` | Histogram (int) | `{unit}` | `processor` | Recorded after each successfully exported batch; counts telemetry units (spans, metric data points, or log records). |
| `otelcol_processor_batch_batch_send_size_bytes` | Histogram (int) | `By` | `processor` | Recorded after each successfully exported batch; only calculated and emitted when the instrument is enabled (detailed telemetry level). |
| `otelcol_processor_batch_batch_size_trigger_send` | Counter (int) | `{time}` | `processor` | Recorded when a batch is successfully sent because the configured batch size was reached. |
| `otelcol_processor_batch_metadata_cardinality` | Observable UpDownCounter (int) | `{combination}` | `processor` | Asynchronously observes the number of distinct metadata value combinations currently being processed. |
| `otelcol_processor_batch_timeout_trigger_send` | Counter (int) | `{time}` | `processor` | Recorded when a batch is successfully sent because the timeout expired. |

## Sources

- `processor/batchprocessor/metrics.go`
- `processor/batchprocessor/batch_processor.go`
- `processor/batchprocessor/metadata.yaml`
- `processor/batchprocessor/internal/metadata/generated_telemetry.go`
- `processor/batchprocessor/internal/metadata/generated_status.go`
        • v0.156.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: processor/batchprocessor
version: v0.156.0
scope_name: go.opentelemetry.io/collector/processor/batchprocessor
commit_sha: 0a6056f97e2e5fe8f3a52a45bc26d3fb64b731d4
last_verified: 2026-08-11
---

# Batch processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_batch_batch_send_size` | Histogram (int) | `{unit}` | `processor` | Recorded after each successfully exported batch; counts telemetry units (spans, metric data points, or log records). |
| `otelcol_processor_batch_batch_send_size_bytes` | Histogram (int) | `By` | `processor` | Recorded after each successfully exported batch; only calculated and emitted when the instrument is enabled (detailed telemetry level). |
| `otelcol_processor_batch_batch_size_trigger_send` | Counter (int) | `{time}` | `processor` | Recorded when a batch is successfully sent because the configured batch size was reached. |
| `otelcol_processor_batch_metadata_cardinality` | Observable UpDownCounter (int) | `{combination}` | `processor` | Asynchronously observes the number of distinct metadata value combinations currently being processed. |
| `otelcol_processor_batch_timeout_trigger_send` | Counter (int) | `{time}` | `processor` | Recorded when a batch is successfully sent because the timeout expired. |

## Sources

- `processor/batchprocessor/metrics.go`
- `processor/batchprocessor/batch_processor.go`
- `processor/batchprocessor/metadata.yaml`
- `processor/batchprocessor/internal/metadata/generated_telemetry.go`
- `processor/batchprocessor/internal/metadata/generated_status.go`
        • v0.157.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: processor/batchprocessor
version: v0.157.0
scope_name: go.opentelemetry.io/collector/processor/batchprocessor
commit_sha: 4908404e59e544297b989a6961ee918b6f84b606
last_verified: 2026-08-11
---

# Batch processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_batch_batch_send_size` | Histogram (int) | `{unit}` | `processor` | Recorded after each successfully exported batch; counts telemetry units (spans, metric data points, or log records). |
| `otelcol_processor_batch_batch_send_size_bytes` | Histogram (int) | `By` | `processor` | Recorded after each successfully exported batch; only calculated and emitted when the instrument is enabled (detailed telemetry level). |
| `otelcol_processor_batch_batch_size_trigger_send` | Counter (int) | `{time}` | `processor` | Recorded when a batch is successfully sent because the configured batch size was reached. |
| `otelcol_processor_batch_metadata_cardinality` | Observable UpDownCounter (int) | `{combination}` | `processor` | Asynchronously observes the number of distinct metadata value combinations currently being processed. |
| `otelcol_processor_batch_timeout_trigger_send` | Counter (int) | `{time}` | `processor` | Recorded when a batch is successfully sent because the timeout expired. |

## Sources

- `processor/batchprocessor/metrics.go`
- `processor/batchprocessor/batch_processor.go`
- `processor/batchprocessor/metadata.yaml`
- `processor/batchprocessor/internal/metadata/generated_telemetry.go`
- `processor/batchprocessor/internal/metadata/generated_status.go`
        • v0.158.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: processor/batchprocessor
version: v0.158.0
scope_name: go.opentelemetry.io/collector/processor/batchprocessor
commit_sha: 0378e9add75d42e35f621a2df1c9ae819aa10778
last_verified: 2026-08-11
---

# Batch processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_batch_batch_send_size` | Histogram (int) | `{unit}` | `processor` | Recorded after each successfully exported batch; counts telemetry units (spans, metric data points, or log records). |
| `otelcol_processor_batch_batch_send_size_bytes` | Histogram (int) | `By` | `processor` | Recorded after each successfully exported batch; only calculated and emitted when the instrument is enabled (detailed telemetry level). |
| `otelcol_processor_batch_batch_size_trigger_send` | Counter (int) | `{time}` | `processor` | Recorded when a batch is successfully sent because the configured batch size was reached. |
| `otelcol_processor_batch_metadata_cardinality` | Observable UpDownCounter (int) | `{combination}` | `processor` | Asynchronously observes the number of distinct metadata value combinations currently being processed. |
| `otelcol_processor_batch_timeout_trigger_send` | Counter (int) | `{time}` | `processor` | Recorded when a batch is successfully sent because the timeout expired. |

## Sources

- `processor/batchprocessor/metrics.go`
- `processor/batchprocessor/batch_processor.go`
- `processor/batchprocessor/metadata.yaml`
- `processor/batchprocessor/internal/metadata/generated_telemetry.go`
- `processor/batchprocessor/internal/metadata/generated_status.go`
        • v0.159.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: processor/batchprocessor
version: v0.159.0
scope_name: go.opentelemetry.io/collector/processor/batchprocessor
commit_sha: 69c0873044e80fe1f0647a0bc5afec6244bcad76
last_verified: 2026-08-24
---

# Batch processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_batch_batch_send_size` | Histogram (int) | `{unit}` | `processor` | Recorded after each successfully exported batch; counts telemetry units (spans, metric data points, or log records). |
| `otelcol_processor_batch_batch_send_size_bytes` | Histogram (int) | `By` | `processor` | Recorded after each successfully exported batch; only calculated and emitted when the instrument is enabled (detailed telemetry level). |
| `otelcol_processor_batch_batch_size_trigger_send` | Counter (int) | `{time}` | `processor` | Recorded when a batch is successfully sent because the configured batch size was reached. |
| `otelcol_processor_batch_metadata_cardinality` | Observable UpDownCounter (int) | `{combination}` | `processor` | Asynchronously observes the number of distinct metadata value combinations currently being processed. |
| `otelcol_processor_batch_timeout_trigger_send` | Counter (int) | `{time}` | `processor` | Recorded when a batch is successfully sent because the timeout expired. |

## Sources

- `processor/batchprocessor/metrics.go`
- `processor/batchprocessor/batch_processor.go`
- `processor/batchprocessor/metadata.yaml`
- `processor/batchprocessor/internal/metadata/generated_telemetry.go`
- `processor/batchprocessor/internal/metadata/generated_status.go`
        • v0.160.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: processor/batchprocessor
version: v0.160.0
scope_name: go.opentelemetry.io/collector/processor/batchprocessor
commit_sha: cd3455cf3a7f672208140b1ebb1581c542b2b0ed
last_verified: 2026-09-03
---

# Batch processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_batch_batch_send_size` | Histogram (int) | `{unit}` | `processor` | Recorded after each successfully exported batch; counts telemetry units (spans, metric data points, or log records). |
| `otelcol_processor_batch_batch_send_size_bytes` | Histogram (int) | `By` | `processor` | Recorded after each successfully exported batch; only calculated and emitted when the instrument is enabled (detailed telemetry level). |
| `otelcol_processor_batch_batch_size_trigger_send` | Counter (int) | `{time}` | `processor` | Recorded when a batch is successfully sent because the configured batch size was reached. |
| `otelcol_processor_batch_metadata_cardinality` | Observable UpDownCounter (int) | `{combination}` | `processor` | Asynchronously observes the number of distinct metadata value combinations currently being processed. |
| `otelcol_processor_batch_timeout_trigger_send` | Counter (int) | `{time}` | `processor` | Recorded when a batch is successfully sent because the timeout expired. |

## Sources

- `processor/batchprocessor/metrics.go`
- `processor/batchprocessor/batch_processor.go`
- `processor/batchprocessor/metadata.yaml`
- `processor/batchprocessor/internal/metadata/generated_telemetry.go`
- `processor/batchprocessor/internal/metadata/generated_status.go`
        • v0.161.0.md 1.7 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: processor/batchprocessor
version: v0.161.0
scope_name: go.opentelemetry.io/collector/processor/batchprocessor
commit_sha: 0bf928af5487d3c4e0b4174eabb7ba075c322517
last_verified: 2026-10-03
---

# Batch processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_batch_batch_send_size` | Histogram (int) | `{unit}` | `processor` | Recorded after each successfully exported batch; counts telemetry units (spans, metric data points, or log records). |
| `otelcol_processor_batch_batch_send_size_bytes` | Histogram (int) | `By` | `processor` | Recorded after each successfully exported batch; only calculated and emitted when the instrument is enabled (detailed telemetry level). |
| `otelcol_processor_batch_batch_size_trigger_send` | Counter (int) | `{time}` | `processor` | Recorded when a batch is successfully sent because the configured batch size was reached. |
| `otelcol_processor_batch_metadata_cardinality` | Observable UpDownCounter (int) | `{combination}` | `processor` | Asynchronously observes the number of distinct metadata value combinations currently being processed. |
| `otelcol_processor_batch_timeout_trigger_send` | Counter (int) | `{time}` | `processor` | Recorded when a batch is successfully sent because the timeout expired, or when a pending batch is flushed during shutdown. |

## Sources

- `processor/batchprocessor/metrics.go`
- `processor/batchprocessor/batch_processor.go`
- `processor/batchprocessor/metadata.yaml`
- `processor/batchprocessor/internal/metadata/generated_telemetry.go`
- `processor/batchprocessor/internal/metadata/generated_status.go`
        • v0.162.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: processor/batchprocessor
version: v0.162.0
scope_name: go.opentelemetry.io/collector/processor/batchprocessor
commit_sha: 62cdad2ea133239380b44d20d84eb26e114779b6
last_verified: 2026-10-03
---

# Batch processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_batch_batch_send_size` | Histogram (int) | `{unit}` | `processor` | Recorded after each successfully exported batch; counts telemetry units (spans, metric data points, or log records). |
| `otelcol_processor_batch_batch_send_size_bytes` | Histogram (int) | `By` | `processor` | Recorded after each successfully exported batch; only calculated and emitted when the instrument is enabled (detailed telemetry level). |
| `otelcol_processor_batch_batch_size_trigger_send` | Counter (int) | `{time}` | `processor` | Recorded when a batch is successfully sent because the configured batch size was reached. |
| `otelcol_processor_batch_metadata_cardinality` | Observable UpDownCounter (int) | `{combination}` | `processor` | Asynchronously observes the number of distinct metadata value combinations currently being processed. |
| `otelcol_processor_batch_timeout_trigger_send` | Counter (int) | `{time}` | `processor` | Recorded when a batch is successfully sent because the timeout expired. |

## Sources

- `processor/batchprocessor/metrics.go`
- `processor/batchprocessor/batch_processor.go`
- `processor/batchprocessor/metadata.yaml`
- `processor/batchprocessor/internal/metadata/generated_telemetry.go`
- `processor/batchprocessor/internal/metadata/generated_status.go`
        • v0.163.0.md 1.1 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: processor/batchprocessor
version: v0.163.0
scope_name: go.opentelemetry.io/collector/processor/batchprocessor
commit_sha: 5177a6a85ca3783068077e25aec6cebbe1d50d1f
last_verified: 2026-10-14
---

# batchprocessor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| otelcol_processor_batch_batch_send_size | Histogram | {unit} | processor | - |
| otelcol_processor_batch_batch_send_size_bytes | Histogram | By | processor | Only available at detailed telemetry level |
| otelcol_processor_batch_batch_size_trigger_send | Counter | {time} | processor | - |
| otelcol_processor_batch_metadata_cardinality | ObservableUpDownCounter | {combination} | processor | Emitted for batches with metadata enabled |
| otelcol_processor_batch_timeout_trigger_send | Counter | {time} | processor | - |

## Sources

- `processor/batchprocessor/metadata.yaml`
- `processor/batchprocessor/metrics.go`
- `processor/batchprocessor/batch_processor.go`
- `processor/batchprocessor/internal/metadata/generated_telemetry.go`
      • memorylimiterprocessor
        • v0.153.0.md 1.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: processor/memorylimiterprocessor
version: v0.153.0
scope_name: go.opentelemetry.io/collector/processor/memorylimiterprocessor
commit_sha: 452cae1662730600abfb76517f5d20bf7d64ed09
last_verified: 2026-08-06
---

# Memory Limiter Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_accepted_log_records` | Counter | `{record}` | `processor` | Deprecated metric name. |
| `otelcol_processor_accepted_metric_points` | Counter | `{datapoint}` | `processor` | Deprecated metric name. |
| `otelcol_processor_accepted_spans` | Counter | `{span}` | `processor` | Deprecated metric name. |
| `otelcol_processor_refused_log_records` | Counter | `{record}` | `processor` | Deprecated metric name. |
| `otelcol_processor_refused_metric_points` | Counter | `{datapoint}` | `processor` | Deprecated metric name. |
| `otelcol_processor_refused_spans` | Counter | `{span}` | `processor` | Deprecated metric name. |

## Sources

- `processor/memorylimiterprocessor/metadata.yaml`
- `processor/memorylimiterprocessor/obsreport.go`
- `processor/memorylimiterprocessor/memorylimiter.go`
- `processor/memorylimiterprocessor/internal/metadata/generated_telemetry.go`
        • v0.154.0.md 1.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: processor/memorylimiterprocessor
version: v0.154.0
scope_name: go.opentelemetry.io/collector/processor/memorylimiterprocessor
commit_sha: dbed6ad641b872a581f79e7b6f28f315c1592e02
last_verified: 2026-08-06
---

# Memory Limiter Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_accepted_log_records` | Counter | `{record}` | `processor` | Deprecated metric name. |
| `otelcol_processor_accepted_metric_points` | Counter | `{datapoint}` | `processor` | Deprecated metric name. |
| `otelcol_processor_accepted_spans` | Counter | `{span}` | `processor` | Deprecated metric name. |
| `otelcol_processor_refused_log_records` | Counter | `{record}` | `processor` | Deprecated metric name. |
| `otelcol_processor_refused_metric_points` | Counter | `{datapoint}` | `processor` | Deprecated metric name. |
| `otelcol_processor_refused_spans` | Counter | `{span}` | `processor` | Deprecated metric name. |

## Sources

- `processor/memorylimiterprocessor/metadata.yaml`
- `processor/memorylimiterprocessor/obsreport.go`
- `processor/memorylimiterprocessor/memorylimiter.go`
- `processor/memorylimiterprocessor/internal/metadata/generated_telemetry.go`
        • v0.155.0.md 1.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: processor/memorylimiterprocessor
version: v0.155.0
scope_name: go.opentelemetry.io/collector/processor/memorylimiterprocessor
commit_sha: 41da2fbd7dd58a5dd299587ebb159025b28521d2
last_verified: 2026-08-06
---

# Memory Limiter Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_memory_limiter_accepted_log_records` | Counter | `{record}` | `processor` | - |
| `otelcol_processor_memory_limiter_accepted_metric_points` | Counter | `{datapoint}` | `processor` | - |
| `otelcol_processor_memory_limiter_accepted_spans` | Counter | `{span}` | `processor` | - |
| `otelcol_processor_memory_limiter_refused_log_records` | Counter | `{record}` | `processor` | - |
| `otelcol_processor_memory_limiter_refused_metric_points` | Counter | `{datapoint}` | `processor` | - |
| `otelcol_processor_memory_limiter_refused_spans` | Counter | `{span}` | `processor` | - |

## Sources

- `processor/memorylimiterprocessor/metadata.yaml`
- `processor/memorylimiterprocessor/obsreport.go`
- `processor/memorylimiterprocessor/memorylimiter.go`
- `processor/memorylimiterprocessor/internal/metadata/generated_telemetry.go`
        • v0.156.0.md 1.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: processor/memorylimiterprocessor
version: v0.156.0
scope_name: go.opentelemetry.io/collector/processor/memorylimiterprocessor
commit_sha: 0a6056f97e2e5fe8f3a52a45bc26d3fb64b731d4
last_verified: 2026-08-06
---

# Memory Limiter Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_memory_limiter_accepted_log_records` | Counter | `{record}` | `processor` | - |
| `otelcol_processor_memory_limiter_accepted_metric_points` | Counter | `{datapoint}` | `processor` | - |
| `otelcol_processor_memory_limiter_accepted_spans` | Counter | `{span}` | `processor` | - |
| `otelcol_processor_memory_limiter_refused_log_records` | Counter | `{record}` | `processor` | - |
| `otelcol_processor_memory_limiter_refused_metric_points` | Counter | `{datapoint}` | `processor` | - |
| `otelcol_processor_memory_limiter_refused_spans` | Counter | `{span}` | `processor` | - |

## Sources

- `processor/memorylimiterprocessor/metadata.yaml`
- `processor/memorylimiterprocessor/obsreport.go`
- `processor/memorylimiterprocessor/memorylimiter.go`
- `processor/memorylimiterprocessor/internal/metadata/generated_telemetry.go`
        • v0.157.0.md 1.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: processor/memorylimiterprocessor
version: v0.157.0
scope_name: go.opentelemetry.io/collector/processor/memorylimiterprocessor
commit_sha: 4908404e59e544297b989a6961ee918b6f84b606
last_verified: 2026-08-06
---

# Memory Limiter Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_memory_limiter_accepted_log_records` | Counter | `{record}` | `processor` | - |
| `otelcol_processor_memory_limiter_accepted_metric_points` | Counter | `{datapoint}` | `processor` | - |
| `otelcol_processor_memory_limiter_accepted_spans` | Counter | `{span}` | `processor` | - |
| `otelcol_processor_memory_limiter_refused_log_records` | Counter | `{record}` | `processor` | - |
| `otelcol_processor_memory_limiter_refused_metric_points` | Counter | `{datapoint}` | `processor` | - |
| `otelcol_processor_memory_limiter_refused_spans` | Counter | `{span}` | `processor` | - |

## Sources

- `processor/memorylimiterprocessor/metadata.yaml`
- `processor/memorylimiterprocessor/obsreport.go`
- `processor/memorylimiterprocessor/memorylimiter.go`
- `processor/memorylimiterprocessor/internal/metadata/generated_telemetry.go`
        • v0.158.0.md 1.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: processor/memorylimiterprocessor
version: v0.158.0
scope_name: go.opentelemetry.io/collector/processor/memorylimiterprocessor
commit_sha: 0378e9add75d42e35f621a2df1c9ae819aa10778
last_verified: 2026-08-06
---

# Memory Limiter Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_memory_limiter_accepted_log_records` | Counter | `{record}` | `processor` | - |
| `otelcol_processor_memory_limiter_accepted_metric_points` | Counter | `{datapoint}` | `processor` | - |
| `otelcol_processor_memory_limiter_accepted_spans` | Counter | `{span}` | `processor` | - |
| `otelcol_processor_memory_limiter_refused_log_records` | Counter | `{record}` | `processor` | - |
| `otelcol_processor_memory_limiter_refused_metric_points` | Counter | `{datapoint}` | `processor` | - |
| `otelcol_processor_memory_limiter_refused_spans` | Counter | `{span}` | `processor` | - |

## Sources

- `processor/memorylimiterprocessor/metadata.yaml`
- `processor/memorylimiterprocessor/obsreport.go`
- `processor/memorylimiterprocessor/memorylimiter.go`
- `processor/memorylimiterprocessor/internal/metadata/generated_telemetry.go`
        • v0.159.0.md 1.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: processor/memorylimiterprocessor
version: v0.159.0
scope_name: go.opentelemetry.io/collector/processor/memorylimiterprocessor
commit_sha: 69c0873044e80fe1f0647a0bc5afec6244bcad76
last_verified: 2026-08-24
---

# Memory Limiter Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_memory_limiter_accepted_log_records` | Counter | `{record}` | `processor` | - |
| `otelcol_processor_memory_limiter_accepted_metric_points` | Counter | `{datapoint}` | `processor` | - |
| `otelcol_processor_memory_limiter_accepted_spans` | Counter | `{span}` | `processor` | - |
| `otelcol_processor_memory_limiter_refused_log_records` | Counter | `{record}` | `processor` | - |
| `otelcol_processor_memory_limiter_refused_metric_points` | Counter | `{datapoint}` | `processor` | - |
| `otelcol_processor_memory_limiter_refused_spans` | Counter | `{span}` | `processor` | - |

## Sources

- `processor/memorylimiterprocessor/metadata.yaml`
- `processor/memorylimiterprocessor/obsreport.go`
- `processor/memorylimiterprocessor/memorylimiter.go`
- `processor/memorylimiterprocessor/internal/metadata/generated_telemetry.go`
        • v0.160.0.md 1.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: processor/memorylimiterprocessor
version: v0.160.0
scope_name: go.opentelemetry.io/collector/processor/memorylimiterprocessor
commit_sha: cd3455cf3a7f672208140b1ebb1581c542b2b0ed
last_verified: 2026-09-03
---

# Memory Limiter Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_memory_limiter_accepted_log_records` | Counter | `{record}` | `processor` | - |
| `otelcol_processor_memory_limiter_accepted_metric_points` | Counter | `{datapoint}` | `processor` | - |
| `otelcol_processor_memory_limiter_accepted_spans` | Counter | `{span}` | `processor` | - |
| `otelcol_processor_memory_limiter_refused_log_records` | Counter | `{record}` | `processor` | - |
| `otelcol_processor_memory_limiter_refused_metric_points` | Counter | `{datapoint}` | `processor` | - |
| `otelcol_processor_memory_limiter_refused_spans` | Counter | `{span}` | `processor` | - |

## Sources

- `processor/memorylimiterprocessor/metadata.yaml`
- `processor/memorylimiterprocessor/obsreport.go`
- `processor/memorylimiterprocessor/memorylimiter.go`
- `processor/memorylimiterprocessor/internal/metadata/generated_telemetry.go`
        • v0.161.0.md 1.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: processor/memorylimiterprocessor
version: v0.161.0
scope_name: go.opentelemetry.io/collector/processor/memorylimiterprocessor
commit_sha: 0bf928af5487d3c4e0b4174eabb7ba075c322517
last_verified: 2026-10-03
---

# Memory Limiter Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_memory_limiter_accepted_log_records` | Counter | `{record}` | `processor` | - |
| `otelcol_processor_memory_limiter_accepted_metric_points` | Counter | `{datapoint}` | `processor` | - |
| `otelcol_processor_memory_limiter_accepted_spans` | Counter | `{span}` | `processor` | - |
| `otelcol_processor_memory_limiter_refused_log_records` | Counter | `{record}` | `processor` | - |
| `otelcol_processor_memory_limiter_refused_metric_points` | Counter | `{datapoint}` | `processor` | - |
| `otelcol_processor_memory_limiter_refused_spans` | Counter | `{span}` | `processor` | - |

## Sources

- `processor/memorylimiterprocessor/metadata.yaml`
- `processor/memorylimiterprocessor/obsreport.go`
- `processor/memorylimiterprocessor/memorylimiter.go`
- `processor/memorylimiterprocessor/internal/metadata/generated_telemetry.go`
        • v0.162.0.md 1.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: processor/memorylimiterprocessor
version: v0.162.0
scope_name: go.opentelemetry.io/collector/processor/memorylimiterprocessor
commit_sha: 62cdad2ea133239380b44d20d84eb26e114779b6
last_verified: 2026-10-03
---

# Memory Limiter Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_memory_limiter_accepted_log_records` | Counter | `{record}` | `processor` | - |
| `otelcol_processor_memory_limiter_accepted_metric_points` | Counter | `{datapoint}` | `processor` | - |
| `otelcol_processor_memory_limiter_accepted_spans` | Counter | `{span}` | `processor` | - |
| `otelcol_processor_memory_limiter_refused_log_records` | Counter | `{record}` | `processor` | - |
| `otelcol_processor_memory_limiter_refused_metric_points` | Counter | `{datapoint}` | `processor` | - |
| `otelcol_processor_memory_limiter_refused_spans` | Counter | `{span}` | `processor` | - |

## Sources

- `processor/memorylimiterprocessor/metadata.yaml`
- `processor/memorylimiterprocessor/obsreport.go`
- `processor/memorylimiterprocessor/memorylimiter.go`
- `processor/memorylimiterprocessor/internal/metadata/generated_telemetry.go`
        • v0.163.0.md 1.1 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: processor/memorylimiterprocessor
version: v0.163.0
scope_name: go.opentelemetry.io/collector/processor/memorylimiterprocessor
commit_sha: 5177a6a85ca3783068077e25aec6cebbe1d50d1f
last_verified: null
---

# Memory Limiter Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| otelcol_processor_memory_limiter_accepted_log_records | Counter | {record} | processor | - |
| otelcol_processor_memory_limiter_accepted_metric_points | Counter | {datapoint} | processor | - |
| otelcol_processor_memory_limiter_accepted_spans | Counter | {span} | processor | - |
| otelcol_processor_memory_limiter_refused_log_records | Counter | {record} | processor | - |
| otelcol_processor_memory_limiter_refused_metric_points | Counter | {datapoint} | processor | - |
| otelcol_processor_memory_limiter_refused_spans | Counter | {span} | processor | - |

## Sources

- processor/memorylimiterprocessor/metadata.yaml
- processor/memorylimiterprocessor/internal/metadata/generated_telemetry.go
- processor/memorylimiterprocessor/obsreport.go
    • receiver
      • otlpreceiver
        • v0.153.0.md 5 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: receiver/otlpreceiver
version: v0.153.0
scope_name: go.opentelemetry.io/collector/receiver/receiverhelper
commit_sha: 452cae1662730600abfb76517f5d20bf7d64ed09
last_verified: 2026-10-14
---

# OTLP Receiver

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `receiver/otlp/TraceDataReceived` | Internal | `transport`; `format`; `accepted_spans`; `refused_spans`; `failed_spans` | `transport` is the configured transport; `format` is `protobuf`; count attributes record the outcome. `refused_spans` and `failed_spans` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/MetricsReceived` | Internal | `transport`; `format`; `accepted_metric_points`; `refused_metric_points`; `failed_metric_points` | `format` is `protobuf`; count attributes record the outcome. `refused_metric_points` and `failed_metric_points` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/LogsReceived` | Internal | `transport`; `format`; `accepted_log_records`; `refused_log_records`; `failed_log_records` | `format` is `protobuf`; count attributes record the outcome. `refused_log_records` and `failed_log_records` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/ProfilesReceived` | Internal | `transport`; `format`; `accepted_profile_samples`; `refused_profile_samples`; `failed_profile_samples` | Profiles are alpha stability. `format` is `protobuf`; count attributes record the outcome. The refused/failed semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_receiver_accepted_spans` | Counter | `{span}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_spans` | Counter | `{span}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_spans` | Counter | `{span}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_log_records` | Counter | `{record}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_log_records` | Counter | `{record}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_log_records` | Counter | `{record}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. |
| `otelcol_receiver_refused_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_requests` | Counter | `{request}` | `receiver`, `transport`, `outcome` (`success`, `refused`, or `failure`) | Emitted only when feature gate `receiverhelper.newReceiverMetrics` is enabled. |

## Sources

- `receiver/otlpreceiver/internal/trace/otlp.go`
- `receiver/otlpreceiver/internal/metrics/otlp.go`
- `receiver/otlpreceiver/internal/logs/otlp.go`
- `receiver/otlpreceiver/internal/profiles/otlp.go`
- `receiver/otlpreceiver/internal/metadata/generated_status.go`
- `receiver/receiverhelper/obsreport.go`
- `receiver/receiverhelper/internal/metadata/generated_telemetry.go`
- `receiver/receiverhelper/internal/obsmetrics.go`
- `receiver/receiverhelper/internal/metadata/generated_feature_gates.go`
        • v0.154.0.md 5 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: receiver/otlpreceiver
version: v0.154.0
scope_name: go.opentelemetry.io/collector/receiver/receiverhelper
commit_sha: dbed6ad641b872a581f79e7b6f28f315c1592e02
last_verified: 2026-10-14
---

# OTLP Receiver

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `receiver/otlp/TraceDataReceived` | Internal | `transport`; `format`; `accepted_spans`; `refused_spans`; `failed_spans` | `transport` is the configured transport; `format` is `protobuf`; count attributes record the outcome. `refused_spans` and `failed_spans` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/MetricsReceived` | Internal | `transport`; `format`; `accepted_metric_points`; `refused_metric_points`; `failed_metric_points` | `format` is `protobuf`; count attributes record the outcome. `refused_metric_points` and `failed_metric_points` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/LogsReceived` | Internal | `transport`; `format`; `accepted_log_records`; `refused_log_records`; `failed_log_records` | `format` is `protobuf`; count attributes record the outcome. `refused_log_records` and `failed_log_records` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/ProfilesReceived` | Internal | `transport`; `format`; `accepted_profile_samples`; `refused_profile_samples`; `failed_profile_samples` | Profiles are alpha stability. `format` is `protobuf`; count attributes record the outcome. The refused/failed semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_receiver_accepted_spans` | Counter | `{span}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_spans` | Counter | `{span}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_spans` | Counter | `{span}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_log_records` | Counter | `{record}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_log_records` | Counter | `{record}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_log_records` | Counter | `{record}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. |
| `otelcol_receiver_refused_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_requests` | Counter | `{request}` | `receiver`, `transport`, `outcome` (`success`, `refused`, or `failure`) | Emitted only when feature gate `receiverhelper.newReceiverMetrics` is enabled. |

## Sources

- `receiver/otlpreceiver/internal/trace/otlp.go`
- `receiver/otlpreceiver/internal/metrics/otlp.go`
- `receiver/otlpreceiver/internal/logs/otlp.go`
- `receiver/otlpreceiver/internal/profiles/otlp.go`
- `receiver/otlpreceiver/internal/metadata/generated_status.go`
- `receiver/receiverhelper/obsreport.go`
- `receiver/receiverhelper/internal/metadata/generated_telemetry.go`
- `receiver/receiverhelper/internal/obsmetrics.go`
- `receiver/receiverhelper/internal/metadata/generated_feature_gates.go`
        • v0.155.0.md 5 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: receiver/otlpreceiver
version: v0.155.0
scope_name: go.opentelemetry.io/collector/receiver/receiverhelper
commit_sha: 41da2fbd7dd58a5dd299587ebb159025b28521d2
last_verified: 2026-10-14
---

# OTLP Receiver

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `receiver/otlp/TraceDataReceived` | Internal | `transport`; `format`; `accepted_spans`; `refused_spans`; `failed_spans` | `transport` is the configured transport; `format` is `protobuf`; count attributes record the outcome. `refused_spans` and `failed_spans` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/MetricsReceived` | Internal | `transport`; `format`; `accepted_metric_points`; `refused_metric_points`; `failed_metric_points` | `format` is `protobuf`; count attributes record the outcome. `refused_metric_points` and `failed_metric_points` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/LogsReceived` | Internal | `transport`; `format`; `accepted_log_records`; `refused_log_records`; `failed_log_records` | `format` is `protobuf`; count attributes record the outcome. `refused_log_records` and `failed_log_records` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/ProfilesReceived` | Internal | `transport`; `format`; `accepted_profile_samples`; `refused_profile_samples`; `failed_profile_samples` | Profiles are alpha stability. `format` is `protobuf`; count attributes record the outcome. The refused/failed semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_receiver_accepted_spans` | Counter | `{span}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_spans` | Counter | `{span}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_spans` | Counter | `{span}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_log_records` | Counter | `{record}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_log_records` | Counter | `{record}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_log_records` | Counter | `{record}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. |
| `otelcol_receiver_refused_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_requests` | Counter | `{request}` | `receiver`, `transport`, `outcome` (`success`, `refused`, or `failure`) | Emitted only when feature gate `receiverhelper.newReceiverMetrics` is enabled. |

## Sources

- `receiver/otlpreceiver/internal/trace/otlp.go`
- `receiver/otlpreceiver/internal/metrics/otlp.go`
- `receiver/otlpreceiver/internal/logs/otlp.go`
- `receiver/otlpreceiver/internal/profiles/otlp.go`
- `receiver/otlpreceiver/internal/metadata/generated_status.go`
- `receiver/receiverhelper/obsreport.go`
- `receiver/receiverhelper/internal/metadata/generated_telemetry.go`
- `receiver/receiverhelper/internal/obsmetrics.go`
- `receiver/receiverhelper/internal/metadata/generated_feature_gates.go`
        • v0.156.0.md 5 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: receiver/otlpreceiver
version: v0.156.0
scope_name: go.opentelemetry.io/collector/receiver/receiverhelper
commit_sha: 0a6056f97e2e5fe8f3a52a45bc26d3fb64b731d4
last_verified: 2026-10-14
---

# OTLP Receiver

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `receiver/otlp/TraceDataReceived` | Internal | `transport`; `format`; `accepted_spans`; `refused_spans`; `failed_spans` | `transport` is the configured transport; `format` is `protobuf`; count attributes record the outcome. `refused_spans` and `failed_spans` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/MetricsReceived` | Internal | `transport`; `format`; `accepted_metric_points`; `refused_metric_points`; `failed_metric_points` | `format` is `protobuf`; count attributes record the outcome. `refused_metric_points` and `failed_metric_points` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/LogsReceived` | Internal | `transport`; `format`; `accepted_log_records`; `refused_log_records`; `failed_log_records` | `format` is `protobuf`; count attributes record the outcome. `refused_log_records` and `failed_log_records` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/ProfilesReceived` | Internal | `transport`; `format`; `accepted_profile_samples`; `refused_profile_samples`; `failed_profile_samples` | Profiles are alpha stability. `format` is `protobuf`; count attributes record the outcome. The refused/failed semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_receiver_accepted_spans` | Counter | `{span}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_spans` | Counter | `{span}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_spans` | Counter | `{span}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_log_records` | Counter | `{record}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_log_records` | Counter | `{record}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_log_records` | Counter | `{record}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. |
| `otelcol_receiver_refused_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_requests` | Counter | `{request}` | `receiver`, `transport`, `outcome` (`success`, `refused`, or `failure`) | Emitted only when feature gate `receiverhelper.newReceiverMetrics` is enabled. |

## Sources

- `receiver/otlpreceiver/internal/trace/otlp.go`
- `receiver/otlpreceiver/internal/metrics/otlp.go`
- `receiver/otlpreceiver/internal/logs/otlp.go`
- `receiver/otlpreceiver/internal/profiles/otlp.go`
- `receiver/otlpreceiver/internal/metadata/generated_status.go`
- `receiver/receiverhelper/obsreport.go`
- `receiver/receiverhelper/internal/metadata/generated_telemetry.go`
- `receiver/receiverhelper/internal/obsmetrics.go`
- `receiver/receiverhelper/internal/metadata/generated_feature_gates.go`
        • v0.157.0.md 5 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: receiver/otlpreceiver
version: v0.157.0
scope_name: go.opentelemetry.io/collector/receiver/receiverhelper
commit_sha: 4908404e59e544297b989a6961ee918b6f84b606
last_verified: 2026-10-14
---

# OTLP Receiver

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `receiver/otlp/TraceDataReceived` | Internal | `transport`; `format`; `accepted_spans`; `refused_spans`; `failed_spans` | `transport` is the configured transport; `format` is `protobuf`; count attributes record the outcome. `refused_spans` and `failed_spans` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/MetricsReceived` | Internal | `transport`; `format`; `accepted_metric_points`; `refused_metric_points`; `failed_metric_points` | `format` is `protobuf`; count attributes record the outcome. `refused_metric_points` and `failed_metric_points` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/LogsReceived` | Internal | `transport`; `format`; `accepted_log_records`; `refused_log_records`; `failed_log_records` | `format` is `protobuf`; count attributes record the outcome. `refused_log_records` and `failed_log_records` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/ProfilesReceived` | Internal | `transport`; `format`; `accepted_profile_samples`; `refused_profile_samples`; `failed_profile_samples` | Profiles are alpha stability. `format` is `protobuf`; count attributes record the outcome. The refused/failed semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_receiver_accepted_spans` | Counter | `{span}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_spans` | Counter | `{span}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_spans` | Counter | `{span}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_log_records` | Counter | `{record}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_log_records` | Counter | `{record}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_log_records` | Counter | `{record}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. |
| `otelcol_receiver_refused_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_requests` | Counter | `{request}` | `receiver`, `transport`, `outcome` (`success`, `refused`, or `failure`) | Emitted only when feature gate `receiverhelper.newReceiverMetrics` is enabled. |

## Sources

- `receiver/otlpreceiver/internal/trace/otlp.go`
- `receiver/otlpreceiver/internal/metrics/otlp.go`
- `receiver/otlpreceiver/internal/logs/otlp.go`
- `receiver/otlpreceiver/internal/profiles/otlp.go`
- `receiver/otlpreceiver/internal/metadata/generated_status.go`
- `receiver/receiverhelper/obsreport.go`
- `receiver/receiverhelper/internal/metadata/generated_telemetry.go`
- `receiver/receiverhelper/internal/obsmetrics.go`
- `receiver/receiverhelper/internal/metadata/generated_feature_gates.go`
        • v0.158.0.md 5 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: receiver/otlpreceiver
version: v0.158.0
scope_name: go.opentelemetry.io/collector/receiver/receiverhelper
commit_sha: 0378e9add75d42e35f621a2df1c9ae819aa10778
last_verified: 2026-10-14
---

# OTLP Receiver

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `receiver/otlp/TraceDataReceived` | Internal | `transport`; `format`; `accepted_spans`; `refused_spans`; `failed_spans` | `transport` is the configured transport; `format` is `protobuf`; count attributes record the outcome. `refused_spans` and `failed_spans` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/MetricsReceived` | Internal | `transport`; `format`; `accepted_metric_points`; `refused_metric_points`; `failed_metric_points` | `format` is `protobuf`; count attributes record the outcome. `refused_metric_points` and `failed_metric_points` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/LogsReceived` | Internal | `transport`; `format`; `accepted_log_records`; `refused_log_records`; `failed_log_records` | `format` is `protobuf`; count attributes record the outcome. `refused_log_records` and `failed_log_records` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/ProfilesReceived` | Internal | `transport`; `format`; `accepted_profile_samples`; `refused_profile_samples`; `failed_profile_samples` | Profiles are alpha stability. `format` is `protobuf`; count attributes record the outcome. The refused/failed semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_receiver_accepted_spans` | Counter | `{span}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_spans` | Counter | `{span}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_spans` | Counter | `{span}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_log_records` | Counter | `{record}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_log_records` | Counter | `{record}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_log_records` | Counter | `{record}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. |
| `otelcol_receiver_refused_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_requests` | Counter | `{request}` | `receiver`, `transport`, `outcome` (`success`, `refused`, or `failure`) | Emitted only when feature gate `receiverhelper.newReceiverMetrics` is enabled. |

## Sources

- `receiver/otlpreceiver/internal/trace/otlp.go`
- `receiver/otlpreceiver/internal/metrics/otlp.go`
- `receiver/otlpreceiver/internal/logs/otlp.go`
- `receiver/otlpreceiver/internal/profiles/otlp.go`
- `receiver/otlpreceiver/internal/metadata/generated_status.go`
- `receiver/receiverhelper/obsreport.go`
- `receiver/receiverhelper/internal/metadata/generated_telemetry.go`
- `receiver/receiverhelper/internal/obsmetrics.go`
- `receiver/receiverhelper/internal/metadata/generated_feature_gates.go`
        • v0.159.0.md 5 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: receiver/otlpreceiver
version: v0.159.0
scope_name: go.opentelemetry.io/collector/receiver/receiverhelper
commit_sha: 69c0873044e80fe1f0647a0bc5afec6244bcad76
last_verified: 2026-10-14
---

# OTLP Receiver

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `receiver/otlp/TraceDataReceived` | Internal | `transport`; `format`; `accepted_spans`; `refused_spans`; `failed_spans` | `transport` is the configured transport; `format` is `protobuf`; count attributes record the outcome. `refused_spans` and `failed_spans` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/MetricsReceived` | Internal | `transport`; `format`; `accepted_metric_points`; `refused_metric_points`; `failed_metric_points` | `format` is `protobuf`; count attributes record the outcome. `refused_metric_points` and `failed_metric_points` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/LogsReceived` | Internal | `transport`; `format`; `accepted_log_records`; `refused_log_records`; `failed_log_records` | `format` is `protobuf`; count attributes record the outcome. `refused_log_records` and `failed_log_records` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/ProfilesReceived` | Internal | `transport`; `format`; `accepted_profile_samples`; `refused_profile_samples`; `failed_profile_samples` | Profiles are alpha stability. `format` is `protobuf`; count attributes record the outcome. The refused/failed semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_receiver_accepted_spans` | Counter | `{span}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_spans` | Counter | `{span}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_spans` | Counter | `{span}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_log_records` | Counter | `{record}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_log_records` | Counter | `{record}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_log_records` | Counter | `{record}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. |
| `otelcol_receiver_refused_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_requests` | Counter | `{request}` | `receiver`, `transport`, `outcome` (`success`, `refused`, or `failure`) | Emitted only when feature gate `receiverhelper.newReceiverMetrics` is enabled. |

## Sources

- `receiver/otlpreceiver/internal/trace/otlp.go`
- `receiver/otlpreceiver/internal/metrics/otlp.go`
- `receiver/otlpreceiver/internal/logs/otlp.go`
- `receiver/otlpreceiver/internal/profiles/otlp.go`
- `receiver/otlpreceiver/internal/metadata/generated_status.go`
- `receiver/receiverhelper/obsreport.go`
- `receiver/receiverhelper/internal/metadata/generated_telemetry.go`
- `receiver/receiverhelper/internal/obsmetrics.go`
- `receiver/receiverhelper/internal/metadata/generated_feature_gates.go`
        • v0.160.0.md 5 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: receiver/otlpreceiver
version: v0.160.0
scope_name: go.opentelemetry.io/collector/receiver/receiverhelper
commit_sha: cd3455cf3a7f672208140b1ebb1581c542b2b0ed
last_verified: 2026-10-14
---

# OTLP Receiver

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `receiver/otlp/TraceDataReceived` | Internal | `transport`; `format`; `accepted_spans`; `refused_spans`; `failed_spans` | `transport` is the configured transport; `format` is `protobuf`; count attributes record the outcome. `refused_spans` and `failed_spans` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/MetricsReceived` | Internal | `transport`; `format`; `accepted_metric_points`; `refused_metric_points`; `failed_metric_points` | `format` is `protobuf`; count attributes record the outcome. `refused_metric_points` and `failed_metric_points` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/LogsReceived` | Internal | `transport`; `format`; `accepted_log_records`; `refused_log_records`; `failed_log_records` | `format` is `protobuf`; count attributes record the outcome. `refused_log_records` and `failed_log_records` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/ProfilesReceived` | Internal | `transport`; `format`; `accepted_profile_samples`; `refused_profile_samples`; `failed_profile_samples` | Profiles are alpha stability. `format` is `protobuf`; count attributes record the outcome. The refused/failed semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_receiver_accepted_spans` | Counter | `{span}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_spans` | Counter | `{span}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_spans` | Counter | `{span}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_log_records` | Counter | `{record}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_log_records` | Counter | `{record}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_log_records` | Counter | `{record}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. |
| `otelcol_receiver_refused_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_requests` | Counter | `{request}` | `receiver`, `transport`, `outcome` (`success`, `refused`, or `failure`) | Emitted only when feature gate `receiverhelper.newReceiverMetrics` is enabled. |

## Sources

- `receiver/otlpreceiver/internal/trace/otlp.go`
- `receiver/otlpreceiver/internal/metrics/otlp.go`
- `receiver/otlpreceiver/internal/logs/otlp.go`
- `receiver/otlpreceiver/internal/profiles/otlp.go`
- `receiver/otlpreceiver/internal/metadata/generated_status.go`
- `receiver/receiverhelper/obsreport.go`
- `receiver/receiverhelper/internal/metadata/generated_telemetry.go`
- `receiver/receiverhelper/internal/obsmetrics.go`
- `receiver/receiverhelper/internal/metadata/generated_feature_gates.go`
        • v0.161.0.md 5 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: receiver/otlpreceiver
version: v0.161.0
scope_name: go.opentelemetry.io/collector/receiver/receiverhelper
commit_sha: 0bf928af5487d3c4e0b4174eabb7ba075c322517
last_verified: 2026-10-14
---

# OTLP Receiver

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `receiver/otlp/TraceDataReceived` | Internal | `transport`; `format`; `accepted_spans`; `refused_spans`; `failed_spans` | `transport` is the configured transport; `format` is `protobuf`; count attributes record the outcome. `refused_spans` and `failed_spans` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/MetricsReceived` | Internal | `transport`; `format`; `accepted_metric_points`; `refused_metric_points`; `failed_metric_points` | `format` is `protobuf`; count attributes record the outcome. `refused_metric_points` and `failed_metric_points` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/LogsReceived` | Internal | `transport`; `format`; `accepted_log_records`; `refused_log_records`; `failed_log_records` | `format` is `protobuf`; count attributes record the outcome. `refused_log_records` and `failed_log_records` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/ProfilesReceived` | Internal | `transport`; `format`; `accepted_profile_samples`; `refused_profile_samples`; `failed_profile_samples` | Profiles are alpha stability. `format` is `protobuf`; count attributes record the outcome. The refused/failed semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_receiver_accepted_spans` | Counter | `{span}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_spans` | Counter | `{span}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_spans` | Counter | `{span}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_log_records` | Counter | `{record}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_log_records` | Counter | `{record}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_log_records` | Counter | `{record}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. |
| `otelcol_receiver_refused_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_requests` | Counter | `{request}` | `receiver`, `transport`, `outcome` (`success`, `refused`, or `failure`) | Emitted only when feature gate `receiverhelper.newReceiverMetrics` is enabled. |

## Sources

- `receiver/otlpreceiver/internal/trace/otlp.go`
- `receiver/otlpreceiver/internal/metrics/otlp.go`
- `receiver/otlpreceiver/internal/logs/otlp.go`
- `receiver/otlpreceiver/internal/profiles/otlp.go`
- `receiver/otlpreceiver/internal/metadata/generated_status.go`
- `receiver/receiverhelper/obsreport.go`
- `receiver/receiverhelper/internal/metadata/generated_telemetry.go`
- `receiver/receiverhelper/internal/obsmetrics.go`
- `receiver/receiverhelper/internal/metadata/generated_feature_gates.go`
        • v0.162.0.md 5.3 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: receiver/otlpreceiver
version: v0.162.0
scope_name: go.opentelemetry.io/collector/receiver/receiverhelper
commit_sha: 62cdad2ea133239380b44d20d84eb26e114779b6
last_verified: 2026-10-14
---

# OTLP Receiver

For all four signals and both transports, a request with zero spans, data points, log records, or profile samples returns before the receiver operation starts: it emits no `*Received` span and no accepted/refused/failed or `otelcol_receiver_requests` measurement.

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `receiver/otlp/TraceDataReceived` | Internal | `transport`; `format`; `accepted_spans`; `refused_spans`; `failed_spans` | `transport` is the configured transport; `format` is `protobuf`; count attributes record the outcome. `refused_spans` and `failed_spans` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/MetricsReceived` | Internal | `transport`; `format`; `accepted_metric_points`; `refused_metric_points`; `failed_metric_points` | `format` is `protobuf`; count attributes record the outcome. `refused_metric_points` and `failed_metric_points` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/LogsReceived` | Internal | `transport`; `format`; `accepted_log_records`; `refused_log_records`; `failed_log_records` | `format` is `protobuf`; count attributes record the outcome. `refused_log_records` and `failed_log_records` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/ProfilesReceived` | Internal | `transport`; `format`; `accepted_profile_samples`; `refused_profile_samples`; `failed_profile_samples` | Profiles are alpha stability. `format` is `protobuf`; count attributes record the outcome. The refused/failed semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_receiver_accepted_spans` | Counter | `{span}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_spans` | Counter | `{span}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_spans` | Counter | `{span}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_log_records` | Counter | `{record}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_log_records` | Counter | `{record}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_log_records` | Counter | `{record}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. |
| `otelcol_receiver_refused_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_requests` | Counter | `{request}` | `receiver`, `transport`, `outcome` (`success`, `refused`, or `failure`) | Emitted only when feature gate `receiverhelper.newReceiverMetrics` is enabled. |

## Sources

- `receiver/otlpreceiver/internal/trace/otlp.go`
- `receiver/otlpreceiver/internal/metrics/otlp.go`
- `receiver/otlpreceiver/internal/logs/otlp.go`
- `receiver/otlpreceiver/internal/profiles/otlp.go`
- `receiver/otlpreceiver/internal/metadata/generated_status.go`
- `receiver/receiverhelper/obsreport.go`
- `receiver/receiverhelper/internal/metadata/generated_telemetry.go`
- `receiver/receiverhelper/internal/obsmetrics.go`
- `receiver/receiverhelper/internal/metadata/generated_feature_gates.go`
        • v0.163.0.md 5.3 KB 
          ---
repo: open-telemetry/opentelemetry-collector
path: receiver/otlpreceiver
version: v0.163.0
scope_name: go.opentelemetry.io/collector/receiver/receiverhelper
commit_sha: 5177a6a85ca3783068077e25aec6cebbe1d50d1f
last_verified: 2026-10-14
---

# OTLP Receiver

For all four signals and both transports, a request with zero spans, data points, log records, or profile samples returns before the receiver operation starts: it emits no `*Received` span and no accepted/refused/failed or `otelcol_receiver_requests` measurement.

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `receiver/otlp/TraceDataReceived` | Internal | `transport`; `format`; `accepted_spans`; `refused_spans`; `failed_spans` | `transport` is the configured transport; `format` is `protobuf`; count attributes record the outcome. `refused_spans` and `failed_spans` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/MetricsReceived` | Internal | `transport`; `format`; `accepted_metric_points`; `refused_metric_points`; `failed_metric_points` | `format` is `protobuf`; count attributes record the outcome. `refused_metric_points` and `failed_metric_points` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/LogsReceived` | Internal | `transport`; `format`; `accepted_log_records`; `refused_log_records`; `failed_log_records` | `format` is `protobuf`; count attributes record the outcome. `refused_log_records` and `failed_log_records` semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |
| `receiver/otlp/ProfilesReceived` | Internal | `transport`; `format`; `accepted_profile_samples`; `refused_profile_samples`; `failed_profile_samples` | Profiles are alpha stability. `format` is `protobuf`; count attributes record the outcome. The refused/failed semantics are controlled by feature gate `receiverhelper.newReceiverMetrics`. Scope is the configured receiver ID (`otlp` by default); the ID also replaces `otlp` in the span name. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_receiver_accepted_spans` | Counter | `{span}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_spans` | Counter | `{span}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_spans` | Counter | `{span}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_metric_points` | Counter | `{datapoint}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_log_records` | Counter | `{record}` | `receiver`, `transport` | - |
| `otelcol_receiver_refused_log_records` | Counter | `{record}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_log_records` | Counter | `{record}` | `receiver`, `transport` | `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_accepted_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. |
| `otelcol_receiver_refused_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. `receiverhelper.newReceiverMetrics` distinguishes downstream refusal from internal failure; when disabled, errors are counted as refused. |
| `otelcol_receiver_failed_profile_samples` | Counter | `{sample}` | `receiver`, `transport` | Profiles are alpha stability. `receiverhelper.newReceiverMetrics`; records internal failures when enabled, otherwise receives zero for errors. |
| `otelcol_receiver_requests` | Counter | `{request}` | `receiver`, `transport`, `outcome` (`success`, `refused`, or `failure`) | Emitted only when feature gate `receiverhelper.newReceiverMetrics` is enabled. |

## Sources

- `receiver/otlpreceiver/internal/trace/otlp.go`
- `receiver/otlpreceiver/internal/metrics/otlp.go`
- `receiver/otlpreceiver/internal/logs/otlp.go`
- `receiver/otlpreceiver/internal/profiles/otlp.go`
- `receiver/otlpreceiver/internal/metadata/generated_status.go`
- `receiver/receiverhelper/obsreport.go`
- `receiver/receiverhelper/internal/metadata/generated_telemetry.go`
- `receiver/receiverhelper/internal/obsmetrics.go`
- `receiver/receiverhelper/internal/metadata/generated_feature_gates.go`
  • opentelemetry-collector-contrib
    • connector
      • servicegraphconnector
        • v0.153.0.md 3.3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: connector/servicegraphconnector
version: v0.153.0
scope_name: traces_service_graph
commit_sha: 42f949127580c0d00088b785cd0b35842dc0ddb8
last_verified: 2026-10-14
---

# Service Graph Connector

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_connector_servicegraph_dropped_spans` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `otelcol_connector_servicegraph_expired_edges` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `otelcol_connector_servicegraph_total_edges` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `traces_service_graph_request_total` | Sum (monotonic, cumulative) | - | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | - |
| `traces_service_graph_request_failed_total` | Sum (monotonic, cumulative) | - | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | - |
| `traces_service_graph_request_server` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Emitted only when gate `connector.servicegraph.legacyLatencyMetricNames` is disabled. Exponential histogram when `exponential_histogram_max_size` is configured; otherwise histogram using `latency_histogram_buckets`. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |
| `traces_service_graph_request_client` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Emitted only when gate `connector.servicegraph.legacyLatencyMetricNames` is disabled. Exponential histogram when `exponential_histogram_max_size` is configured; otherwise histogram using `latency_histogram_buckets`. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |
| `traces_service_graph_request_duration` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Replaces server and client latency metrics when feature gate `connector.servicegraph.legacyLatencyMetricNames` is enabled. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |

## Sources

- `connector/servicegraphconnector/connector.go`
- `connector/servicegraphconnector/factory.go`
- `connector/servicegraphconnector/config.go`
- `connector/servicegraphconnector/metadata.yaml`
- `connector/servicegraphconnector/internal/metadata/generated_telemetry.go`
        • v0.154.0.md 3.3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: connector/servicegraphconnector
version: v0.154.0
scope_name: traces_service_graph
commit_sha: 853eda0e12b3ba142552ecd2b63cec07062904f0
last_verified: 2026-10-14
---

# Service Graph Connector

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_connector_servicegraph_dropped_spans` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `otelcol_connector_servicegraph_expired_edges` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `otelcol_connector_servicegraph_total_edges` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `traces_service_graph_request_total` | Sum (monotonic, cumulative) | - | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | - |
| `traces_service_graph_request_failed_total` | Sum (monotonic, cumulative) | - | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | - |
| `traces_service_graph_request_server` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Emitted only when gate `connector.servicegraph.legacyLatencyMetricNames` is disabled. Exponential histogram when `exponential_histogram_max_size` is configured; otherwise histogram using `latency_histogram_buckets`. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |
| `traces_service_graph_request_client` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Emitted only when gate `connector.servicegraph.legacyLatencyMetricNames` is disabled. Exponential histogram when `exponential_histogram_max_size` is configured; otherwise histogram using `latency_histogram_buckets`. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |
| `traces_service_graph_request_duration` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Replaces server and client latency metrics when feature gate `connector.servicegraph.legacyLatencyMetricNames` is enabled. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |

## Sources

- `connector/servicegraphconnector/connector.go`
- `connector/servicegraphconnector/factory.go`
- `connector/servicegraphconnector/config.go`
- `connector/servicegraphconnector/metadata.yaml`
- `connector/servicegraphconnector/internal/metadata/generated_telemetry.go`
        • v0.155.0.md 3.3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: connector/servicegraphconnector
version: v0.155.0
scope_name: traces_service_graph
commit_sha: aaf5045a24c0a6f000225c97ad5449e69aeb5835
last_verified: 2026-10-14
---

# Service Graph Connector

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_connector_servicegraph_dropped_spans` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `otelcol_connector_servicegraph_expired_edges` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `otelcol_connector_servicegraph_total_edges` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `traces_service_graph_request_total` | Sum (monotonic, cumulative) | - | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | - |
| `traces_service_graph_request_failed_total` | Sum (monotonic, cumulative) | - | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | - |
| `traces_service_graph_request_server` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Emitted only when gate `connector.servicegraph.legacyLatencyMetricNames` is disabled. Exponential histogram when `exponential_histogram_max_size` is configured; otherwise histogram using `latency_histogram_buckets`. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |
| `traces_service_graph_request_client` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Emitted only when gate `connector.servicegraph.legacyLatencyMetricNames` is disabled. Exponential histogram when `exponential_histogram_max_size` is configured; otherwise histogram using `latency_histogram_buckets`. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |
| `traces_service_graph_request_duration` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Replaces server and client latency metrics when feature gate `connector.servicegraph.legacyLatencyMetricNames` is enabled. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |

## Sources

- `connector/servicegraphconnector/connector.go`
- `connector/servicegraphconnector/factory.go`
- `connector/servicegraphconnector/config.go`
- `connector/servicegraphconnector/metadata.yaml`
- `connector/servicegraphconnector/internal/metadata/generated_telemetry.go`
        • v0.156.0.md 3.3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: connector/servicegraphconnector
version: v0.156.0
scope_name: traces_service_graph
commit_sha: 41e24cd516dd69a5b4277465cdb2ff4ef0676f49
last_verified: 2026-10-14
---

# Service Graph Connector

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_connector_servicegraph_dropped_spans` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `otelcol_connector_servicegraph_expired_edges` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `otelcol_connector_servicegraph_total_edges` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `traces_service_graph_request_total` | Sum (monotonic, cumulative) | - | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | - |
| `traces_service_graph_request_failed_total` | Sum (monotonic, cumulative) | - | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | - |
| `traces_service_graph_request_server` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Emitted only when gate `connector.servicegraph.legacyLatencyMetricNames` is disabled. Exponential histogram when `exponential_histogram_max_size` is configured; otherwise histogram using `latency_histogram_buckets`. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |
| `traces_service_graph_request_client` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Emitted only when gate `connector.servicegraph.legacyLatencyMetricNames` is disabled. Exponential histogram when `exponential_histogram_max_size` is configured; otherwise histogram using `latency_histogram_buckets`. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |
| `traces_service_graph_request_duration` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Replaces server and client latency metrics when feature gate `connector.servicegraph.legacyLatencyMetricNames` is enabled. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |

## Sources

- `connector/servicegraphconnector/connector.go`
- `connector/servicegraphconnector/factory.go`
- `connector/servicegraphconnector/config.go`
- `connector/servicegraphconnector/metadata.yaml`
- `connector/servicegraphconnector/internal/metadata/generated_telemetry.go`
        • v0.157.0.md 3.3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: connector/servicegraphconnector
version: v0.157.0
scope_name: traces_service_graph
commit_sha: 89e43555904cd97c2d36605347c5d5237b1bdc8c
last_verified: 2026-10-14
---

# Service Graph Connector

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_connector_servicegraph_dropped_spans` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `otelcol_connector_servicegraph_expired_edges` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `otelcol_connector_servicegraph_total_edges` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `traces_service_graph_request_total` | Sum (monotonic, cumulative) | - | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | - |
| `traces_service_graph_request_failed_total` | Sum (monotonic, cumulative) | - | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | - |
| `traces_service_graph_request_server` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Emitted only when gate `connector.servicegraph.legacyLatencyMetricNames` is disabled. Exponential histogram when `exponential_histogram_max_size` is configured; otherwise histogram using `latency_histogram_buckets`. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |
| `traces_service_graph_request_client` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Emitted only when gate `connector.servicegraph.legacyLatencyMetricNames` is disabled. Exponential histogram when `exponential_histogram_max_size` is configured; otherwise histogram using `latency_histogram_buckets`. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |
| `traces_service_graph_request_duration` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Replaces server and client latency metrics when feature gate `connector.servicegraph.legacyLatencyMetricNames` is enabled. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |

## Sources

- `connector/servicegraphconnector/connector.go`
- `connector/servicegraphconnector/factory.go`
- `connector/servicegraphconnector/config.go`
- `connector/servicegraphconnector/metadata.yaml`
- `connector/servicegraphconnector/internal/metadata/generated_telemetry.go`
        • v0.158.0.md 3.3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: connector/servicegraphconnector
version: v0.158.0
scope_name: traces_service_graph
commit_sha: 821a9d9c2c1623c4a0ceba5d47b57c48879c3f84
last_verified: 2026-10-14
---

# Service Graph Connector

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_connector_servicegraph_dropped_spans` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `otelcol_connector_servicegraph_expired_edges` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `otelcol_connector_servicegraph_total_edges` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `traces_service_graph_request_total` | Sum (monotonic, cumulative) | - | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | - |
| `traces_service_graph_request_failed_total` | Sum (monotonic, cumulative) | - | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | - |
| `traces_service_graph_request_server` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Emitted only when gate `connector.servicegraph.legacyLatencyMetricNames` is disabled. Exponential histogram when `exponential_histogram_max_size` is configured; otherwise histogram using `latency_histogram_buckets`. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |
| `traces_service_graph_request_client` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Emitted only when gate `connector.servicegraph.legacyLatencyMetricNames` is disabled. Exponential histogram when `exponential_histogram_max_size` is configured; otherwise histogram using `latency_histogram_buckets`. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |
| `traces_service_graph_request_duration` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Replaces server and client latency metrics when feature gate `connector.servicegraph.legacyLatencyMetricNames` is enabled. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |

## Sources

- `connector/servicegraphconnector/connector.go`
- `connector/servicegraphconnector/factory.go`
- `connector/servicegraphconnector/config.go`
- `connector/servicegraphconnector/metadata.yaml`
- `connector/servicegraphconnector/internal/metadata/generated_telemetry.go`
        • v0.159.0.md 3.3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: connector/servicegraphconnector
version: v0.159.0
scope_name: traces_service_graph
commit_sha: 1120cc0714bf4d14600105e5673c3b00fe87467a
last_verified: 2026-10-14
---

# Service Graph Connector

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_connector_servicegraph_dropped_spans` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `otelcol_connector_servicegraph_expired_edges` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `otelcol_connector_servicegraph_total_edges` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `traces_service_graph_request_total` | Sum (monotonic, cumulative) | - | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | - |
| `traces_service_graph_request_failed_total` | Sum (monotonic, cumulative) | - | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | - |
| `traces_service_graph_request_server` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Emitted only when gate `connector.servicegraph.legacyLatencyMetricNames` is disabled. Exponential histogram when `exponential_histogram_max_size` is configured; otherwise histogram using `latency_histogram_buckets`. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |
| `traces_service_graph_request_client` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Emitted only when gate `connector.servicegraph.legacyLatencyMetricNames` is disabled. Exponential histogram when `exponential_histogram_max_size` is configured; otherwise histogram using `latency_histogram_buckets`. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |
| `traces_service_graph_request_duration` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Replaces server and client latency metrics when feature gate `connector.servicegraph.legacyLatencyMetricNames` is enabled. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |

## Sources

- `connector/servicegraphconnector/connector.go`
- `connector/servicegraphconnector/factory.go`
- `connector/servicegraphconnector/config.go`
- `connector/servicegraphconnector/metadata.yaml`
- `connector/servicegraphconnector/internal/metadata/generated_telemetry.go`
        • v0.160.0.md 3.3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: connector/servicegraphconnector
version: v0.160.0
scope_name: traces_service_graph
commit_sha: 982f20b8a8e8a2569fab3e27cf8b008e8a5080c1
last_verified: 2026-10-14
---

# Service Graph Connector

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_connector_servicegraph_dropped_spans` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `otelcol_connector_servicegraph_expired_edges` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `otelcol_connector_servicegraph_total_edges` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `traces_service_graph_request_total` | Sum (monotonic, cumulative) | - | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | - |
| `traces_service_graph_request_failed_total` | Sum (monotonic, cumulative) | - | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | - |
| `traces_service_graph_request_server` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Emitted only when gate `connector.servicegraph.legacyLatencyMetricNames` is disabled. Exponential histogram when `exponential_histogram_max_size` is configured; otherwise histogram using `latency_histogram_buckets`. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |
| `traces_service_graph_request_client` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Emitted only when gate `connector.servicegraph.legacyLatencyMetricNames` is disabled. Exponential histogram when `exponential_histogram_max_size` is configured; otherwise histogram using `latency_histogram_buckets`. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |
| `traces_service_graph_request_duration` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Replaces server and client latency metrics when feature gate `connector.servicegraph.legacyLatencyMetricNames` is enabled. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |

## Sources

- `connector/servicegraphconnector/connector.go`
- `connector/servicegraphconnector/factory.go`
- `connector/servicegraphconnector/config.go`
- `connector/servicegraphconnector/metadata.yaml`
- `connector/servicegraphconnector/internal/metadata/generated_telemetry.go`
        • v0.161.0.md 3.3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: connector/servicegraphconnector
version: v0.161.0
scope_name: traces_service_graph
commit_sha: 3f8455d8038a985398861171e5310bc9b4e988b2
last_verified: 2026-10-14
---

# Service Graph Connector

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_connector_servicegraph_dropped_spans` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `otelcol_connector_servicegraph_expired_edges` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `otelcol_connector_servicegraph_total_edges` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `traces_service_graph_request_total` | Sum (monotonic, cumulative) | - | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | - |
| `traces_service_graph_request_failed_total` | Sum (monotonic, cumulative) | - | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | - |
| `traces_service_graph_request_server` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Emitted only when gate `connector.servicegraph.legacyLatencyMetricNames` is disabled. Exponential histogram when `exponential_histogram_max_size` is configured; otherwise histogram using `latency_histogram_buckets`. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |
| `traces_service_graph_request_client` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Emitted only when gate `connector.servicegraph.legacyLatencyMetricNames` is disabled. Exponential histogram when `exponential_histogram_max_size` is configured; otherwise histogram using `latency_histogram_buckets`. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |
| `traces_service_graph_request_duration` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Replaces server and client latency metrics when feature gate `connector.servicegraph.legacyLatencyMetricNames` is enabled. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |

## Sources

- `connector/servicegraphconnector/connector.go`
- `connector/servicegraphconnector/factory.go`
- `connector/servicegraphconnector/config.go`
- `connector/servicegraphconnector/metadata.yaml`
- `connector/servicegraphconnector/internal/metadata/generated_telemetry.go`
        • v0.162.0.md 3.3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: connector/servicegraphconnector
version: v0.162.0
scope_name: traces_service_graph
commit_sha: ae8c507510f48f433ab47dd1c6b01a59d6c388b5
last_verified: 2026-10-14
---

# Service Graph Connector

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_connector_servicegraph_dropped_spans` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `otelcol_connector_servicegraph_expired_edges` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `otelcol_connector_servicegraph_total_edges` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `traces_service_graph_request_total` | Sum (monotonic, cumulative) | - | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | - |
| `traces_service_graph_request_failed_total` | Sum (monotonic, cumulative) | - | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | - |
| `traces_service_graph_request_server` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Emitted only when gate `connector.servicegraph.legacyLatencyMetricNames` is disabled. Exponential histogram when `exponential_histogram_max_size` is configured; otherwise histogram using `latency_histogram_buckets`. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |
| `traces_service_graph_request_client` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Emitted only when gate `connector.servicegraph.legacyLatencyMetricNames` is disabled. Exponential histogram when `exponential_histogram_max_size` is configured; otherwise histogram using `latency_histogram_buckets`. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |
| `traces_service_graph_request_duration` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Replaces server and client latency metrics when feature gate `connector.servicegraph.legacyLatencyMetricNames` is enabled. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |

## Sources

- `connector/servicegraphconnector/connector.go`
- `connector/servicegraphconnector/factory.go`
- `connector/servicegraphconnector/config.go`
- `connector/servicegraphconnector/metadata.yaml`
- `connector/servicegraphconnector/internal/metadata/generated_telemetry.go`
        • v0.163.0.md 3.3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: connector/servicegraphconnector
version: v0.163.0
scope_name: traces_service_graph
commit_sha: df849b5403c041d5e799e7846392a6f18b0b55ae
last_verified: 2026-10-14
---

# Service Graph Connector

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_connector_servicegraph_dropped_spans` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `otelcol_connector_servicegraph_expired_edges` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `otelcol_connector_servicegraph_total_edges` | Counter | 1 | - | Scope: `github.com/open-telemetry/opentelemetry-collector-contrib/connector/servicegraphconnector` (Collector internal telemetry). |
| `traces_service_graph_request_total` | Sum (monotonic, cumulative) | - | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | - |
| `traces_service_graph_request_failed_total` | Sum (monotonic, cumulative) | - | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | - |
| `traces_service_graph_request_server` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Emitted only when gate `connector.servicegraph.legacyLatencyMetricNames` is disabled. Exponential histogram when `exponential_histogram_max_size` is configured; otherwise histogram using `latency_histogram_buckets`. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |
| `traces_service_graph_request_client` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Emitted only when gate `connector.servicegraph.legacyLatencyMetricNames` is disabled. Exponential histogram when `exponential_histogram_max_size` is configured; otherwise histogram using `latency_histogram_buckets`. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |
| `traces_service_graph_request_duration` | Histogram or exponential histogram (cumulative) | s (or ms) | `client`, `server`, `connection_type`, `failed`, configured `client_<dimension>` and `server_<dimension>`; `virtual_node` when `virtual_node_extra_label` is true | Replaces server and client latency metrics when feature gate `connector.servicegraph.legacyLatencyMetricNames` is enabled. Unit is ms when feature gate `connector.servicegraph.legacyLatencyUnitMs` is enabled. |

## Sources

- `connector/servicegraphconnector/connector.go`
- `connector/servicegraphconnector/factory.go`
- `connector/servicegraphconnector/config.go`
- `connector/servicegraphconnector/metadata.yaml`
- `connector/servicegraphconnector/internal/metadata/generated_telemetry.go`
      • spanmetricsconnector
        • v0.153.0.md 2.8 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: connector/spanmetricsconnector
version: v0.153.0
scope_name: spanmetricsconnector
commit_sha: 42f949127580c0d00088b785cd0b35842dc0ddb8
last_verified: 2026-10-14
---

# Span Metrics Connector

## Metrics

Metric names use `<namespace>.<metric>` with default namespace `traces.span.metrics`. An empty namespace emits `calls`, `duration`, and `events`; gate `connector.spanmetrics.legacyMetricNames` also removes the default namespace for all three metrics.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `traces.span.metrics.calls` | Sum (monotonic) | 1 | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and `calls_dimensions`; optional `span.instrumentation.scope.name`, `span.instrumentation.scope.version`, `sampling.method` | Always emitted for spans with `service.name`; `status.code` is replaced by `otel.status_code` when feature gate `spanmetrics.statusCodeConvention.useOtelPrefix` is enabled. `collector.instance.id` is added when gate `connector.spanmetrics.includeCollectorInstanceID` is enabled. Default namespace/name becomes `calls` when `connector.spanmetrics.legacyMetricNames` is enabled. |
| `traces.span.metrics.duration` | Histogram (explicit or exponential) | `ms` by default; `s` when gate `connector.spanmetrics.useSecondAsDefaultMetricsUnit` is enabled (or as configured) | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and histogram `dimensions`; optional scope, sampling, and collector-instance attributes as above | Omitted when `histogram.disable` is true. Same status/name/collector gates as `calls`. |
| `traces.span.metrics.events` | Sum (monotonic) | 1 | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and event `dimensions`; optional scope, sampling, and collector-instance attributes as above | Emitted only when `events.enabled` is true, and has one data point per span event. Same status/name/collector gates as `calls`. |

Resource attributes are attached to the output ResourceMetrics unless feature gate `connector.spanmetrics.excludeResourceMetrics` is enabled (the `add_resource_attributes` setting restores them). `exclude_dimensions` can remove default dimensions; configured dimensions are looked up on span/resource (event metrics also use event attributes). When `aggregation_cardinality_limit` is reached, the overflow data point has only `otel.metric.overflow=true`. Exemplars are optional and carry trace/span IDs.

## Sources

- `connector/spanmetricsconnector/connector.go`
- `connector/spanmetricsconnector/config.go`
- `connector/spanmetricsconnector/factory.go`
- `connector/spanmetricsconnector/internal/metrics/metrics.go`
- `connector/spanmetricsconnector/metadata.yaml`
        • v0.154.0.md 2.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: connector/spanmetricsconnector
version: v0.154.0
scope_name: spanmetricsconnector
commit_sha: 853eda0e12b3ba142552ecd2b63cec07062904f0
last_verified: 2026-10-14
---

# Span Metrics Connector

## Metrics

Metric names use `<namespace>.<metric>` with default namespace `traces.span.metrics`. An empty namespace emits `calls`, `duration`, and `events`; gate `connector.spanmetrics.legacyMetricNames` also removes the default namespace for all three metrics.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `traces.span.metrics.calls` | Sum (monotonic) | 1 | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and `calls_dimensions` (including matching `glob` dimensions); optional `span.instrumentation.scope.name`, `span.instrumentation.scope.version`, `sampling.method` | Always emitted for spans with `service.name`; `status.code` is replaced by `otel.status_code` when feature gate `spanmetrics.statusCodeConvention.useOtelPrefix` is enabled. `collector.instance.id` is added when gate `connector.spanmetrics.includeCollectorInstanceID` is enabled. Default namespace/name becomes `calls` when `connector.spanmetrics.legacyMetricNames` is enabled. |
| `traces.span.metrics.duration` | Histogram (explicit or exponential) | `ms` by default; `s` when gate `connector.spanmetrics.useSecondAsDefaultMetricsUnit` is enabled (or as configured) | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and histogram `dimensions` (including matching `glob` dimensions); optional scope, sampling, and collector-instance attributes as above | Omitted when `histogram.disable` is true. Same status/name/collector gates as `calls`. |
| `traces.span.metrics.events` | Sum (monotonic) | 1 | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and event `dimensions` (including matching `glob` dimensions); optional scope, sampling, and collector-instance attributes as above | Emitted only when `events.enabled` is true, and has one data point per span event. Same status/name/collector gates as `calls`. |

Resource attributes are attached to the output ResourceMetrics unless feature gate `connector.spanmetrics.excludeResourceMetrics` is enabled (the `add_resource_attributes` setting restores them). `exclude_dimensions` can remove default dimensions; named dimensions use optional defaults, while `glob` dimensions match span/resource keys (span wins). Event dimensions also use event attributes. When `aggregation_cardinality_limit` is reached, the overflow data point has only `otel.metric.overflow=true`. Exemplars are optional and carry trace/span IDs.

## Sources

- `connector/spanmetricsconnector/connector.go`
- `connector/spanmetricsconnector/config.go`
- `connector/spanmetricsconnector/factory.go`
- `connector/spanmetricsconnector/internal/metrics/metrics.go`
- `connector/spanmetricsconnector/metadata.yaml`
        • v0.155.0.md 2.8 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: connector/spanmetricsconnector
version: v0.155.0
scope_name: spanmetricsconnector
commit_sha: aaf5045a24c0a6f000225c97ad5449e69aeb5835
last_verified: 2026-10-14
---

# Span Metrics Connector

## Metrics

Metric names use `<namespace>.<metric>` with default namespace `traces.span.metrics`. An empty namespace emits `calls`, `duration`, and `events`; gate `connector.spanmetrics.legacyMetricNames` also removes the default namespace for all three metrics.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `traces.span.metrics.calls` | Sum (monotonic) | 1 | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and `calls_dimensions` (including matching `glob` dimensions); optional `span.instrumentation.scope.name`, `span.instrumentation.scope.version`, `sampling.method` | Always emitted for spans with `service.name`; `status.code` is replaced by `otel.status_code` when gate `spanmetrics.statusCodeConvention.useOtelPrefix` is enabled. `collector.instance.id` is added when gate `connector.spanmetrics.includeCollectorInstanceID` is enabled. Legacy gate `connector.spanmetrics.legacyMetricNames` changes the default name to `calls`. |
| `traces.span.metrics.duration` | Histogram (explicit or exponential) | `ms` by default; `s` when gate `connector.spanmetrics.useSecondAsDefaultMetricsUnit` is enabled (or as configured) | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and histogram `dimensions`; optional scope, sampling, and collector-instance attributes as above | Omitted when `histogram.disable` is true. Same status/name/collector gates as `calls`. |
| `traces.span.metrics.events` | Sum (monotonic) | 1 | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and event `dimensions`; optional scope, sampling, and collector-instance attributes as above | Emitted only when `events.enabled` is true, one data point per span event. Same status/name/collector gates as `calls`. |

Resource attributes are attached to output ResourceMetrics unless gate `connector.spanmetrics.excludeResourceMetrics` is enabled (the `add_resource_attributes` setting restores them). `exclude_dimensions` removes default dimensions; configured named/glob dimensions are conditional on matching attributes. Event dimensions also use event attributes. When `aggregation_cardinality_limit` is reached, the overflow data point has only `otel.metric.overflow=true`. Exemplars are optional and carry trace/span IDs.

## Sources

- `connector/spanmetricsconnector/connector.go`
- `connector/spanmetricsconnector/config.go`
- `connector/spanmetricsconnector/factory.go`
- `connector/spanmetricsconnector/internal/metrics/metrics.go`
- `connector/spanmetricsconnector/metadata.yaml`
        • v0.156.0.md 2.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: connector/spanmetricsconnector
version: v0.156.0
scope_name: spanmetricsconnector
commit_sha: 41e24cd516dd69a5b4277465cdb2ff4ef0676f49
last_verified: 2026-10-14
---

# Span Metrics Connector

## Metrics

Metric names use `<namespace>.<metric>` with default namespace `traces.span.metrics`. An empty namespace emits `calls`, `duration`, and `events`; gate `connector.spanmetrics.legacyMetricNames` also removes the default namespace for all three metrics.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `traces.span.metrics.calls` | Sum (monotonic) | 1 | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and `calls_dimensions`; optional `span.instrumentation.scope.name`, `span.instrumentation.scope.version`, `sampling.method` | Always emitted for spans with `service.name`; `status.code` becomes `otel.status_code` under gate `spanmetrics.statusCodeConvention.useOtelPrefix`. `collector.instance.id` is gated by `connector.spanmetrics.includeCollectorInstanceID`. `connector.spanmetrics.legacyMetricNames` changes the default name to `calls`. |
| `traces.span.metrics.duration` | Histogram (explicit or exponential) | `ms` by default; `s` under gate `connector.spanmetrics.useSecondAsDefaultMetricsUnit` (or as configured) | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and histogram `dimensions`; optional scope, sampling, and collector-instance attributes as above | Omitted when `histogram.disable` is true. |
| `traces.span.metrics.events` | Sum (monotonic) | 1 | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and event `dimensions`; optional scope, sampling, and collector-instance attributes as above | Emitted only when `events.enabled` is true, one data point per span event. |

Resource attributes are attached to output ResourceMetrics unless gate `connector.spanmetrics.excludeResourceMetrics` is enabled (the `add_resource_attributes` setting restores them). `exclude_dimensions` removes default dimensions; configured dimensions are conditional on matching span/resource (and event) attributes. When `aggregation_cardinality_limit` is reached, the overflow data point has only `otel.metric.overflow=true`. Exemplars are optional and carry trace/span IDs.

## Sources

- `connector/spanmetricsconnector/connector.go`
- `connector/spanmetricsconnector/config.go`
- `connector/spanmetricsconnector/factory.go`
- `connector/spanmetricsconnector/internal/metrics/metrics.go`
- `connector/spanmetricsconnector/metadata.yaml`
        • v0.157.0.md 2.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: connector/spanmetricsconnector
version: v0.157.0
scope_name: spanmetricsconnector
commit_sha: 89e43555904cd97c2d36605347c5d5237b1bdc8c
last_verified: 2026-10-14
---

# Span Metrics Connector

## Metrics

Metric names use `<namespace>.<metric>` with default namespace `traces.span.metrics`. An empty namespace emits `calls`, `duration`, and `events`; gate `connector.spanmetrics.legacyMetricNames` also removes the default namespace for all three metrics.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `traces.span.metrics.calls` | Sum (monotonic) | 1 | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and `calls_dimensions`; optional `span.instrumentation.scope.name`, `span.instrumentation.scope.version`, `sampling.method` | Always emitted for spans with `service.name`; status attribute uses `otel.status_code` under gate `spanmetrics.statusCodeConvention.useOtelPrefix`. `collector.instance.id` is gated by `connector.spanmetrics.includeCollectorInstanceID`. Legacy gate `connector.spanmetrics.legacyMetricNames` changes the default name to `calls`. |
| `traces.span.metrics.duration` | Histogram (explicit or exponential) | `ms` by default; `s` under gate `connector.spanmetrics.useSecondAsDefaultMetricsUnit` (or as configured) | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and histogram `dimensions`; optional scope, sampling, and collector-instance attributes as above | Omitted when `histogram.disable` is true. |
| `traces.span.metrics.events` | Sum (monotonic) | 1 | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and event `dimensions`; optional scope, sampling, and collector-instance attributes as above | Emitted only when `events.enabled` is true, one data point per span event. |

Resource attributes are attached to output ResourceMetrics unless gate `connector.spanmetrics.excludeResourceMetrics` is enabled (the `add_resource_attributes` setting restores them). `exclude_dimensions` removes default dimensions; configured dimensions are conditional on matching attributes. When `aggregation_cardinality_limit` is reached, the overflow data point has only `otel.metric.overflow=true`. Exemplars are optional and carry trace/span IDs.

## Sources

- `connector/spanmetricsconnector/connector.go`
- `connector/spanmetricsconnector/config.go`
- `connector/spanmetricsconnector/factory.go`
- `connector/spanmetricsconnector/internal/metrics/metrics.go`
- `connector/spanmetricsconnector/metadata.yaml`
        • v0.158.0.md 2.7 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: connector/spanmetricsconnector
version: v0.158.0
scope_name: spanmetricsconnector
commit_sha: 821a9d9c2c1623c4a0ceba5d47b57c48879c3f84
last_verified: 2026-10-14
---

# Span Metrics Connector

## Metrics

Metric names use `<namespace>.<metric>` with default namespace `traces.span.metrics`. An empty namespace emits `calls`, `duration`, and `events`; gate `connector.spanmetrics.legacyMetricNames` also removes the default namespace for all three metrics.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `traces.span.metrics.calls` | Sum (monotonic) | 1 | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and `calls_dimensions` (including matching `glob` dimensions); optional `span.instrumentation.scope.name`, `span.instrumentation.scope.version`, `sampling.method` | Always emitted for spans with `service.name`; `status.code` is replaced by `otel.status_code` under gate `spanmetrics.statusCodeConvention.useOtelPrefix`. `collector.instance.id` is gated by `connector.spanmetrics.includeCollectorInstanceID`. `connector.spanmetrics.legacyMetricNames` changes the default name to `calls`. |
| `traces.span.metrics.duration` | Histogram (explicit or exponential) | `ms` by default; `s` under gate `connector.spanmetrics.useSecondAsDefaultMetricsUnit` (or as configured) | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and histogram `dimensions` (including matching `glob` dimensions); optional scope, sampling, and collector-instance attributes as above | Omitted when `histogram.disable` is true. |
| `traces.span.metrics.events` | Sum (monotonic) | 1 | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and event `dimensions` (including matching `glob` dimensions); optional scope, sampling, and collector-instance attributes as above | Emitted only when `events.enabled` is true, one data point per span event. |

Resource attributes are attached to output ResourceMetrics unless gate `connector.spanmetrics.excludeResourceMetrics` is enabled (the `add_resource_attributes` setting restores them). `exclude_dimensions` removes default dimensions; named dimensions use optional defaults, and glob dimensions match span/resource keys with span precedence. Event dimensions also use event attributes. When `aggregation_cardinality_limit` is reached, the overflow data point has only `otel.metric.overflow=true`. Exemplars are optional and carry trace/span IDs.

## Sources

- `connector/spanmetricsconnector/connector.go`
- `connector/spanmetricsconnector/config.go`
- `connector/spanmetricsconnector/factory.go`
- `connector/spanmetricsconnector/internal/metrics/metrics.go`
- `connector/spanmetricsconnector/metadata.yaml`
        • v0.159.0.md 2.7 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: connector/spanmetricsconnector
version: v0.159.0
scope_name: spanmetricsconnector
commit_sha: 1120cc0714bf4d14600105e5673c3b00fe87467a
last_verified: 2026-10-14
---

# Span Metrics Connector

## Metrics

Metric names use `<namespace>.<metric>` with default namespace `traces.span.metrics`. An empty namespace emits `calls`, `duration`, and `events`; gate `connector.spanmetrics.legacyMetricNames` also removes the default namespace for all three metrics.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `traces.span.metrics.calls` | Sum (monotonic) | 1 | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and `calls_dimensions` (including matching `glob` dimensions); optional `span.instrumentation.scope.name`, `span.instrumentation.scope.version`, `sampling.method` | Always emitted for spans with `service.name`; `status.code` is replaced by `otel.status_code` under gate `spanmetrics.statusCodeConvention.useOtelPrefix`. `collector.instance.id` is gated by `connector.spanmetrics.includeCollectorInstanceID`. `connector.spanmetrics.legacyMetricNames` changes the default name to `calls`. |
| `traces.span.metrics.duration` | Histogram (explicit or exponential) | `ms` by default; `s` under gate `connector.spanmetrics.useSecondAsDefaultMetricsUnit` (or as configured) | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and histogram `dimensions` (including matching `glob` dimensions); optional scope, sampling, and collector-instance attributes as above | Omitted when `histogram.disable` is true. |
| `traces.span.metrics.events` | Sum (monotonic) | 1 | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and event `dimensions` (including matching `glob` dimensions); optional scope, sampling, and collector-instance attributes as above | Emitted only when `events.enabled` is true, one data point per span event. |

Resource attributes are attached to output ResourceMetrics unless gate `connector.spanmetrics.excludeResourceMetrics` is enabled (the `add_resource_attributes` setting restores them). `exclude_dimensions` removes default dimensions; named dimensions use optional defaults, and glob dimensions match span/resource keys with span precedence. Event dimensions also use event attributes. When `aggregation_cardinality_limit` is reached, the overflow data point has only `otel.metric.overflow=true`. Exemplars are optional and carry trace/span IDs.

## Sources

- `connector/spanmetricsconnector/connector.go`
- `connector/spanmetricsconnector/config.go`
- `connector/spanmetricsconnector/factory.go`
- `connector/spanmetricsconnector/internal/metrics/metrics.go`
- `connector/spanmetricsconnector/metadata.yaml`
        • v0.160.0.md 2.7 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: connector/spanmetricsconnector
version: v0.160.0
scope_name: spanmetricsconnector
commit_sha: 982f20b8a8e8a2569fab3e27cf8b008e8a5080c1
last_verified: 2026-10-14
---

# Span Metrics Connector

## Metrics

Metric names use `<namespace>.<metric>` with default namespace `traces.span.metrics`. An empty namespace emits `calls`, `duration`, and `events`; gate `connector.spanmetrics.legacyMetricNames` also removes the default namespace for all three metrics.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `traces.span.metrics.calls` | Sum (monotonic) | 1 | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and `calls_dimensions` (including matching `glob` dimensions); optional `span.instrumentation.scope.name`, `span.instrumentation.scope.version`, `sampling.method` | Always emitted for spans with `service.name`; `status.code` is replaced by `otel.status_code` under gate `spanmetrics.statusCodeConvention.useOtelPrefix`. `collector.instance.id` is gated by `connector.spanmetrics.includeCollectorInstanceID`. `connector.spanmetrics.legacyMetricNames` changes the default name to `calls`. |
| `traces.span.metrics.duration` | Histogram (explicit or exponential) | `ms` by default; `s` under gate `connector.spanmetrics.useSecondAsDefaultMetricsUnit` (or as configured) | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and histogram `dimensions` (including matching `glob` dimensions); optional scope, sampling, and collector-instance attributes as above | Omitted when `histogram.disable` is true. |
| `traces.span.metrics.events` | Sum (monotonic) | 1 | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and event `dimensions` (including matching `glob` dimensions); optional scope, sampling, and collector-instance attributes as above | Emitted only when `events.enabled` is true, one data point per span event. |

Resource attributes are attached to output ResourceMetrics unless gate `connector.spanmetrics.excludeResourceMetrics` is enabled (the `add_resource_attributes` setting restores them). `exclude_dimensions` removes default dimensions; named dimensions use optional defaults, and glob dimensions match span/resource keys with span precedence. Event dimensions also use event attributes. When `aggregation_cardinality_limit` is reached, the overflow data point has only `otel.metric.overflow=true`. Exemplars are optional and carry trace/span IDs.

## Sources

- `connector/spanmetricsconnector/connector.go`
- `connector/spanmetricsconnector/config.go`
- `connector/spanmetricsconnector/factory.go`
- `connector/spanmetricsconnector/internal/metrics/metrics.go`
- `connector/spanmetricsconnector/metadata.yaml`
        • v0.161.0.md 2.8 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: connector/spanmetricsconnector
version: v0.161.0
scope_name: spanmetricsconnector
commit_sha: 3f8455d8038a985398861171e5310bc9b4e988b2
last_verified: 2026-10-14
---

# Span Metrics Connector

## Metrics

Metric names use `<namespace>.<metric>` with default namespace `traces.span.metrics`. An empty namespace emits `calls`, `duration`, and `events`; gate `connector.spanmetrics.legacyMetricNames` also removes the default namespace for all three metrics.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `traces.span.metrics.calls` | Sum (monotonic) | 1 | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and `calls_dimensions` (including matching `glob` dimensions); optional `span.instrumentation.scope.name`, `span.instrumentation.scope.version`, `sampling.method` | Always emitted for spans with `service.name`; `status.code` is replaced by `otel.status_code` under gate `spanmetrics.statusCodeConvention.useOtelPrefix`. `collector.instance.id` is gated by `connector.spanmetrics.includeCollectorInstanceID`. `connector.spanmetrics.legacyMetricNames` changes the default name to `calls`. |
| `traces.span.metrics.duration` | Histogram (explicit or exponential) | `ms` by default; `s` under gate `connector.spanmetrics.useSecondAsDefaultMetricsUnit` (or as configured) | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and histogram `dimensions` (including matching `glob` dimensions); optional scope, sampling, and collector-instance attributes as above | Omitted when `histogram.disable` is true. |
| `traces.span.metrics.events` | Sum (monotonic) | 1 | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and event `dimensions` (including matching `glob` dimensions); optional scope, sampling, and collector-instance attributes as above | Emitted only when `events.enabled` is true. Each span event increments the sum; data points aggregate by dimension set. |

Resource attributes are attached to output ResourceMetrics unless gate `connector.spanmetrics.excludeResourceMetrics` is enabled (the `add_resource_attributes` setting restores them). `exclude_dimensions` removes default dimensions; named dimensions use optional defaults, and glob dimensions match span/resource keys with span precedence. Event dimensions also use event attributes. When `aggregation_cardinality_limit` is reached, the overflow data point has only `otel.metric.overflow=true`. Exemplars are optional and carry trace/span IDs.

## Sources

- `connector/spanmetricsconnector/connector.go`
- `connector/spanmetricsconnector/config.go`
- `connector/spanmetricsconnector/factory.go`
- `connector/spanmetricsconnector/internal/metrics/metrics.go`
- `connector/spanmetricsconnector/metadata.yaml`
        • v0.162.0.md 2.8 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: connector/spanmetricsconnector
version: v0.162.0
scope_name: spanmetricsconnector
commit_sha: ae8c507510f48f433ab47dd1c6b01a59d6c388b5
last_verified: 2026-10-14
---

# Span Metrics Connector

## Metrics

Metric names use `<namespace>.<metric>` with default namespace `traces.span.metrics`. An empty namespace emits `calls`, `duration`, and `events`; gate `connector.spanmetrics.legacyMetricNames` also removes the default namespace for all three metrics.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `traces.span.metrics.calls` | Sum (monotonic) | 1 | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and `calls_dimensions` (including matching `glob` dimensions); optional `span.instrumentation.scope.name`, `span.instrumentation.scope.version`, `sampling.method` | Always emitted for spans with `service.name`; `status.code` is replaced by `otel.status_code` under gate `spanmetrics.statusCodeConvention.useOtelPrefix`. `collector.instance.id` is gated by `connector.spanmetrics.includeCollectorInstanceID`. `connector.spanmetrics.legacyMetricNames` changes the default name to `calls`. |
| `traces.span.metrics.duration` | Histogram (explicit or exponential) | `ms` by default; `s` under gate `connector.spanmetrics.useSecondAsDefaultMetricsUnit` (or as configured) | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and histogram `dimensions` (including matching `glob` dimensions); optional scope, sampling, and collector-instance attributes as above | Omitted when `histogram.disable` is true. |
| `traces.span.metrics.events` | Sum (monotonic) | 1 | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and event `dimensions` (including matching `glob` dimensions); optional scope, sampling, and collector-instance attributes as above | Emitted only when `events.enabled` is true; span events are aggregated into data points by their dimension set, each event adding its adjusted count. |

Resource attributes are attached to output ResourceMetrics unless gate `connector.spanmetrics.excludeResourceMetrics` is enabled (the `add_resource_attributes` setting restores them). `exclude_dimensions` removes default dimensions; named dimensions use optional defaults, and glob dimensions match span/resource keys with span precedence. Event dimensions also use event attributes. When `aggregation_cardinality_limit` is reached, the overflow data point has only `otel.metric.overflow=true`. Exemplars are optional and carry trace/span IDs.

## Sources

- `connector/spanmetricsconnector/connector.go`
- `connector/spanmetricsconnector/config.go`
- `connector/spanmetricsconnector/factory.go`
- `connector/spanmetricsconnector/internal/metrics/metrics.go`
- `connector/spanmetricsconnector/metadata.yaml`
        • v0.163.0.md 2.8 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: connector/spanmetricsconnector
version: v0.163.0
scope_name: spanmetricsconnector
commit_sha: df849b5403c041d5e799e7846392a6f18b0b55ae
last_verified: 2026-10-14
---

# Span Metrics Connector

## Metrics

Metric names use `<namespace>.<metric>` with default namespace `traces.span.metrics`. An empty namespace emits `calls`, `duration`, and `events`; gate `connector.spanmetrics.legacyMetricNames` also removes the default namespace for all three metrics.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `traces.span.metrics.calls` | Sum (monotonic) | 1 | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and `calls_dimensions` (including matching `glob` dimensions); optional `span.instrumentation.scope.name`, `span.instrumentation.scope.version`, `sampling.method` | Always emitted for spans with `service.name`; `status.code` is replaced by `otel.status_code` under gate `spanmetrics.statusCodeConvention.useOtelPrefix`. `collector.instance.id` is gated by `connector.spanmetrics.includeCollectorInstanceID`. `connector.spanmetrics.legacyMetricNames` changes the default name to `calls`. |
| `traces.span.metrics.duration` | Histogram (explicit or exponential) | `ms` by default; `s` under gate `connector.spanmetrics.useSecondAsDefaultMetricsUnit` (or as configured) | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and histogram `dimensions` (including matching `glob` dimensions); optional scope, sampling, and collector-instance attributes as above | Omitted when `histogram.disable` is true. |
| `traces.span.metrics.events` | Sum (monotonic) | 1 | `service.name`, `span.name`, `span.kind`, `status.code`; configured `dimensions` and event `dimensions` (including matching `glob` dimensions); optional scope, sampling, and collector-instance attributes as above | Emitted only when `events.enabled` is true; span events are aggregated into data points by their dimension set, each event adding its adjusted count. |

Resource attributes are attached to output ResourceMetrics unless gate `connector.spanmetrics.excludeResourceMetrics` is enabled (the `add_resource_attributes` setting restores them). `exclude_dimensions` removes default dimensions; named dimensions use optional defaults, and glob dimensions match span/resource keys with span precedence. Event dimensions also use event attributes. When `aggregation_cardinality_limit` is reached, the overflow data point has only `otel.metric.overflow=true`. Exemplars are optional and carry trace/span IDs.

## Sources

- `connector/spanmetricsconnector/connector.go`
- `connector/spanmetricsconnector/config.go`
- `connector/spanmetricsconnector/factory.go`
- `connector/spanmetricsconnector/internal/metrics/metrics.go`
- `connector/spanmetricsconnector/metadata.yaml`
    • exporter
      • prometheusremotewriteexporter
        • v0.154.0.md 4.7 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: exporter/prometheusremotewriteexporter
version: v0.154.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/exporter/prometheusremotewriteexporter
commit_sha: 853eda0e12b3ba142552ecd2b63cec07062904f0
last_verified: 2026-09-02
---

# Prometheus Remote Write Exporter

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_exporter_prometheusremotewrite_consumers` | Sum (non-monotonic) | `{consumer}` | `exporter`; `endpoint` | Development stability. Set once at exporter startup to the configured ceiling on parallel export requests — not a live worker count; the exporter spawns `min(ceiling, number of requests)` goroutines per batch. The ceiling is `remote_write_queue.num_consumers`, or the literal 5 if the `exporter.prometheusremotewritexporter.EnableMultipleWorkers` feature gate is enabled. `max_batch_request_parallelism` overrides both. A floor of 1 applies last, so `num_consumers: 0` reports 1. Both paths report 5 by default. |
| `otelcol_exporter_prometheusremotewrite_failed_translations` | Sum (monotonic) | `1` | `exporter`; `endpoint` | Development stability. Incremented each time the pmetric-to-Prometheus translation returns an error while batching metrics for export. |
| `otelcol_exporter_prometheusremotewrite_sent_batches` | Sum (monotonic) | `{batch}` | `exporter`; `endpoint` | Development stability. Incremented once per remote-write request batch sent, regardless of the outcome. |
| `otelcol_exporter_prometheusremotewrite_translated_time_series` | Sum (monotonic) | `1` | `exporter`; `endpoint` | Development stability. Incremented by the number of Prometheus time series produced by the OTel-to-Prometheus translation. |
| `otelcol_exporter_prometheusremotewrite_wal_bytes_read` | Sum (monotonic) | `By` | - | Development stability. Only emitted when the `wal` config block is set (write-ahead log enabled). |
| `otelcol_exporter_prometheusremotewrite_wal_bytes_written` | Sum (monotonic) | `By` | - | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_lag` | Gauge | `1` | - | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_read_latency` | Histogram | `ms` | - | Development stability. Only emitted when the `wal` config block is set. Bucket boundaries: 5, 10, 20, 50, 100, 200, 500, 1000, 2000, 5000. |
| `otelcol_exporter_prometheusremotewrite_wal_reads` | Sum (monotonic) | `1` | - | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_reads_failures` | Sum (monotonic) | `1` | - | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_write_latency` | Histogram | `ms` | - | Development stability. Only emitted when the `wal` config block is set. Bucket boundaries: 5, 10, 20, 50, 100, 200, 500, 1000, 2000, 5000. |
| `otelcol_exporter_prometheusremotewrite_wal_writes` | Sum (monotonic) | `1` | - | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_writes_failures` | Sum (monotonic) | `1` | - | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_written_exemplars` | Sum (monotonic) | `{exemplar}` | `exporter`; `endpoint` | Development stability. Only emitted when using Remote Write 2.0 (`exporter.prometheusremotewritexporter.enableSendingRW2` feature gate enabled and `protobuf_message: io.prometheus.write.v2.Request` set on the exporter); read from the `X-Prometheus-Remote-Write-Exemplars-Written` response header. |
| `otelcol_exporter_prometheusremotewrite_written_histograms` | Sum (monotonic) | `{histogram}` | `exporter`; `endpoint` | Development stability. Only emitted when using Remote Write 2.0 (same gate/config as above); read from the `X-Prometheus-Remote-Write-Histograms-Written` response header. |
| `otelcol_exporter_prometheusremotewrite_written_samples` | Sum (monotonic) | `{sample}` | `exporter`; `endpoint` | Development stability. Only emitted when using Remote Write 2.0 (same gate/config as above); read from the `X-Prometheus-Remote-Write-Samples-Written` response header. |

## Sources

- `exporter/prometheusremotewriteexporter/exporter.go`
- `exporter/prometheusremotewriteexporter/exporter_v2.go`
- `exporter/prometheusremotewriteexporter/wal.go`
- `exporter/prometheusremotewriteexporter/config.go`
- `exporter/prometheusremotewriteexporter/metadata.yaml`
- `exporter/prometheusremotewriteexporter/documentation.md`
- `exporter/prometheusremotewriteexporter/internal/metadata/generated_status.go`
        • v0.155.0.md 4.7 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: exporter/prometheusremotewriteexporter
version: v0.155.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/exporter/prometheusremotewriteexporter
commit_sha: aaf5045a24c0a6f000225c97ad5449e69aeb5835
last_verified: 2026-09-02
---

# Prometheus Remote Write Exporter

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_exporter_prometheusremotewrite_consumers` | Sum (non-monotonic) | `{consumer}` | `exporter`; `endpoint` | Development stability. Set once at exporter startup to the configured ceiling on parallel export requests — not a live worker count; the exporter spawns `min(ceiling, number of requests)` goroutines per batch. The ceiling is `remote_write_queue.num_consumers`, or the literal 5 if the `exporter.prometheusremotewritexporter.EnableMultipleWorkers` feature gate is enabled. `max_batch_request_parallelism` overrides both. A floor of 1 applies last, so `num_consumers: 0` reports 1. Both paths report 5 by default. |
| `otelcol_exporter_prometheusremotewrite_failed_translations` | Sum (monotonic) | `1` | `exporter`; `endpoint` | Development stability. Incremented each time the pmetric-to-Prometheus translation returns an error while batching metrics for export. |
| `otelcol_exporter_prometheusremotewrite_sent_batches` | Sum (monotonic) | `{batch}` | `exporter`; `endpoint` | Development stability. Incremented once per remote-write request batch sent, regardless of the outcome. |
| `otelcol_exporter_prometheusremotewrite_translated_time_series` | Sum (monotonic) | `1` | `exporter`; `endpoint` | Development stability. Incremented by the number of Prometheus time series produced by the OTel-to-Prometheus translation. |
| `otelcol_exporter_prometheusremotewrite_wal_bytes_read` | Sum (monotonic) | `By` | - | Development stability. Only emitted when the `wal` config block is set (write-ahead log enabled). |
| `otelcol_exporter_prometheusremotewrite_wal_bytes_written` | Sum (monotonic) | `By` | - | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_lag` | Gauge | `1` | - | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_read_latency` | Histogram | `ms` | - | Development stability. Only emitted when the `wal` config block is set. Bucket boundaries: 5, 10, 20, 50, 100, 200, 500, 1000, 2000, 5000. |
| `otelcol_exporter_prometheusremotewrite_wal_reads` | Sum (monotonic) | `1` | - | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_reads_failures` | Sum (monotonic) | `1` | - | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_write_latency` | Histogram | `ms` | - | Development stability. Only emitted when the `wal` config block is set. Bucket boundaries: 5, 10, 20, 50, 100, 200, 500, 1000, 2000, 5000. |
| `otelcol_exporter_prometheusremotewrite_wal_writes` | Sum (monotonic) | `1` | - | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_writes_failures` | Sum (monotonic) | `1` | - | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_written_exemplars` | Sum (monotonic) | `{exemplar}` | `exporter`; `endpoint` | Development stability. Only emitted when using Remote Write 2.0 (`exporter.prometheusremotewritexporter.enableSendingRW2` feature gate enabled and `protobuf_message: io.prometheus.write.v2.Request` set on the exporter); read from the `X-Prometheus-Remote-Write-Exemplars-Written` response header. |
| `otelcol_exporter_prometheusremotewrite_written_histograms` | Sum (monotonic) | `{histogram}` | `exporter`; `endpoint` | Development stability. Only emitted when using Remote Write 2.0 (same gate/config as above); read from the `X-Prometheus-Remote-Write-Histograms-Written` response header. |
| `otelcol_exporter_prometheusremotewrite_written_samples` | Sum (monotonic) | `{sample}` | `exporter`; `endpoint` | Development stability. Only emitted when using Remote Write 2.0 (same gate/config as above); read from the `X-Prometheus-Remote-Write-Samples-Written` response header. |

## Sources

- `exporter/prometheusremotewriteexporter/exporter.go`
- `exporter/prometheusremotewriteexporter/exporter_v2.go`
- `exporter/prometheusremotewriteexporter/wal.go`
- `exporter/prometheusremotewriteexporter/config.go`
- `exporter/prometheusremotewriteexporter/metadata.yaml`
- `exporter/prometheusremotewriteexporter/documentation.md`
- `exporter/prometheusremotewriteexporter/internal/metadata/generated_status.go`
        • v0.156.0.md 4.7 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: exporter/prometheusremotewriteexporter
version: v0.156.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/exporter/prometheusremotewriteexporter
commit_sha: 41e24cd516dd69a5b4277465cdb2ff4ef0676f49
last_verified: 2026-09-02
---

# Prometheus Remote Write Exporter

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_exporter_prometheusremotewrite_consumers` | Sum (non-monotonic) | `{consumer}` | `exporter`; `endpoint` | Development stability. Set once at exporter startup to the configured ceiling on parallel export requests — not a live worker count; the exporter spawns `min(ceiling, number of requests)` goroutines per batch. The ceiling is `remote_write_queue.num_consumers`, or the literal 5 if the `exporter.prometheusremotewritexporter.EnableMultipleWorkers` feature gate is enabled. `max_batch_request_parallelism` overrides both. A floor of 1 applies last, so `num_consumers: 0` reports 1. Both paths report 5 by default. |
| `otelcol_exporter_prometheusremotewrite_failed_translations` | Sum (monotonic) | `1` | `exporter`; `endpoint` | Development stability. Incremented each time the pmetric-to-Prometheus translation returns an error while batching metrics for export. |
| `otelcol_exporter_prometheusremotewrite_sent_batches` | Sum (monotonic) | `{batch}` | `exporter`; `endpoint` | Development stability. Incremented once per remote-write request batch sent, regardless of the outcome. |
| `otelcol_exporter_prometheusremotewrite_translated_time_series` | Sum (monotonic) | `1` | `exporter`; `endpoint` | Development stability. Incremented by the number of Prometheus time series produced by the OTel-to-Prometheus translation. |
| `otelcol_exporter_prometheusremotewrite_wal_bytes_read` | Sum (monotonic) | `By` | - | Development stability. Only emitted when the `wal` config block is set (write-ahead log enabled). |
| `otelcol_exporter_prometheusremotewrite_wal_bytes_written` | Sum (monotonic) | `By` | - | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_lag` | Gauge | `1` | - | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_read_latency` | Histogram | `ms` | - | Development stability. Only emitted when the `wal` config block is set. Bucket boundaries: 5, 10, 20, 50, 100, 200, 500, 1000, 2000, 5000. |
| `otelcol_exporter_prometheusremotewrite_wal_reads` | Sum (monotonic) | `1` | - | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_reads_failures` | Sum (monotonic) | `1` | - | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_write_latency` | Histogram | `ms` | - | Development stability. Only emitted when the `wal` config block is set. Bucket boundaries: 5, 10, 20, 50, 100, 200, 500, 1000, 2000, 5000. |
| `otelcol_exporter_prometheusremotewrite_wal_writes` | Sum (monotonic) | `1` | - | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_writes_failures` | Sum (monotonic) | `1` | - | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_written_exemplars` | Sum (monotonic) | `{exemplar}` | `exporter`; `endpoint` | Development stability. Only emitted when using Remote Write 2.0 (`exporter.prometheusremotewritexporter.enableSendingRW2` feature gate enabled and `protobuf_message: io.prometheus.write.v2.Request` set on the exporter); read from the `X-Prometheus-Remote-Write-Exemplars-Written` response header. |
| `otelcol_exporter_prometheusremotewrite_written_histograms` | Sum (monotonic) | `{histogram}` | `exporter`; `endpoint` | Development stability. Only emitted when using Remote Write 2.0 (same gate/config as above); read from the `X-Prometheus-Remote-Write-Histograms-Written` response header. |
| `otelcol_exporter_prometheusremotewrite_written_samples` | Sum (monotonic) | `{sample}` | `exporter`; `endpoint` | Development stability. Only emitted when using Remote Write 2.0 (same gate/config as above); read from the `X-Prometheus-Remote-Write-Samples-Written` response header. |

## Sources

- `exporter/prometheusremotewriteexporter/exporter.go`
- `exporter/prometheusremotewriteexporter/exporter_v2.go`
- `exporter/prometheusremotewriteexporter/wal.go`
- `exporter/prometheusremotewriteexporter/config.go`
- `exporter/prometheusremotewriteexporter/metadata.yaml`
- `exporter/prometheusremotewriteexporter/documentation.md`
- `exporter/prometheusremotewriteexporter/internal/metadata/generated_status.go`
        • v0.157.0.md 4.7 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: exporter/prometheusremotewriteexporter
version: v0.157.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/exporter/prometheusremotewriteexporter
commit_sha: 89e43555904cd97c2d36605347c5d5237b1bdc8c
last_verified: 2026-09-02
---

# Prometheus Remote Write Exporter

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_exporter_prometheusremotewrite_consumers` | Sum (non-monotonic) | `{consumer}` | `exporter`; `endpoint` | Development stability. Set once at exporter startup to the configured ceiling on parallel export requests — not a live worker count; the exporter spawns `min(ceiling, number of requests)` goroutines per batch. The ceiling is `remote_write_queue.num_consumers`, or the literal 5 if the `exporter.prometheusremotewritexporter.EnableMultipleWorkers` feature gate is enabled. `max_batch_request_parallelism` overrides both. A floor of 1 applies last, so `num_consumers: 0` reports 1. Both paths report 5 by default. |
| `otelcol_exporter_prometheusremotewrite_failed_translations` | Sum (monotonic) | `1` | `exporter`; `endpoint` | Development stability. Incremented each time the pmetric-to-Prometheus translation returns an error while batching metrics for export. |
| `otelcol_exporter_prometheusremotewrite_sent_batches` | Sum (monotonic) | `{batch}` | `exporter`; `endpoint` | Development stability. Incremented once per remote-write request batch sent, regardless of the outcome. |
| `otelcol_exporter_prometheusremotewrite_translated_time_series` | Sum (monotonic) | `1` | `exporter`; `endpoint` | Development stability. Incremented by the number of Prometheus time series produced by the OTel-to-Prometheus translation. |
| `otelcol_exporter_prometheusremotewrite_wal_bytes_read` | Sum (monotonic) | `By` | - | Development stability. Only emitted when the `wal` config block is set (write-ahead log enabled). |
| `otelcol_exporter_prometheusremotewrite_wal_bytes_written` | Sum (monotonic) | `By` | - | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_lag` | Gauge | `1` | - | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_read_latency` | Histogram | `ms` | - | Development stability. Only emitted when the `wal` config block is set. Bucket boundaries: 5, 10, 20, 50, 100, 200, 500, 1000, 2000, 5000. |
| `otelcol_exporter_prometheusremotewrite_wal_reads` | Sum (monotonic) | `1` | - | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_reads_failures` | Sum (monotonic) | `1` | - | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_write_latency` | Histogram | `ms` | - | Development stability. Only emitted when the `wal` config block is set. Bucket boundaries: 5, 10, 20, 50, 100, 200, 500, 1000, 2000, 5000. |
| `otelcol_exporter_prometheusremotewrite_wal_writes` | Sum (monotonic) | `1` | - | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_writes_failures` | Sum (monotonic) | `1` | - | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_written_exemplars` | Sum (monotonic) | `{exemplar}` | `exporter`; `endpoint` | Development stability. Only emitted when using Remote Write 2.0 (`exporter.prometheusremotewritexporter.enableSendingRW2` feature gate enabled and `protobuf_message: io.prometheus.write.v2.Request` set on the exporter); read from the `X-Prometheus-Remote-Write-Exemplars-Written` response header. |
| `otelcol_exporter_prometheusremotewrite_written_histograms` | Sum (monotonic) | `{histogram}` | `exporter`; `endpoint` | Development stability. Only emitted when using Remote Write 2.0 (same gate/config as above); read from the `X-Prometheus-Remote-Write-Histograms-Written` response header. |
| `otelcol_exporter_prometheusremotewrite_written_samples` | Sum (monotonic) | `{sample}` | `exporter`; `endpoint` | Development stability. Only emitted when using Remote Write 2.0 (same gate/config as above); read from the `X-Prometheus-Remote-Write-Samples-Written` response header. |

## Sources

- `exporter/prometheusremotewriteexporter/exporter.go`
- `exporter/prometheusremotewriteexporter/exporter_v2.go`
- `exporter/prometheusremotewriteexporter/wal.go`
- `exporter/prometheusremotewriteexporter/config.go`
- `exporter/prometheusremotewriteexporter/metadata.yaml`
- `exporter/prometheusremotewriteexporter/documentation.md`
- `exporter/prometheusremotewriteexporter/internal/metadata/generated_status.go`
        • v0.158.0.md 4.7 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: exporter/prometheusremotewriteexporter
version: v0.158.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/exporter/prometheusremotewriteexporter
commit_sha: 821a9d9c2c1623c4a0ceba5d47b57c48879c3f84
last_verified: 2026-09-02
---

# Prometheus Remote Write Exporter

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_exporter_prometheusremotewrite_consumers` | Sum (non-monotonic) | `{consumer}` | `exporter`; `endpoint` | Development stability. Set once at exporter startup to the configured ceiling on parallel export requests — not a live worker count; the exporter spawns `min(ceiling, number of requests)` goroutines per batch. The ceiling is `remote_write_queue.num_consumers`, or the literal 5 if the `exporter.prometheusremotewritexporter.EnableMultipleWorkers` feature gate is enabled. `max_batch_request_parallelism` overrides both. A floor of 1 applies last, so `num_consumers: 0` reports 1. Both paths report 5 by default. |
| `otelcol_exporter_prometheusremotewrite_failed_translations` | Sum (monotonic) | `1` | `exporter`; `endpoint` | Development stability. Incremented each time the pmetric-to-Prometheus translation returns an error while batching metrics for export. |
| `otelcol_exporter_prometheusremotewrite_sent_batches` | Sum (monotonic) | `{batch}` | `exporter`; `endpoint` | Development stability. Incremented once per remote-write request batch sent, regardless of the outcome. |
| `otelcol_exporter_prometheusremotewrite_translated_time_series` | Sum (monotonic) | `1` | `exporter`; `endpoint` | Development stability. Incremented by the number of Prometheus time series produced by the OTel-to-Prometheus translation. |
| `otelcol_exporter_prometheusremotewrite_wal_bytes_read` | Sum (monotonic) | `By` | - | Development stability. Only emitted when the `wal` config block is set (write-ahead log enabled). |
| `otelcol_exporter_prometheusremotewrite_wal_bytes_written` | Sum (monotonic) | `By` | - | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_lag` | Gauge | `1` | - | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_read_latency` | Histogram | `ms` | - | Development stability. Only emitted when the `wal` config block is set. Bucket boundaries: 5, 10, 20, 50, 100, 200, 500, 1000, 2000, 5000. |
| `otelcol_exporter_prometheusremotewrite_wal_reads` | Sum (monotonic) | `1` | - | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_reads_failures` | Sum (monotonic) | `1` | - | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_write_latency` | Histogram | `ms` | - | Development stability. Only emitted when the `wal` config block is set. Bucket boundaries: 5, 10, 20, 50, 100, 200, 500, 1000, 2000, 5000. |
| `otelcol_exporter_prometheusremotewrite_wal_writes` | Sum (monotonic) | `1` | - | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_writes_failures` | Sum (monotonic) | `1` | - | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_written_exemplars` | Sum (monotonic) | `{exemplar}` | `exporter`; `endpoint` | Development stability. Only emitted when using Remote Write 2.0 (`exporter.prometheusremotewritexporter.enableSendingRW2` feature gate enabled and `protobuf_message: io.prometheus.write.v2.Request` set on the exporter); read from the `X-Prometheus-Remote-Write-Exemplars-Written` response header. |
| `otelcol_exporter_prometheusremotewrite_written_histograms` | Sum (monotonic) | `{histogram}` | `exporter`; `endpoint` | Development stability. Only emitted when using Remote Write 2.0 (same gate/config as above); read from the `X-Prometheus-Remote-Write-Histograms-Written` response header. |
| `otelcol_exporter_prometheusremotewrite_written_samples` | Sum (monotonic) | `{sample}` | `exporter`; `endpoint` | Development stability. Only emitted when using Remote Write 2.0 (same gate/config as above); read from the `X-Prometheus-Remote-Write-Samples-Written` response header. |

## Sources

- `exporter/prometheusremotewriteexporter/exporter.go`
- `exporter/prometheusremotewriteexporter/exporter_v2.go`
- `exporter/prometheusremotewriteexporter/wal.go`
- `exporter/prometheusremotewriteexporter/config.go`
- `exporter/prometheusremotewriteexporter/metadata.yaml`
- `exporter/prometheusremotewriteexporter/documentation.md`
- `exporter/prometheusremotewriteexporter/internal/metadata/generated_status.go`
        • v0.159.0.md 5.7 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: exporter/prometheusremotewriteexporter
version: v0.159.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/exporter/prometheusremotewriteexporter
commit_sha: 1120cc0714bf4d14600105e5673c3b00fe87467a
last_verified: 2026-09-02
---

# Prometheus Remote Write Exporter

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_exporter_prometheusremotewrite_consumers` | Sum (non-monotonic) | `{consumer}` | `exporter`; `endpoint` | Development stability. Set once at exporter startup to the configured ceiling on parallel export requests — not a live worker count; the exporter spawns `min(ceiling, number of requests)` goroutines per batch. The ceiling is `remote_write_queue.num_consumers`, or the literal 5 if the `exporter.prometheusremotewritexporter.EnableMultipleWorkers` feature gate is enabled. `max_batch_request_parallelism` overrides both. A floor of 1 applies last, so `num_consumers: 0` reports 1. Both paths report 5 by default. |
| `otelcol_exporter_prometheusremotewrite_failed_translations` | Sum (monotonic) | `1` | `exporter`; `endpoint` | Development stability. Incremented each time the pmetric-to-Prometheus translation returns an error while batching metrics for export. |
| `otelcol_exporter_prometheusremotewrite_sent_batches` | Sum (monotonic) | `{batch}` | `exporter`; `endpoint` | Development stability. Incremented once per remote-write request batch sent, regardless of the outcome. |
| `otelcol_exporter_prometheusremotewrite_translated_time_series` | Sum (monotonic) | `1` | `exporter`; `endpoint` | Development stability. Incremented by the number of Prometheus time series produced by the OTel-to-Prometheus translation. |
| `otelcol_exporter_prometheusremotewrite_wal_bytes_read` | Sum (monotonic) | `By` | `exporter` | Development stability. Only emitted when the `wal` config block is set (write-ahead log enabled). New in v0.159.0: the `exporter` attribute is added; earlier versions emit this metric with no attributes. |
| `otelcol_exporter_prometheusremotewrite_wal_bytes_written` | Sum (monotonic) | `By` | `exporter` | Development stability. Only emitted when the `wal` config block is set. New in v0.159.0: the `exporter` attribute is added; earlier versions emit this metric with no attributes. |
| `otelcol_exporter_prometheusremotewrite_wal_lag` | Gauge | `1` | `exporter` | Development stability. Only emitted when the `wal` config block is set. New in v0.159.0: the `exporter` attribute is added; earlier versions emit this metric with no attributes. |
| `otelcol_exporter_prometheusremotewrite_wal_read_latency` | Histogram | `ms` | `exporter` | Development stability. Only emitted when the `wal` config block is set. Bucket boundaries: 5, 10, 20, 50, 100, 200, 500, 1000, 2000, 5000. New in v0.159.0: the `exporter` attribute is added; earlier versions emit this metric with no attributes. |
| `otelcol_exporter_prometheusremotewrite_wal_reads` | Sum (monotonic) | `1` | `exporter` | Development stability. Only emitted when the `wal` config block is set. New in v0.159.0: the `exporter` attribute is added; earlier versions emit this metric with no attributes. |
| `otelcol_exporter_prometheusremotewrite_wal_reads_failures` | Sum (monotonic) | `1` | `exporter` | Development stability. Only emitted when the `wal` config block is set. New in v0.159.0: the `exporter` attribute is added; earlier versions emit this metric with no attributes. |
| `otelcol_exporter_prometheusremotewrite_wal_write_latency` | Histogram | `ms` | `exporter` | Development stability. Only emitted when the `wal` config block is set. Bucket boundaries: 5, 10, 20, 50, 100, 200, 500, 1000, 2000, 5000. New in v0.159.0: the `exporter` attribute is added; earlier versions emit this metric with no attributes. |
| `otelcol_exporter_prometheusremotewrite_wal_writes` | Sum (monotonic) | `1` | `exporter` | Development stability. Only emitted when the `wal` config block is set. New in v0.159.0: the `exporter` attribute is added; earlier versions emit this metric with no attributes. |
| `otelcol_exporter_prometheusremotewrite_wal_writes_failures` | Sum (monotonic) | `1` | `exporter` | Development stability. Only emitted when the `wal` config block is set. New in v0.159.0: the `exporter` attribute is added; earlier versions emit this metric with no attributes. |
| `otelcol_exporter_prometheusremotewrite_written_exemplars` | Sum (monotonic) | `{exemplar}` | `exporter`; `endpoint` | Development stability. Only emitted when using Remote Write 2.0 (`exporter.prometheusremotewritexporter.enableSendingRW2` feature gate enabled and `protobuf_message: io.prometheus.write.v2.Request` set on the exporter); read from the `X-Prometheus-Remote-Write-Exemplars-Written` response header. |
| `otelcol_exporter_prometheusremotewrite_written_histograms` | Sum (monotonic) | `{histogram}` | `exporter`; `endpoint` | Development stability. Only emitted when using Remote Write 2.0 (same gate/config as above); read from the `X-Prometheus-Remote-Write-Histograms-Written` response header. |
| `otelcol_exporter_prometheusremotewrite_written_samples` | Sum (monotonic) | `{sample}` | `exporter`; `endpoint` | Development stability. Only emitted when using Remote Write 2.0 (same gate/config as above); read from the `X-Prometheus-Remote-Write-Samples-Written` response header. |

## Sources

- `exporter/prometheusremotewriteexporter/exporter.go`
- `exporter/prometheusremotewriteexporter/exporter_v2.go`
- `exporter/prometheusremotewriteexporter/wal.go`
- `exporter/prometheusremotewriteexporter/config.go`
- `exporter/prometheusremotewriteexporter/metadata.yaml`
- `exporter/prometheusremotewriteexporter/documentation.md`
- `exporter/prometheusremotewriteexporter/internal/metadata/generated_status.go`
        • v0.160.0.md 4.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: exporter/prometheusremotewriteexporter
version: v0.160.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/exporter/prometheusremotewriteexporter
commit_sha: 982f20b8a8e8a2569fab3e27cf8b008e8a5080c1
last_verified: 2026-09-05
---

# Prometheus Remote Write Exporter

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_exporter_prometheusremotewrite_consumers` | Sum (non-monotonic) | `{consumer}` | `exporter`; `endpoint` | Development stability. Set once at exporter startup to the configured ceiling on parallel export requests — not a live worker count; the exporter spawns `min(ceiling, number of requests)` goroutines per batch. The ceiling is `remote_write_queue.num_consumers`, or the literal 5 if the `exporter.prometheusremotewritexporter.EnableMultipleWorkers` feature gate is enabled. `max_batch_request_parallelism` overrides both. A floor of 1 applies last, so `num_consumers: 0` reports 1. Both paths report 5 by default. |
| `otelcol_exporter_prometheusremotewrite_failed_translations` | Sum (monotonic) | `1` | `exporter`; `endpoint` | Development stability. Incremented each time the pmetric-to-Prometheus translation returns an error while batching metrics for export. |
| `otelcol_exporter_prometheusremotewrite_sent_batches` | Sum (monotonic) | `{batch}` | `exporter`; `endpoint` | Development stability. Incremented once per remote-write request batch sent, regardless of the outcome. |
| `otelcol_exporter_prometheusremotewrite_translated_time_series` | Sum (monotonic) | `1` | `exporter`; `endpoint` | Development stability. Incremented by the number of Prometheus time series produced by the OTel-to-Prometheus translation. |
| `otelcol_exporter_prometheusremotewrite_wal_bytes_read` | Sum (monotonic) | `By` | `exporter` | Development stability. Only emitted when the `wal` config block is set (write-ahead log enabled). |
| `otelcol_exporter_prometheusremotewrite_wal_bytes_written` | Sum (monotonic) | `By` | `exporter` | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_lag` | Gauge | `1` | `exporter` | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_read_latency` | Histogram | `ms` | `exporter` | Development stability. Only emitted when the `wal` config block is set. Bucket boundaries: 5, 10, 20, 50, 100, 200, 500, 1000, 2000, 5000. |
| `otelcol_exporter_prometheusremotewrite_wal_reads` | Sum (monotonic) | `1` | `exporter` | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_reads_failures` | Sum (monotonic) | `1` | `exporter` | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_write_latency` | Histogram | `ms` | `exporter` | Development stability. Only emitted when the `wal` config block is set. Bucket boundaries: 5, 10, 20, 50, 100, 200, 500, 1000, 2000, 5000. |
| `otelcol_exporter_prometheusremotewrite_wal_writes` | Sum (monotonic) | `1` | `exporter` | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_writes_failures` | Sum (monotonic) | `1` | `exporter` | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_written_exemplars` | Sum (monotonic) | `{exemplar}` | `exporter`; `endpoint` | Development stability. Only emitted when using Remote Write 2.0 (`exporter.prometheusremotewritexporter.enableSendingRW2` feature gate enabled and `protobuf_message: io.prometheus.write.v2.Request` set on the exporter); read from the `X-Prometheus-Remote-Write-Exemplars-Written` response header. |
| `otelcol_exporter_prometheusremotewrite_written_histograms` | Sum (monotonic) | `{histogram}` | `exporter`; `endpoint` | Development stability. Only emitted when using Remote Write 2.0 (same gate/config as above); read from the `X-Prometheus-Remote-Write-Histograms-Written` response header. |
| `otelcol_exporter_prometheusremotewrite_written_samples` | Sum (monotonic) | `{sample}` | `exporter`; `endpoint` | Development stability. Only emitted when using Remote Write 2.0 (same gate/config as above); read from the `X-Prometheus-Remote-Write-Samples-Written` response header. |

## Sources

- `exporter/prometheusremotewriteexporter/exporter.go`
- `exporter/prometheusremotewriteexporter/exporter_v2.go`
- `exporter/prometheusremotewriteexporter/wal.go`
- `exporter/prometheusremotewriteexporter/config.go`
- `exporter/prometheusremotewriteexporter/metadata.yaml`
- `exporter/prometheusremotewriteexporter/documentation.md`
- `exporter/prometheusremotewriteexporter/internal/metadata/generated_status.go`
- `exporter/prometheusremotewriteexporter/internal/metadata/generated_feature_gates.go`
        • v0.161.0.md 4.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: exporter/prometheusremotewriteexporter
version: v0.161.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/exporter/prometheusremotewriteexporter
commit_sha: 3f8455d8038a985398861171e5310bc9b4e988b2
last_verified: 2026-10-03
---

# Prometheus Remote Write Exporter

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_exporter_prometheusremotewrite_consumers` | Sum (non-monotonic) | `{consumer}` | `exporter`; `endpoint` | Development stability. Set once at exporter startup to the configured ceiling on parallel export requests — not a live worker count; the exporter spawns `min(ceiling, number of requests)` goroutines per batch. The ceiling is `remote_write_queue.num_consumers`, or the literal 5 if the `exporter.prometheusremotewritexporter.EnableMultipleWorkers` feature gate is enabled. `max_batch_request_parallelism` overrides both. A floor of 1 applies last, so `num_consumers: 0` reports 1 when the gate is disabled and `max_batch_request_parallelism` is unset. Both paths report 5 by default. |
| `otelcol_exporter_prometheusremotewrite_failed_translations` | Sum (monotonic) | `1` | `exporter`; `endpoint` | Development stability. Incremented each time the pmetric-to-Prometheus translation returns an error while batching metrics for export. |
| `otelcol_exporter_prometheusremotewrite_sent_batches` | Sum (monotonic) | `{batch}` | `exporter`; `endpoint` | Development stability. Incremented once per remote-write request batch sent, regardless of the outcome. |
| `otelcol_exporter_prometheusremotewrite_translated_time_series` | Sum (monotonic) | `1` | `exporter`; `endpoint` | Development stability. Incremented by the number of Prometheus time series produced by the OTel-to-Prometheus translation. |
| `otelcol_exporter_prometheusremotewrite_wal_bytes_read` | Sum (monotonic) | `By` | `exporter` | Development stability. Only emitted when the `wal` config block is set (write-ahead log enabled). |
| `otelcol_exporter_prometheusremotewrite_wal_bytes_written` | Sum (monotonic) | `By` | `exporter` | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_lag` | Gauge | `1` | `exporter` | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_read_latency` | Histogram | `ms` | `exporter` | Development stability. Only emitted when the `wal` config block is set. Bucket boundaries: 5, 10, 20, 50, 100, 200, 500, 1000, 2000, 5000. |
| `otelcol_exporter_prometheusremotewrite_wal_reads` | Sum (monotonic) | `1` | `exporter` | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_reads_failures` | Sum (monotonic) | `1` | `exporter` | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_write_latency` | Histogram | `ms` | `exporter` | Development stability. Only emitted when the `wal` config block is set. Bucket boundaries: 5, 10, 20, 50, 100, 200, 500, 1000, 2000, 5000. |
| `otelcol_exporter_prometheusremotewrite_wal_writes` | Sum (monotonic) | `1` | `exporter` | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_writes_failures` | Sum (monotonic) | `1` | `exporter` | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_written_exemplars` | Sum (monotonic) | `{exemplar}` | `exporter`; `endpoint` | Development stability. Only emitted when using Remote Write 2.0 (`exporter.prometheusremotewritexporter.enableSendingRW2` feature gate enabled and `protobuf_message: io.prometheus.write.v2.Request` set on the exporter); read from the `X-Prometheus-Remote-Write-Exemplars-Written` response header. |
| `otelcol_exporter_prometheusremotewrite_written_histograms` | Sum (monotonic) | `{histogram}` | `exporter`; `endpoint` | Development stability. Only emitted when using Remote Write 2.0 (same gate/config as above); read from the `X-Prometheus-Remote-Write-Histograms-Written` response header. |
| `otelcol_exporter_prometheusremotewrite_written_samples` | Sum (monotonic) | `{sample}` | `exporter`; `endpoint` | Development stability. Only emitted when using Remote Write 2.0 (same gate/config as above); read from the `X-Prometheus-Remote-Write-Samples-Written` response header. |

## Sources

- `exporter/prometheusremotewriteexporter/exporter.go`
- `exporter/prometheusremotewriteexporter/exporter_v2.go`
- `exporter/prometheusremotewriteexporter/wal.go`
- `exporter/prometheusremotewriteexporter/config.go`
- `exporter/prometheusremotewriteexporter/metadata.yaml`
- `exporter/prometheusremotewriteexporter/documentation.md`
- `exporter/prometheusremotewriteexporter/internal/metadata/generated_status.go`
- `exporter/prometheusremotewriteexporter/internal/metadata/generated_feature_gates.go`
        • v0.162.0.md 4.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: exporter/prometheusremotewriteexporter
version: v0.162.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/exporter/prometheusremotewriteexporter
commit_sha: ae8c507510f48f433ab47dd1c6b01a59d6c388b5
last_verified: 2026-10-03
---

# Prometheus Remote Write Exporter

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_exporter_prometheusremotewrite_consumers` | Sum (non-monotonic) | `{consumer}` | `exporter`; `endpoint` | Development stability. Set once at exporter startup to the configured ceiling on parallel export requests — not a live worker count; the exporter spawns `min(ceiling, number of requests)` goroutines per batch. The ceiling is `remote_write_queue.num_consumers`, or the literal 5 if the `exporter.prometheusremotewritexporter.EnableMultipleWorkers` feature gate is enabled. `max_batch_request_parallelism` overrides both. A floor of 1 applies last, so `num_consumers: 0` reports 1. Both paths report 5 by default. |
| `otelcol_exporter_prometheusremotewrite_failed_translations` | Sum (monotonic) | `1` | `exporter`; `endpoint` | Development stability. Incremented each time the pmetric-to-Prometheus translation returns an error while batching metrics for export. |
| `otelcol_exporter_prometheusremotewrite_sent_batches` | Sum (monotonic) | `{batch}` | `exporter`; `endpoint` | Development stability. Incremented once per remote-write request batch sent, regardless of the outcome. |
| `otelcol_exporter_prometheusremotewrite_translated_time_series` | Sum (monotonic) | `1` | `exporter`; `endpoint` | Development stability. Incremented by the number of Prometheus time series produced by the OTel-to-Prometheus translation. |
| `otelcol_exporter_prometheusremotewrite_wal_bytes_read` | Sum (monotonic) | `By` | `exporter` | Development stability. Only emitted when the `wal` config block is set (write-ahead log enabled). |
| `otelcol_exporter_prometheusremotewrite_wal_bytes_written` | Sum (monotonic) | `By` | `exporter` | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_lag` | Gauge | `1` | `exporter` | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_read_latency` | Histogram | `ms` | `exporter` | Development stability. Only emitted when the `wal` config block is set. Bucket boundaries: 5, 10, 20, 50, 100, 200, 500, 1000, 2000, 5000. |
| `otelcol_exporter_prometheusremotewrite_wal_reads` | Sum (monotonic) | `1` | `exporter` | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_reads_failures` | Sum (monotonic) | `1` | `exporter` | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_write_latency` | Histogram | `ms` | `exporter` | Development stability. Only emitted when the `wal` config block is set. Bucket boundaries: 5, 10, 20, 50, 100, 200, 500, 1000, 2000, 5000. |
| `otelcol_exporter_prometheusremotewrite_wal_writes` | Sum (monotonic) | `1` | `exporter` | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_wal_writes_failures` | Sum (monotonic) | `1` | `exporter` | Development stability. Only emitted when the `wal` config block is set. |
| `otelcol_exporter_prometheusremotewrite_written_exemplars` | Sum (monotonic) | `{exemplar}` | `exporter`; `endpoint` | Development stability. Only emitted when using Remote Write 2.0 (`exporter.prometheusremotewritexporter.enableSendingRW2` feature gate enabled and `protobuf_message: io.prometheus.write.v2.Request` set on the exporter); read from the `X-Prometheus-Remote-Write-Exemplars-Written` response header. |
| `otelcol_exporter_prometheusremotewrite_written_histograms` | Sum (monotonic) | `{histogram}` | `exporter`; `endpoint` | Development stability. Only emitted when using Remote Write 2.0 (same gate/config as above); read from the `X-Prometheus-Remote-Write-Histograms-Written` response header. |
| `otelcol_exporter_prometheusremotewrite_written_samples` | Sum (monotonic) | `{sample}` | `exporter`; `endpoint` | Development stability. Only emitted when using Remote Write 2.0 (same gate/config as above); read from the `X-Prometheus-Remote-Write-Samples-Written` response header. |

## Sources

- `exporter/prometheusremotewriteexporter/exporter.go`
- `exporter/prometheusremotewriteexporter/exporter_v2.go`
- `exporter/prometheusremotewriteexporter/wal.go`
- `exporter/prometheusremotewriteexporter/config.go`
- `exporter/prometheusremotewriteexporter/metadata.yaml`
- `exporter/prometheusremotewriteexporter/documentation.md`
- `exporter/prometheusremotewriteexporter/internal/metadata/generated_status.go`
- `exporter/prometheusremotewriteexporter/internal/metadata/generated_feature_gates.go`
        • v0.163.0.md 2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: exporter/prometheusremotewriteexporter
version: v0.163.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/exporter/prometheusremotewriteexporter
commit_sha: df849b5403c041d5e799e7846392a6f18b0b55ae
last_verified: null
---

# Prometheus Remote Write Exporter

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| exporter_prometheusremotewrite_consumers | Sum (int, non-monotonic) | {consumer} | - | - |
| exporter_prometheusremotewrite_failed_translations | Sum (int, monotonic) | 1 | - | - |
| exporter_prometheusremotewrite_sent_batches | Sum (int, monotonic) | {batch} | - | - |
| exporter_prometheusremotewrite_translated_time_series | Sum (int, monotonic) | 1 | - | - |
| exporter_prometheusremotewrite_wal_bytes_read | Sum (int, monotonic) | By | - | - |
| exporter_prometheusremotewrite_wal_bytes_written | Sum (int, monotonic) | By | - | - |
| exporter_prometheusremotewrite_wal_lag | Gauge (int) | 1 | - | - |
| exporter_prometheusremotewrite_wal_read_latency | Histogram (int) | ms | - | - |
| exporter_prometheusremotewrite_wal_reads | Sum (int, monotonic) | 1 | - | - |
| exporter_prometheusremotewrite_wal_reads_failures | Sum (int, monotonic) | 1 | - | - |
| exporter_prometheusremotewrite_wal_write_latency | Histogram (int) | ms | - | - |
| exporter_prometheusremotewrite_wal_writes | Sum (int, monotonic) | 1 | - | - |
| exporter_prometheusremotewrite_wal_writes_failures | Sum (int, monotonic) | 1 | - | - |
| exporter_prometheusremotewrite_written_exemplars | Sum (int, monotonic) | {exemplar} | - | Only available with remote write v2 |
| exporter_prometheusremotewrite_written_histograms | Sum (int, monotonic) | {histogram} | - | Only available with remote write v2 |
| exporter_prometheusremotewrite_written_samples | Sum (int, monotonic) | {sample} | - | Only available with remote write v2 |

## Sources

- `exporter/prometheusremotewriteexporter/metadata.yaml`
- `exporter/prometheusremotewriteexporter/internal/metadata/generated_status.go`
    • processor
      • filterprocessor
        • v0.153.0.md 1 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/filterprocessor
version: v0.153.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/filterprocessor
commit_sha: 42f949127580c0d00088b785cd0b35842dc0ddb8
last_verified: 2026-08-11
---
# Filter Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_filter_datapoints.filtered` | Counter | `1` | `filter` | - |
| `otelcol_processor_filter_logs.filtered` | Counter | `1` | `filter` | - |
| `otelcol_processor_filter_profiles.filtered` | Counter | `1` | `filter` | - |
| `otelcol_processor_filter_spans.filtered` | Counter | `1` | `filter` | - |

## Sources

- `processor/filterprocessor/metadata.yaml`
- `processor/filterprocessor/internal/metadata/generated_telemetry.go`
- `processor/filterprocessor/telemetry.go`
- `processor/filterprocessor/metrics.go`
- `processor/filterprocessor/logs.go`
- `processor/filterprocessor/traces.go`
- `processor/filterprocessor/profiles.go`
        • v0.154.0.md 1 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/filterprocessor
version: v0.154.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/filterprocessor
commit_sha: 853eda0e12b3ba142552ecd2b63cec07062904f0
last_verified: 2026-08-11
---
# Filter Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_filter_datapoints.filtered` | Counter | `1` | `filter` | - |
| `otelcol_processor_filter_logs.filtered` | Counter | `1` | `filter` | - |
| `otelcol_processor_filter_profiles.filtered` | Counter | `1` | `filter` | - |
| `otelcol_processor_filter_spans.filtered` | Counter | `1` | `filter` | - |

## Sources

- `processor/filterprocessor/metadata.yaml`
- `processor/filterprocessor/internal/metadata/generated_telemetry.go`
- `processor/filterprocessor/telemetry.go`
- `processor/filterprocessor/metrics.go`
- `processor/filterprocessor/logs.go`
- `processor/filterprocessor/traces.go`
- `processor/filterprocessor/profiles.go`
        • v0.155.0.md 1 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/filterprocessor
version: v0.155.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/filterprocessor
commit_sha: aaf5045a24c0a6f000225c97ad5449e69aeb5835
last_verified: 2026-08-11
---
# Filter Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_filter_datapoints.filtered` | Counter | `1` | `filter` | - |
| `otelcol_processor_filter_logs.filtered` | Counter | `1` | `filter` | - |
| `otelcol_processor_filter_profiles.filtered` | Counter | `1` | `filter` | - |
| `otelcol_processor_filter_spans.filtered` | Counter | `1` | `filter` | - |

## Sources

- `processor/filterprocessor/metadata.yaml`
- `processor/filterprocessor/internal/metadata/generated_telemetry.go`
- `processor/filterprocessor/telemetry.go`
- `processor/filterprocessor/metrics.go`
- `processor/filterprocessor/logs.go`
- `processor/filterprocessor/traces.go`
- `processor/filterprocessor/profiles.go`
        • v0.156.0.md 1 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/filterprocessor
version: v0.156.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/filterprocessor
commit_sha: 41e24cd516dd69a5b4277465cdb2ff4ef0676f49
last_verified: 2026-08-11
---
# Filter Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_filter_datapoints.filtered` | Counter | `1` | `filter` | - |
| `otelcol_processor_filter_logs.filtered` | Counter | `1` | `filter` | - |
| `otelcol_processor_filter_profiles.filtered` | Counter | `1` | `filter` | - |
| `otelcol_processor_filter_spans.filtered` | Counter | `1` | `filter` | - |

## Sources

- `processor/filterprocessor/metadata.yaml`
- `processor/filterprocessor/internal/metadata/generated_telemetry.go`
- `processor/filterprocessor/telemetry.go`
- `processor/filterprocessor/metrics.go`
- `processor/filterprocessor/logs.go`
- `processor/filterprocessor/traces.go`
- `processor/filterprocessor/profiles.go`
        • v0.157.0.md 1 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/filterprocessor
version: v0.157.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/filterprocessor
commit_sha: 89e43555904cd97c2d36605347c5d5237b1bdc8c
last_verified: 2026-08-11
---
# Filter Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_filter_datapoints.filtered` | Counter | `1` | `filter` | - |
| `otelcol_processor_filter_logs.filtered` | Counter | `1` | `filter` | - |
| `otelcol_processor_filter_profiles.filtered` | Counter | `1` | `filter` | - |
| `otelcol_processor_filter_spans.filtered` | Counter | `1` | `filter` | - |

## Sources

- `processor/filterprocessor/metadata.yaml`
- `processor/filterprocessor/internal/metadata/generated_telemetry.go`
- `processor/filterprocessor/telemetry.go`
- `processor/filterprocessor/metrics.go`
- `processor/filterprocessor/logs.go`
- `processor/filterprocessor/traces.go`
- `processor/filterprocessor/profiles.go`
        • v0.158.0.md 1 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/filterprocessor
version: v0.158.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/filterprocessor
commit_sha: 821a9d9c2c1623c4a0ceba5d47b57c48879c3f84
last_verified: 2026-08-11
---
# Filter Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_filter_datapoints.filtered` | Counter | `1` | `filter` | - |
| `otelcol_processor_filter_logs.filtered` | Counter | `1` | `filter` | - |
| `otelcol_processor_filter_profiles.filtered` | Counter | `1` | `filter` | - |
| `otelcol_processor_filter_spans.filtered` | Counter | `1` | `filter` | - |

## Sources

- `processor/filterprocessor/metadata.yaml`
- `processor/filterprocessor/internal/metadata/generated_telemetry.go`
- `processor/filterprocessor/telemetry.go`
- `processor/filterprocessor/metrics.go`
- `processor/filterprocessor/logs.go`
- `processor/filterprocessor/traces.go`
- `processor/filterprocessor/profiles.go`
        • v0.159.0.md 908 B 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/filterprocessor
version: v0.159.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/filterprocessor
commit_sha: 1120cc0714bf4d14600105e5673c3b00fe87467a
last_verified: null
---

# Filter Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_filter_datapoints.filtered` | Counter (int64) | 1 | `processor` | - |
| `otelcol_processor_filter_logs.filtered` | Counter (int64) | 1 | `processor` | - |
| `otelcol_processor_filter_profiles.filtered` | Counter (int64) | 1 | `processor` | - |
| `otelcol_processor_filter_spans.filtered` | Counter (int64) | 1 | `processor` | - |

## Sources

- `processor/filterprocessor/metadata.yaml`
- `processor/filterprocessor/telemetry.go`
- `processor/filterprocessor/internal/metadata/generated_telemetry.go`
        • v0.160.0.md 1 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/filterprocessor
version: v0.160.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/filterprocessor
commit_sha: 982f20b8a8e8a2569fab3e27cf8b008e8a5080c1
last_verified: 2026-09-03
---
# Filter Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_filter_datapoints.filtered` | Counter | `1` | `filter` | - |
| `otelcol_processor_filter_logs.filtered` | Counter | `1` | `filter` | - |
| `otelcol_processor_filter_profiles.filtered` | Counter | `1` | `filter` | - |
| `otelcol_processor_filter_spans.filtered` | Counter | `1` | `filter` | - |

## Sources

- `processor/filterprocessor/metadata.yaml`
- `processor/filterprocessor/internal/metadata/generated_telemetry.go`
- `processor/filterprocessor/telemetry.go`
- `processor/filterprocessor/metrics.go`
- `processor/filterprocessor/logs.go`
- `processor/filterprocessor/traces.go`
- `processor/filterprocessor/profiles.go`
        • v0.161.0.md 1 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/filterprocessor
version: v0.161.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/filterprocessor
commit_sha: 3f8455d8038a985398861171e5310bc9b4e988b2
last_verified: 2026-10-03
---
# Filter Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_filter_datapoints.filtered` | Counter | `1` | `filter` | - |
| `otelcol_processor_filter_logs.filtered` | Counter | `1` | `filter` | - |
| `otelcol_processor_filter_profiles.filtered` | Counter | `1` | `filter` | - |
| `otelcol_processor_filter_spans.filtered` | Counter | `1` | `filter` | - |

## Sources

- `processor/filterprocessor/metadata.yaml`
- `processor/filterprocessor/internal/metadata/generated_telemetry.go`
- `processor/filterprocessor/telemetry.go`
- `processor/filterprocessor/metrics.go`
- `processor/filterprocessor/logs.go`
- `processor/filterprocessor/traces.go`
- `processor/filterprocessor/profiles.go`
        • v0.162.0.md 1 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/filterprocessor
version: v0.162.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/filterprocessor
commit_sha: ae8c507510f48f433ab47dd1c6b01a59d6c388b5
last_verified: 2026-10-03
---
# Filter Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_filter_datapoints.filtered` | Counter | `1` | `filter` | - |
| `otelcol_processor_filter_logs.filtered` | Counter | `1` | `filter` | - |
| `otelcol_processor_filter_profiles.filtered` | Counter | `1` | `filter` | - |
| `otelcol_processor_filter_spans.filtered` | Counter | `1` | `filter` | - |

## Sources

- `processor/filterprocessor/metadata.yaml`
- `processor/filterprocessor/internal/metadata/generated_telemetry.go`
- `processor/filterprocessor/telemetry.go`
- `processor/filterprocessor/metrics.go`
- `processor/filterprocessor/logs.go`
- `processor/filterprocessor/traces.go`
- `processor/filterprocessor/profiles.go`
        • v0.163.0.md 908 B 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/filterprocessor
version: v0.163.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/filterprocessor
commit_sha: df849b5403c041d5e799e7846392a6f18b0b55ae
last_verified: null
---

# Filter Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_filter_datapoints.filtered` | Counter (int64) | 1 | `processor` | - |
| `otelcol_processor_filter_logs.filtered` | Counter (int64) | 1 | `processor` | - |
| `otelcol_processor_filter_profiles.filtered` | Counter (int64) | 1 | `processor` | - |
| `otelcol_processor_filter_spans.filtered` | Counter (int64) | 1 | `processor` | - |

## Sources

- `processor/filterprocessor/metadata.yaml`
- `processor/filterprocessor/telemetry.go`
- `processor/filterprocessor/internal/metadata/generated_telemetry.go`
      • k8sattributesprocessor
        • v0.153.0.md 8.3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/k8sattributesprocessor
version: v0.153.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/k8sattributesprocessor
commit_sha: 42f949127580c0d00088b785cd0b35842dc0ddb8
last_verified: 2026-08-11
---
# Kubernetes Attributes Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol.k8s.pod.association` | Counter | `{resources}` | `status`, `pod_identifier`, `otelcol.signal` | - |
| `otelcol.k8s.watcher.daemonset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.daemonset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.daemonset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod_cache.size` | Gauge | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_ip_lookup_miss` | Counter | `1` | - | Deprecated; emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_table_size` | Gauge | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |

## Sources

- `processor/k8sattributesprocessor/metadata.yaml`
- `processor/k8sattributesprocessor/internal/metadata/generated_telemetry.go`
- `processor/k8sattributesprocessor/internal/kube/client.go`
- `processor/k8sattributesprocessor/processor.go`
        • v0.154.0.md 8.3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/k8sattributesprocessor
version: v0.154.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/k8sattributesprocessor
commit_sha: 853eda0e12b3ba142552ecd2b63cec07062904f0
last_verified: 2026-08-11
---
# Kubernetes Attributes Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol.k8s.pod.association` | Counter | `{resources}` | `status`, `pod_identifier`, `otelcol.signal` | - |
| `otelcol.k8s.watcher.daemonset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.daemonset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.daemonset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod_cache.size` | Gauge | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_ip_lookup_miss` | Counter | `1` | - | Deprecated; emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_table_size` | Gauge | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |

## Sources

- `processor/k8sattributesprocessor/metadata.yaml`
- `processor/k8sattributesprocessor/internal/metadata/generated_telemetry.go`
- `processor/k8sattributesprocessor/internal/kube/client.go`
- `processor/k8sattributesprocessor/processor.go`
        • v0.155.0.md 8.3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/k8sattributesprocessor
version: v0.155.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/k8sattributesprocessor
commit_sha: aaf5045a24c0a6f000225c97ad5449e69aeb5835
last_verified: 2026-08-11
---
# Kubernetes Attributes Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol.k8s.pod.association` | Counter | `{resources}` | `status`, `pod_identifier`, `otelcol.signal` | - |
| `otelcol.k8s.watcher.daemonset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.daemonset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.daemonset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod_cache.size` | Gauge | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_ip_lookup_miss` | Counter | `1` | - | Deprecated; emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_table_size` | Gauge | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |

## Sources

- `processor/k8sattributesprocessor/metadata.yaml`
- `processor/k8sattributesprocessor/internal/metadata/generated_telemetry.go`
- `processor/k8sattributesprocessor/internal/kube/client.go`
- `processor/k8sattributesprocessor/processor.go`
        • v0.156.0.md 8.3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/k8sattributesprocessor
version: v0.156.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/k8sattributesprocessor
commit_sha: 41e24cd516dd69a5b4277465cdb2ff4ef0676f49
last_verified: 2026-08-11
---
# Kubernetes Attributes Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol.k8s.pod.association` | Counter | `{resources}` | `status`, `pod_identifier`, `otelcol.signal` | - |
| `otelcol.k8s.watcher.daemonset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.daemonset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.daemonset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod_cache.size` | Gauge | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_ip_lookup_miss` | Counter | `1` | - | Deprecated; emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_table_size` | Gauge | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |

## Sources

- `processor/k8sattributesprocessor/metadata.yaml`
- `processor/k8sattributesprocessor/internal/metadata/generated_telemetry.go`
- `processor/k8sattributesprocessor/internal/kube/client.go`
- `processor/k8sattributesprocessor/processor.go`
        • v0.157.0.md 8.3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/k8sattributesprocessor
version: v0.157.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/k8sattributesprocessor
commit_sha: 89e43555904cd97c2d36605347c5d5237b1bdc8c
last_verified: 2026-08-11
---
# Kubernetes Attributes Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol.k8s.pod.association` | Counter | `{resources}` | `status`, `pod_identifier`, `otelcol.signal` | - |
| `otelcol.k8s.watcher.daemonset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.daemonset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.daemonset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod_cache.size` | Gauge | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_ip_lookup_miss` | Counter | `1` | - | Deprecated; emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_table_size` | Gauge | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |

## Sources

- `processor/k8sattributesprocessor/metadata.yaml`
- `processor/k8sattributesprocessor/internal/metadata/generated_telemetry.go`
- `processor/k8sattributesprocessor/internal/kube/client.go`
- `processor/k8sattributesprocessor/processor.go`
        • v0.158.0.md 8.3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/k8sattributesprocessor
version: v0.158.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/k8sattributesprocessor
commit_sha: 821a9d9c2c1623c4a0ceba5d47b57c48879c3f84
last_verified: 2026-08-11
---
# Kubernetes Attributes Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol.k8s.pod.association` | Counter | `{resources}` | `status`, `pod_identifier`, `otelcol.signal` | - |
| `otelcol.k8s.watcher.daemonset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.daemonset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.daemonset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod_cache.size` | Gauge | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_ip_lookup_miss` | Counter | `1` | - | Deprecated; emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_table_size` | Gauge | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |

## Sources

- `processor/k8sattributesprocessor/metadata.yaml`
- `processor/k8sattributesprocessor/internal/metadata/generated_telemetry.go`
- `processor/k8sattributesprocessor/internal/kube/client.go`
- `processor/k8sattributesprocessor/processor.go`
        • v0.159.0.md 9.3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/k8sattributesprocessor
version: v0.159.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/k8sattributesprocessor
commit_sha: 1120cc0714bf4d14600105e5673c3b00fe87467a
last_verified: 2026-10-03
---
# Kubernetes Attributes Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol.k8s.pod.association` | Counter | `{resources}` | `status`, `pod_identifier`, `otelcol.signal` | - |
| `otelcol.k8s.watcher.cronjob.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.cronjob.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.cronjob.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.daemonset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.daemonset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.daemonset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod_cache.size` | Gauge | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_ip_lookup_miss` | Counter | `1` | - | Deprecated; emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_table_size` | Gauge | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |

The Kubernetes resource attributes this processor adds to telemetry are not inventoried here. Feature gates `processor.k8sattributes.EmitV1K8sConventions` and `processor.k8sattributes.DontEmitV0K8sConventions` are beta (enabled by default) from v0.161.0: stable semconv names such as `k8s.pod.label.<key>`, `k8s.pod.annotation.<key>`, and `container.image.tags` are emitted, and the legacy `k8s.pod.labels.<key>`, `k8s.pod.annotations.<key>`, and `container.image.tag` are not unless the gates are disabled.

## Sources

- `processor/k8sattributesprocessor/metadata.yaml`
- `processor/k8sattributesprocessor/internal/metadata/generated_telemetry.go`
- `processor/k8sattributesprocessor/internal/kube/client.go`
- `processor/k8sattributesprocessor/processor.go`
- `processor/k8sattributesprocessor/documentation.md`
        • v0.160.0.md 8.8 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/k8sattributesprocessor
version: v0.160.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/k8sattributesprocessor
commit_sha: 982f20b8a8e8a2569fab3e27cf8b008e8a5080c1
last_verified: 2026-09-03
---
# Kubernetes Attributes Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol.k8s.pod.association` | Counter | `{resources}` | `status`, `pod_identifier`, `otelcol.signal` | - |
| `otelcol.k8s.watcher.cronjob.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.cronjob.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.cronjob.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.daemonset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.daemonset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.daemonset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod_cache.size` | Gauge | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_ip_lookup_miss` | Counter | `1` | - | Deprecated; emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_table_size` | Gauge | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |

## Sources

- `processor/k8sattributesprocessor/metadata.yaml`
- `processor/k8sattributesprocessor/internal/metadata/generated_telemetry.go`
- `processor/k8sattributesprocessor/internal/kube/client.go`
- `processor/k8sattributesprocessor/processor.go`
        • v0.161.0.md 9.3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/k8sattributesprocessor
version: v0.161.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/k8sattributesprocessor
commit_sha: 3f8455d8038a985398861171e5310bc9b4e988b2
last_verified: 2026-10-03
---
# Kubernetes Attributes Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol.k8s.pod.association` | Counter | `{resources}` | `status`, `pod_identifier`, `otelcol.signal` | - |
| `otelcol.k8s.watcher.cronjob.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.cronjob.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.cronjob.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.daemonset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.daemonset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.daemonset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod_cache.size` | Gauge | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_ip_lookup_miss` | Counter | `1` | - | Deprecated; emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_table_size` | Gauge | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |

The Kubernetes resource attributes this processor adds to telemetry are not inventoried here. Feature gates `processor.k8sattributes.EmitV1K8sConventions` and `processor.k8sattributes.DontEmitV0K8sConventions` are beta (enabled by default) from v0.161.0: stable semconv names such as `k8s.pod.label.<key>`, `k8s.pod.annotation.<key>`, and `container.image.tags` are emitted, and the legacy `k8s.pod.labels.<key>`, `k8s.pod.annotations.<key>`, and `container.image.tag` are not unless the gates are disabled.

## Sources

- `processor/k8sattributesprocessor/metadata.yaml`
- `processor/k8sattributesprocessor/internal/metadata/generated_telemetry.go`
- `processor/k8sattributesprocessor/internal/kube/client.go`
- `processor/k8sattributesprocessor/processor.go`
- `processor/k8sattributesprocessor/documentation.md`
        • v0.162.0.md 9.3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/k8sattributesprocessor
version: v0.162.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/k8sattributesprocessor
commit_sha: ae8c507510f48f433ab47dd1c6b01a59d6c388b5
last_verified: 2026-10-03
---
# Kubernetes Attributes Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol.k8s.pod.association` | Counter | `{resources}` | `status`, `pod_identifier`, `otelcol.signal` | - |
| `otelcol.k8s.watcher.cronjob.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.cronjob.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.cronjob.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.daemonset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.daemonset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.daemonset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod_cache.size` | Gauge | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_ip_lookup_miss` | Counter | `1` | - | Deprecated; emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_table_size` | Gauge | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |

The Kubernetes resource attributes this processor adds to telemetry are not inventoried here. Feature gates `processor.k8sattributes.EmitV1K8sConventions` and `processor.k8sattributes.DontEmitV0K8sConventions` are beta (enabled by default) from v0.161.0: stable semconv names such as `k8s.pod.label.<key>`, `k8s.pod.annotation.<key>`, and `container.image.tags` are emitted, and the legacy `k8s.pod.labels.<key>`, `k8s.pod.annotations.<key>`, and `container.image.tag` are not unless the gates are disabled.

## Sources

- `processor/k8sattributesprocessor/metadata.yaml`
- `processor/k8sattributesprocessor/internal/metadata/generated_telemetry.go`
- `processor/k8sattributesprocessor/internal/kube/client.go`
- `processor/k8sattributesprocessor/processor.go`
- `processor/k8sattributesprocessor/documentation.md`
        • v0.163.0.md 9.3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/k8sattributesprocessor
version: v0.163.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/k8sattributesprocessor
commit_sha: df849b5403c041d5e799e7846392a6f18b0b55ae
last_verified: null
---
# Kubernetes Attributes Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol.k8s.pod.association` | Counter | `{resources}` | `status`, `pod_identifier`, `otelcol.signal` | - |
| `otelcol.k8s.watcher.cronjob.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.cronjob.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.cronjob.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.daemonset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.daemonset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.daemonset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.deployment.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.job.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.namespace.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.node.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.pod_cache.size` | Gauge | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.replicaset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.added` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.deleted` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol.k8s.watcher.statefulset.updated` | Counter | `1` | - | Emitted only when `processor.k8sattributes.telemetry.enableNewFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_daemonset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_deployment_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_ip_lookup_miss` | Counter | `1` | - | Deprecated; emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_job_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_namespace_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_node_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_table_size` | Gauge | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_pod_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_replicaset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_added` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_deleted` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |
| `otelcol_otelsvc_k8s_statefulset_updated` | Counter | `1` | - | Emitted unless `processor.k8sattributes.telemetry.disableOldFormatMetrics` is enabled. |

The Kubernetes resource attributes this processor adds to telemetry are not inventoried here. Feature gates `processor.k8sattributes.EmitV1K8sConventions` and `processor.k8sattributes.DontEmitV0K8sConventions` are beta (enabled by default) from v0.161.0: stable semconv names such as `k8s.pod.label.<key>`, `k8s.pod.annotation.<key>`, and `container.image.tags` are emitted, and the legacy `k8s.pod.labels.<key>`, `k8s.pod.annotations.<key>`, and `container.image.tag` are not unless the gates are disabled.

## Sources

- `processor/k8sattributesprocessor/metadata.yaml`
- `processor/k8sattributesprocessor/internal/metadata/generated_telemetry.go`
- `processor/k8sattributesprocessor/internal/kube/client.go`
- `processor/k8sattributesprocessor/processor.go`
- `processor/k8sattributesprocessor/documentation.md`
      • resourcedetectionprocessor
        • v0.153.0.md 627 B 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/resourcedetectionprocessor
version: v0.153.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/resourcedetectionprocessor
commit_sha: 42f949127580c0d00088b785cd0b35842dc0ddb8
last_verified: 2026-08-11
---

# Resource Detection Processor

## Sources

- `processor/resourcedetectionprocessor/factory.go`
- `processor/resourcedetectionprocessor/resourcedetection_processor.go`
- `processor/resourcedetectionprocessor/internal/resourcedetection.go`
- `processor/resourcedetectionprocessor/internal/metadata/generated_status.go`
        • v0.154.0.md 627 B 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/resourcedetectionprocessor
version: v0.154.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/resourcedetectionprocessor
commit_sha: 853eda0e12b3ba142552ecd2b63cec07062904f0
last_verified: 2026-08-11
---

# Resource Detection Processor

## Sources

- `processor/resourcedetectionprocessor/factory.go`
- `processor/resourcedetectionprocessor/resourcedetection_processor.go`
- `processor/resourcedetectionprocessor/internal/resourcedetection.go`
- `processor/resourcedetectionprocessor/internal/metadata/generated_status.go`
        • v0.155.0.md 627 B 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/resourcedetectionprocessor
version: v0.155.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/resourcedetectionprocessor
commit_sha: aaf5045a24c0a6f000225c97ad5449e69aeb5835
last_verified: 2026-08-11
---

# Resource Detection Processor

## Sources

- `processor/resourcedetectionprocessor/factory.go`
- `processor/resourcedetectionprocessor/resourcedetection_processor.go`
- `processor/resourcedetectionprocessor/internal/resourcedetection.go`
- `processor/resourcedetectionprocessor/internal/metadata/generated_status.go`
        • v0.156.0.md 627 B 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/resourcedetectionprocessor
version: v0.156.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/resourcedetectionprocessor
commit_sha: 41e24cd516dd69a5b4277465cdb2ff4ef0676f49
last_verified: 2026-08-11
---

# Resource Detection Processor

## Sources

- `processor/resourcedetectionprocessor/factory.go`
- `processor/resourcedetectionprocessor/resourcedetection_processor.go`
- `processor/resourcedetectionprocessor/internal/resourcedetection.go`
- `processor/resourcedetectionprocessor/internal/metadata/generated_status.go`
        • v0.157.0.md 1.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/resourcedetectionprocessor
version: v0.157.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/resourcedetectionprocessor
commit_sha: 89e43555904cd97c2d36605347c5d5237b1bdc8c
last_verified: 2026-08-11
---

# Resource Detection Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol.resourcedetection.attributes.detected` | Observable UpDownCounter (int) | `{attribute}` | - | Asynchronously observes the number of attributes in the currently detected resource. |
| `otelcol.resourcedetection.detector.duration` | Histogram (double) | `s` | `detector`, `outcome` | Records the time taken by each detector, including retry backoff. |
| `otelcol.resourcedetection.detector.results` | Counter (int) | `{detection}` | `detector`, `outcome`, `error.type` | Records one result per detector; `error.type` is present on failure. |

## Sources

- `processor/resourcedetectionprocessor/metadata.yaml`
- `processor/resourcedetectionprocessor/internal/resourcedetection.go`
- `processor/resourcedetectionprocessor/internal/metadata/generated_telemetry.go`
- `processor/resourcedetectionprocessor/internal/metadata/generated_status.go`
        • v0.158.0.md 1.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/resourcedetectionprocessor
version: v0.158.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/resourcedetectionprocessor
commit_sha: 821a9d9c2c1623c4a0ceba5d47b57c48879c3f84
last_verified: 2026-08-11
---

# Resource Detection Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol.resourcedetection.attributes.detected` | Observable UpDownCounter (int) | `{attribute}` | - | Asynchronously observes the number of attributes in the currently detected resource. |
| `otelcol.resourcedetection.detector.duration` | Histogram (double) | `s` | `detector`, `outcome` | Records the time taken by each detector, including retry backoff. |
| `otelcol.resourcedetection.detector.results` | Counter (int) | `{detection}` | `detector`, `outcome`, `error.type` | Records one result per detector; `error.type` is present on failure. |

## Sources

- `processor/resourcedetectionprocessor/metadata.yaml`
- `processor/resourcedetectionprocessor/internal/resourcedetection.go`
- `processor/resourcedetectionprocessor/internal/metadata/generated_telemetry.go`
- `processor/resourcedetectionprocessor/internal/metadata/generated_status.go`
        • v0.159.0.md 1.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/resourcedetectionprocessor
version: v0.159.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/resourcedetectionprocessor
commit_sha: 1120cc0714bf4d14600105e5673c3b00fe87467a
last_verified: null
---

# Resource Detection Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol.resourcedetection.attributes.detected` | Observable UpDownCounter (int) | `{attribute}` | - | Asynchronously observes the number of attributes in the currently detected resource. |
| `otelcol.resourcedetection.detector.duration` | Histogram (double) | `s` | `detector`, `outcome` | Records the time taken by each detector, including retry backoff. |
| `otelcol.resourcedetection.detector.results` | Counter (int) | `{detection}` | `detector`, `outcome`, `error.type` | Records one result per detector; `error.type` is present on failure. |

## Sources

- `processor/resourcedetectionprocessor/metadata.yaml`
- `processor/resourcedetectionprocessor/internal/resourcedetection.go`
- `processor/resourcedetectionprocessor/internal/metadata/generated_telemetry.go`
- `processor/resourcedetectionprocessor/internal/metadata/generated_status.go`
        • v0.160.0.md 1.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/resourcedetectionprocessor
version: v0.160.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/resourcedetectionprocessor
commit_sha: 982f20b8a8e8a2569fab3e27cf8b008e8a5080c1
last_verified: 2026-09-03
---

# Resource Detection Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol.resourcedetection.attributes.detected` | Observable UpDownCounter (int) | `{attribute}` | - | Asynchronously observes the number of attributes in the currently detected resource. |
| `otelcol.resourcedetection.detector.duration` | Histogram (double) | `s` | `detector`, `outcome` | Records the time taken by each detector, including retry backoff. |
| `otelcol.resourcedetection.detector.results` | Counter (int) | `{detection}` | `detector`, `outcome`, `error.type` | Records one result per detector; `error.type` is present on failure. |

## Sources

- `processor/resourcedetectionprocessor/metadata.yaml`
- `processor/resourcedetectionprocessor/internal/resourcedetection.go`
- `processor/resourcedetectionprocessor/internal/metadata/generated_telemetry.go`
- `processor/resourcedetectionprocessor/internal/metadata/generated_status.go`
        • v0.161.0.md 1.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/resourcedetectionprocessor
version: v0.161.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/resourcedetectionprocessor
commit_sha: 3f8455d8038a985398861171e5310bc9b4e988b2
last_verified: 2026-10-03
---

# Resource Detection Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol.resourcedetection.attributes.detected` | Observable UpDownCounter (int) | `{attribute}` | - | Asynchronously observes the number of attributes in the currently detected resource. |
| `otelcol.resourcedetection.detector.duration` | Histogram (double) | `s` | `detector`, `outcome` | Records the time taken by each detector, including retry backoff. |
| `otelcol.resourcedetection.detector.results` | Counter (int) | `{detection}` | `detector`, `outcome`, `error.type` | Records one result per detector; `error.type` is present on failure. |

## Sources

- `processor/resourcedetectionprocessor/metadata.yaml`
- `processor/resourcedetectionprocessor/internal/resourcedetection.go`
- `processor/resourcedetectionprocessor/internal/metadata/generated_telemetry.go`
- `processor/resourcedetectionprocessor/internal/metadata/generated_status.go`
        • v0.162.0.md 1.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/resourcedetectionprocessor
version: v0.162.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/resourcedetectionprocessor
commit_sha: ae8c507510f48f433ab47dd1c6b01a59d6c388b5
last_verified: 2026-10-03
---

# Resource Detection Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol.resourcedetection.attributes.detected` | Observable UpDownCounter (int) | `{attribute}` | - | Asynchronously observes the number of attributes in the currently detected resource. |
| `otelcol.resourcedetection.detector.duration` | Histogram (double) | `s` | `detector`, `outcome` | Records the time taken by each detector, including retry backoff. |
| `otelcol.resourcedetection.detector.results` | Counter (int) | `{detection}` | `detector`, `outcome`, `error.type` | Records one result per detector; `error.type` is present on failure. |

## Sources

- `processor/resourcedetectionprocessor/metadata.yaml`
- `processor/resourcedetectionprocessor/internal/resourcedetection.go`
- `processor/resourcedetectionprocessor/internal/metadata/generated_telemetry.go`
- `processor/resourcedetectionprocessor/internal/metadata/generated_status.go`
        • v0.163.0.md 1.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/resourcedetectionprocessor
version: v0.163.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/resourcedetectionprocessor
commit_sha: df849b5403c041d5e799e7846392a6f18b0b55ae
last_verified: null
---

# Resource Detection Processor

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol.resourcedetection.attributes.detected` | Observable UpDownCounter (int) | `{attribute}` | - | Asynchronously observes the number of attributes in the currently detected resource. |
| `otelcol.resourcedetection.detector.duration` | Histogram (double) | `s` | `detector`, `outcome` | Records the time taken by each detector, including retry backoff. |
| `otelcol.resourcedetection.detector.results` | Counter (int) | `{detection}` | `detector`, `outcome`, `error.type` | Records one result per detector; `error.type` is present on failure. |

## Sources

- `processor/resourcedetectionprocessor/metadata.yaml`
- `processor/resourcedetectionprocessor/internal/resourcedetection.go`
- `processor/resourcedetectionprocessor/internal/metadata/generated_telemetry.go`
- `processor/resourcedetectionprocessor/internal/metadata/generated_status.go`
      • tailsamplingprocessor
        • v0.153.0.md 2.8 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/tailsamplingprocessor
version: v0.153.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/tailsamplingprocessor
commit_sha: 42f949127580c0d00088b785cd0b35842dc0ddb8
last_verified: 2026-08-11
---

# Tail Sampling Processor

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `tailsampling.ConsumeTraces` | Internal | `traces.count`, `spans.count`, `resource_spans.count` | Attributes are set when the span is recording. |
| `tailsampling.samplingPolicyOnTick` | Internal | `batch.size`, `policy.count`, `policy.errors`, `decisions.sampled`, `decisions.not_sampled`, `decisions.dropped` | Emitted for non-empty decision batches; status is Error when policy evaluation errors occur. With feature gate `processor.tailsamplingprocessor.recordpolicy`, processed output ScopeSpans may also receive `tailsampling.policy`, `tailsampling.composite_policy`, and `tailsampling.cached_decision`. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_tail_sampling_count_spans_sampled` | Counter | `{spans}` | `policy`, `sampled`, `decision` | Enabled by feature gate `processor.tailsamplingprocessor.metricstatcountspanssampled`. |
| `otelcol_processor_tail_sampling_count_traces_sampled` | Counter | `{traces}` | `policy`, `sampled`, `decision` | - |
| `otelcol_processor_tail_sampling_early_releases_from_cache_decision` | Counter | `{spans}` | `sampled` | - |
| `otelcol_processor_tail_sampling_global_count_traces_sampled` | Counter | `{traces}` | `sampled`, `decision` | - |
| `otelcol_processor_tail_sampling_new_trace_id_received` | Counter | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_sampling_decision_timer_latency` | Histogram | ms | - | - |
| `otelcol_processor_tail_sampling_sampling_late_span_age` | Histogram | s | - | - |
| `otelcol_processor_tail_sampling_sampling_policy_evaluation_error` | Counter | `{errors}` | - | - |
| `otelcol_processor_tail_sampling_sampling_policy_execution_count` | Counter | `{executions}` | `policy` | - |
| `otelcol_processor_tail_sampling_sampling_policy_execution_time_sum` | Counter | us | `policy` | - |
| `otelcol_processor_tail_sampling_sampling_trace_dropped_too_early` | Counter | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_sampling_trace_removal_age` | Histogram | s | - | - |
| `otelcol_processor_tail_sampling_sampling_traces_on_memory` | Gauge | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_traces_dropped_too_large` | Counter | `{traces}` | - | - |

## Sources

- `processor/tailsamplingprocessor/metadata.yaml`
- `processor/tailsamplingprocessor/processor.go`
- `processor/tailsamplingprocessor/internal/metadata/generated_telemetry.go`
- `processor/tailsamplingprocessor/internal/metadata/generated_feature_gates.go`
        • v0.154.0.md 3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/tailsamplingprocessor
version: v0.154.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/tailsamplingprocessor
commit_sha: 853eda0e12b3ba142552ecd2b63cec07062904f0
last_verified: 2026-08-11
---

# Tail Sampling Processor

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `tailsampling.ConsumeTraces` | Internal | `traces.count`, `spans.count`, `resource_spans.count` | Attributes are set when the span is recording. |
| `tailsampling.samplingPolicyOnTick` | Internal | `batch.size`, `policy.count`, `policy.errors`, `decisions.sampled`, `decisions.not_sampled`, `decisions.dropped` | Emitted for non-empty decision batches; status is Error when policy evaluation errors occur. With feature gate `processor.tailsamplingprocessor.recordpolicy`, processed output ScopeSpans may also receive `tailsampling.policy`, `tailsampling.composite_policy`, and `tailsampling.cached_decision`. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_tail_sampling_count_bytes_sampled` | Counter | By | `policy`, `sampled`, `decision` | Enabled by feature gate `processor.tailsamplingprocessor.metricstatcountbytessampled`. |
| `otelcol_processor_tail_sampling_count_spans_sampled` | Counter | `{spans}` | `policy`, `sampled`, `decision` | Enabled by feature gate `processor.tailsamplingprocessor.metricstatcountspanssampled`. |
| `otelcol_processor_tail_sampling_count_traces_sampled` | Counter | `{traces}` | `policy`, `sampled`, `decision` | - |
| `otelcol_processor_tail_sampling_early_releases_from_cache_decision` | Counter | `{spans}` | `sampled` | - |
| `otelcol_processor_tail_sampling_global_count_traces_sampled` | Counter | `{traces}` | `sampled`, `decision` | - |
| `otelcol_processor_tail_sampling_new_trace_id_received` | Counter | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_sampling_decision_timer_latency` | Histogram | ms | - | - |
| `otelcol_processor_tail_sampling_sampling_late_span_age` | Histogram | s | - | - |
| `otelcol_processor_tail_sampling_sampling_policy_evaluation_error` | Counter | `{errors}` | - | - |
| `otelcol_processor_tail_sampling_sampling_policy_execution_count` | Counter | `{executions}` | `policy` | - |
| `otelcol_processor_tail_sampling_sampling_policy_execution_time_sum` | Counter | us | `policy` | - |
| `otelcol_processor_tail_sampling_sampling_trace_dropped_too_early` | Counter | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_sampling_trace_removal_age` | Histogram | s | - | - |
| `otelcol_processor_tail_sampling_sampling_traces_on_memory` | Gauge | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_traces_dropped_too_large` | Counter | `{traces}` | - | - |

## Sources

- `processor/tailsamplingprocessor/metadata.yaml`
- `processor/tailsamplingprocessor/processor.go`
- `processor/tailsamplingprocessor/internal/metadata/generated_telemetry.go`
- `processor/tailsamplingprocessor/internal/metadata/generated_feature_gates.go`
        • v0.155.0.md 3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/tailsamplingprocessor
version: v0.155.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/tailsamplingprocessor
commit_sha: aaf5045a24c0a6f000225c97ad5449e69aeb5835
last_verified: 2026-08-11
---

# Tail Sampling Processor

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `tailsampling.ConsumeTraces` | Internal | `traces.count`, `spans.count`, `resource_spans.count` | Attributes are set when the span is recording. |
| `tailsampling.samplingPolicyOnTick` | Internal | `batch.size`, `policy.count`, `policy.errors`, `decisions.sampled`, `decisions.not_sampled`, `decisions.dropped` | Emitted for non-empty decision batches; status is Error when policy evaluation errors occur. With feature gate `processor.tailsamplingprocessor.recordpolicy`, processed output ScopeSpans may also receive `tailsampling.policy`, `tailsampling.composite_policy`, and `tailsampling.cached_decision`. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_tail_sampling_count_bytes_sampled` | Counter | By | `policy`, `sampled`, `decision` | Enabled by feature gate `processor.tailsamplingprocessor.metricstatcountbytessampled`. |
| `otelcol_processor_tail_sampling_count_spans_sampled` | Counter | `{spans}` | `policy`, `sampled`, `decision` | Enabled by feature gate `processor.tailsamplingprocessor.metricstatcountspanssampled`. |
| `otelcol_processor_tail_sampling_count_traces_sampled` | Counter | `{traces}` | `policy`, `sampled`, `decision` | - |
| `otelcol_processor_tail_sampling_early_releases_from_cache_decision` | Counter | `{spans}` | `sampled` | - |
| `otelcol_processor_tail_sampling_global_count_traces_sampled` | Counter | `{traces}` | `sampled`, `decision` | - |
| `otelcol_processor_tail_sampling_new_trace_id_received` | Counter | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_sampling_decision_timer_latency` | Histogram | ms | - | - |
| `otelcol_processor_tail_sampling_sampling_late_span_age` | Histogram | s | - | - |
| `otelcol_processor_tail_sampling_sampling_policy_evaluation_error` | Counter | `{errors}` | - | - |
| `otelcol_processor_tail_sampling_sampling_policy_execution_count` | Counter | `{executions}` | `policy` | - |
| `otelcol_processor_tail_sampling_sampling_policy_execution_time_sum` | Counter | us | `policy` | - |
| `otelcol_processor_tail_sampling_sampling_trace_dropped_too_early` | Counter | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_sampling_trace_removal_age` | Histogram | s | - | - |
| `otelcol_processor_tail_sampling_sampling_traces_on_memory` | Gauge | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_traces_dropped_too_large` | Counter | `{traces}` | - | - |

## Sources

- `processor/tailsamplingprocessor/metadata.yaml`
- `processor/tailsamplingprocessor/processor.go`
- `processor/tailsamplingprocessor/internal/metadata/generated_telemetry.go`
- `processor/tailsamplingprocessor/internal/metadata/generated_feature_gates.go`
        • v0.156.0.md 3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/tailsamplingprocessor
version: v0.156.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/tailsamplingprocessor
commit_sha: 41e24cd516dd69a5b4277465cdb2ff4ef0676f49
last_verified: 2026-08-11
---

# Tail Sampling Processor

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `tailsampling.ConsumeTraces` | Internal | `traces.count`, `spans.count`, `resource_spans.count` | Attributes are set when the span is recording. |
| `tailsampling.samplingPolicyOnTick` | Internal | `batch.size`, `policy.count`, `policy.errors`, `decisions.sampled`, `decisions.not_sampled`, `decisions.dropped` | Emitted for non-empty decision batches; status is Error when policy evaluation errors occur. With feature gate `processor.tailsamplingprocessor.recordpolicy`, processed output ScopeSpans may also receive `tailsampling.policy`, `tailsampling.composite_policy`, and `tailsampling.cached_decision`. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_tail_sampling_count_bytes_sampled` | Counter | By | `policy`, `sampled`, `decision` | Enabled by feature gate `processor.tailsamplingprocessor.metricstatcountbytessampled`. |
| `otelcol_processor_tail_sampling_count_spans_sampled` | Counter | `{spans}` | `policy`, `sampled`, `decision` | Enabled by feature gate `processor.tailsamplingprocessor.metricstatcountspanssampled`. |
| `otelcol_processor_tail_sampling_count_traces_sampled` | Counter | `{traces}` | `policy`, `sampled`, `decision` | - |
| `otelcol_processor_tail_sampling_early_releases_from_cache_decision` | Counter | `{spans}` | `sampled` | - |
| `otelcol_processor_tail_sampling_global_count_traces_sampled` | Counter | `{traces}` | `sampled`, `decision` | - |
| `otelcol_processor_tail_sampling_new_trace_id_received` | Counter | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_sampling_decision_timer_latency` | Histogram | ms | - | - |
| `otelcol_processor_tail_sampling_sampling_late_span_age` | Histogram | s | - | - |
| `otelcol_processor_tail_sampling_sampling_policy_evaluation_error` | Counter | `{errors}` | - | - |
| `otelcol_processor_tail_sampling_sampling_policy_execution_count` | Counter | `{executions}` | `policy` | - |
| `otelcol_processor_tail_sampling_sampling_policy_execution_time_sum` | Counter | us | `policy` | - |
| `otelcol_processor_tail_sampling_sampling_trace_dropped_too_early` | Counter | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_sampling_trace_removal_age` | Histogram | s | - | - |
| `otelcol_processor_tail_sampling_sampling_traces_on_memory` | Gauge | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_traces_dropped_too_large` | Counter | `{traces}` | - | - |

## Sources

- `processor/tailsamplingprocessor/metadata.yaml`
- `processor/tailsamplingprocessor/processor.go`
- `processor/tailsamplingprocessor/internal/metadata/generated_telemetry.go`
- `processor/tailsamplingprocessor/internal/metadata/generated_feature_gates.go`
        • v0.157.0.md 3.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/tailsamplingprocessor
version: v0.157.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/tailsamplingprocessor
commit_sha: 89e43555904cd97c2d36605347c5d5237b1bdc8c
last_verified: 2026-08-11
---

# Tail Sampling Processor

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `tailsampling.ConsumeTraces` | Internal | `traces.count`, `spans.count`, `resource_spans.count` | Attributes are set when the span is recording. |
| `tailsampling.samplingPolicyOnTick` | Internal | `batch.size`, `policy.count`, `policy.errors`, `decisions.sampled`, `decisions.not_sampled`, `decisions.dropped` | Emitted for non-empty decision batches; status is Error when policy evaluation errors occur. With feature gate `processor.tailsamplingprocessor.recordpolicy`, processed output ScopeSpans may also receive `tailsampling.policy`, `tailsampling.composite_policy`, and `tailsampling.cached_decision`. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_tail_sampling_count_bytes_sampled` | Counter | By | `policy`, `sampled`, `decision` | Enabled by feature gate `processor.tailsamplingprocessor.metricstatcountbytessampled`. |
| `otelcol_processor_tail_sampling_count_spans_sampled` | Counter | `{spans}` | `policy`, `sampled`, `decision` | Enabled by feature gate `processor.tailsamplingprocessor.metricstatcountspanssampled`. |
| `otelcol_processor_tail_sampling_count_spans_with_unparseable_tracestate` | Counter | `{spans}` | - | Emitted by tracestate threshold rewriting; feature gate `processor.tailsamplingprocessor.usetracestate`. |
| `otelcol_processor_tail_sampling_count_traces_sampled` | Counter | `{traces}` | `policy`, `sampled`, `decision` | - |
| `otelcol_processor_tail_sampling_early_releases_from_cache_decision` | Counter | `{spans}` | `sampled` | - |
| `otelcol_processor_tail_sampling_global_count_traces_sampled` | Counter | `{traces}` | `sampled`, `decision` | - |
| `otelcol_processor_tail_sampling_new_trace_id_received` | Counter | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_sampling_decision_timer_latency` | Histogram | ms | - | - |
| `otelcol_processor_tail_sampling_sampling_late_span_age` | Histogram | s | - | - |
| `otelcol_processor_tail_sampling_sampling_policy_evaluation_error` | Counter | `{errors}` | - | - |
| `otelcol_processor_tail_sampling_sampling_policy_execution_count` | Counter | `{executions}` | `policy` | - |
| `otelcol_processor_tail_sampling_sampling_policy_execution_time_sum` | Counter | us | `policy` | - |
| `otelcol_processor_tail_sampling_sampling_trace_dropped_too_early` | Counter | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_sampling_trace_removal_age` | Histogram | s | - | - |
| `otelcol_processor_tail_sampling_sampling_traces_on_memory` | Gauge | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_traces_dropped_too_large` | Counter | `{traces}` | - | - |

## Sources

- `processor/tailsamplingprocessor/metadata.yaml`
- `processor/tailsamplingprocessor/processor.go`
- `processor/tailsamplingprocessor/internal/metadata/generated_telemetry.go`
- `processor/tailsamplingprocessor/internal/metadata/generated_feature_gates.go`
        • v0.158.0.md 3.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/tailsamplingprocessor
version: v0.158.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/tailsamplingprocessor
commit_sha: 821a9d9c2c1623c4a0ceba5d47b57c48879c3f84
last_verified: 2026-08-11
---

# Tail Sampling Processor

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `tailsampling.ConsumeTraces` | Internal | `traces.count`, `spans.count`, `resource_spans.count` | Attributes are set when the span is recording. |
| `tailsampling.samplingPolicyOnTick` | Internal | `batch.size`, `policy.count`, `policy.errors`, `decisions.sampled`, `decisions.not_sampled`, `decisions.dropped` | Emitted for non-empty decision batches; status is Error when policy evaluation errors occur. With feature gate `processor.tailsamplingprocessor.recordpolicy`, processed output ScopeSpans may also receive `tailsampling.policy`, `tailsampling.composite_policy`, and `tailsampling.cached_decision`. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_tail_sampling_count_bytes_sampled` | Counter | By | `policy`, `sampled`, `decision` | Enabled by feature gate `processor.tailsamplingprocessor.metricstatcountbytessampled`. |
| `otelcol_processor_tail_sampling_count_spans_sampled` | Counter | `{spans}` | `policy`, `sampled`, `decision` | Enabled by feature gate `processor.tailsamplingprocessor.metricstatcountspanssampled`. |
| `otelcol_processor_tail_sampling_count_spans_with_unparseable_tracestate` | Counter | `{spans}` | - | Emitted by tracestate threshold rewriting; feature gate `processor.tailsamplingprocessor.usetracestate`. |
| `otelcol_processor_tail_sampling_count_traces_sampled` | Counter | `{traces}` | `policy`, `sampled`, `decision` | - |
| `otelcol_processor_tail_sampling_early_releases_from_cache_decision` | Counter | `{spans}` | `sampled` | - |
| `otelcol_processor_tail_sampling_global_count_traces_sampled` | Counter | `{traces}` | `sampled`, `decision` | - |
| `otelcol_processor_tail_sampling_new_trace_id_received` | Counter | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_sampling_decision_timer_latency` | Histogram | ms | - | - |
| `otelcol_processor_tail_sampling_sampling_late_span_age` | Histogram | s | - | - |
| `otelcol_processor_tail_sampling_sampling_policy_evaluation_error` | Counter | `{errors}` | - | - |
| `otelcol_processor_tail_sampling_sampling_policy_execution_count` | Counter | `{executions}` | `policy` | - |
| `otelcol_processor_tail_sampling_sampling_policy_execution_time_sum` | Counter | us | `policy` | - |
| `otelcol_processor_tail_sampling_sampling_trace_dropped_too_early` | Counter | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_sampling_trace_removal_age` | Histogram | s | - | - |
| `otelcol_processor_tail_sampling_sampling_traces_on_memory` | Gauge | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_traces_dropped_too_large` | Counter | `{traces}` | - | - |

## Sources

- `processor/tailsamplingprocessor/metadata.yaml`
- `processor/tailsamplingprocessor/processor.go`
- `processor/tailsamplingprocessor/internal/metadata/generated_telemetry.go`
- `processor/tailsamplingprocessor/internal/metadata/generated_feature_gates.go`
        • v0.159.0.md 3.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/tailsamplingprocessor
version: v0.159.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/tailsamplingprocessor
commit_sha: 1120cc0714bf4d14600105e5673c3b00fe87467a
last_verified: 2026-10-14
---

# Tail Sampling Processor

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `tailsampling.ConsumeTraces` | Internal | `traces.count`, `spans.count`, `resource_spans.count` | Attributes are set when the span is recording. |
| `tailsampling.samplingPolicyOnTick` | Internal | `batch.size`, `policy.count`, `policy.errors`, `decisions.sampled`, `decisions.not_sampled`, `decisions.dropped` | Emitted for non-empty decision batches; status is Error when policy evaluation errors occur. With feature gate `processor.tailsamplingprocessor.recordpolicy`, processed output ScopeSpans may also receive `tailsampling.policy`, `tailsampling.composite_policy`, and `tailsampling.cached_decision`. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_tail_sampling_count_bytes_sampled` | Counter | By | `policy`, `sampled`, `decision` | Enabled by feature gate `processor.tailsamplingprocessor.metricstatcountbytessampled`. |
| `otelcol_processor_tail_sampling_count_spans_sampled` | Counter | `{spans}` | `policy`, `sampled`, `decision` | Enabled by feature gate `processor.tailsamplingprocessor.metricstatcountspanssampled`. |
| `otelcol_processor_tail_sampling_count_spans_with_unparseable_tracestate` | Counter | `{spans}` | - | Emitted by tracestate threshold rewriting; feature gate `processor.tailsamplingprocessor.usetracestate`. |
| `otelcol_processor_tail_sampling_count_traces_sampled` | Counter | `{traces}` | `policy`, `sampled`, `decision` | - |
| `otelcol_processor_tail_sampling_early_releases_from_cache_decision` | Counter | `{spans}` | `sampled` | - |
| `otelcol_processor_tail_sampling_global_count_traces_sampled` | Counter | `{traces}` | `sampled`, `decision` | - |
| `otelcol_processor_tail_sampling_new_trace_id_received` | Counter | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_sampling_decision_timer_latency` | Histogram | ms | - | - |
| `otelcol_processor_tail_sampling_sampling_late_span_age` | Histogram | s | - | - |
| `otelcol_processor_tail_sampling_sampling_policy_evaluation_error` | Counter | `{errors}` | - | - |
| `otelcol_processor_tail_sampling_sampling_policy_execution_count` | Counter | `{executions}` | `policy` | - |
| `otelcol_processor_tail_sampling_sampling_policy_execution_time_sum` | Counter | us | `policy` | - |
| `otelcol_processor_tail_sampling_sampling_trace_dropped_too_early` | Counter | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_sampling_trace_removal_age` | Histogram | s | - | - |
| `otelcol_processor_tail_sampling_sampling_traces_on_memory` | Gauge | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_traces_dropped_too_large` | Counter | `{traces}` | - | - |

## Sources

- `processor/tailsamplingprocessor/metadata.yaml`
- `processor/tailsamplingprocessor/processor.go`
- `processor/tailsamplingprocessor/internal/metadata/generated_telemetry.go`
- `processor/tailsamplingprocessor/internal/metadata/generated_feature_gates.go`
        • v0.160.0.md 3.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/tailsamplingprocessor
version: v0.160.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/tailsamplingprocessor
commit_sha: 982f20b8a8e8a2569fab3e27cf8b008e8a5080c1
last_verified: 2026-10-14
---

# Tail Sampling Processor

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `tailsampling.ConsumeTraces` | Internal | `traces.count`, `spans.count`, `resource_spans.count` | Attributes are set when the span is recording. |
| `tailsampling.samplingPolicyOnTick` | Internal | `batch.size`, `policy.count`, `policy.errors`, `decisions.sampled`, `decisions.not_sampled`, `decisions.dropped` | Emitted for non-empty decision batches; status is Error when policy evaluation errors occur. With feature gate `processor.tailsamplingprocessor.recordpolicy`, processed output ScopeSpans may also receive `tailsampling.policy`, `tailsampling.composite_policy`, and `tailsampling.cached_decision`. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_tail_sampling_count_bytes_sampled` | Counter | By | `policy`, `sampled`, `decision` | Enabled by feature gate `processor.tailsamplingprocessor.metricstatcountbytessampled`. |
| `otelcol_processor_tail_sampling_count_spans_sampled` | Counter | `{spans}` | `policy`, `sampled`, `decision` | Enabled by feature gate `processor.tailsamplingprocessor.metricstatcountspanssampled`. |
| `otelcol_processor_tail_sampling_count_spans_with_unparseable_tracestate` | Counter | `{spans}` | - | Emitted by tracestate threshold rewriting; feature gate `processor.tailsamplingprocessor.usetracestate`. |
| `otelcol_processor_tail_sampling_count_traces_sampled` | Counter | `{traces}` | `policy`, `sampled`, `decision` | - |
| `otelcol_processor_tail_sampling_early_releases_from_cache_decision` | Counter | `{spans}` | `sampled` | - |
| `otelcol_processor_tail_sampling_global_count_traces_sampled` | Counter | `{traces}` | `sampled`, `decision` | - |
| `otelcol_processor_tail_sampling_new_trace_id_received` | Counter | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_sampling_decision_timer_latency` | Histogram | ms | - | - |
| `otelcol_processor_tail_sampling_sampling_late_span_age` | Histogram | s | - | - |
| `otelcol_processor_tail_sampling_sampling_policy_evaluation_error` | Counter | `{errors}` | - | - |
| `otelcol_processor_tail_sampling_sampling_policy_execution_count` | Counter | `{executions}` | `policy` | - |
| `otelcol_processor_tail_sampling_sampling_policy_execution_time_sum` | Counter | us | `policy` | - |
| `otelcol_processor_tail_sampling_sampling_trace_dropped_too_early` | Counter | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_sampling_trace_removal_age` | Histogram | s | - | - |
| `otelcol_processor_tail_sampling_sampling_traces_on_memory` | Gauge | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_traces_dropped_too_large` | Counter | `{traces}` | - | - |

## Sources

- `processor/tailsamplingprocessor/metadata.yaml`
- `processor/tailsamplingprocessor/processor.go`
- `processor/tailsamplingprocessor/internal/metadata/generated_telemetry.go`
- `processor/tailsamplingprocessor/internal/metadata/generated_feature_gates.go`
        • v0.161.0.md 3.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/tailsamplingprocessor
version: v0.161.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/tailsamplingprocessor
commit_sha: 3f8455d8038a985398861171e5310bc9b4e988b2
last_verified: 2026-10-14
---

# Tail Sampling Processor

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `tailsampling.ConsumeTraces` | Internal | `traces.count`, `spans.count`, `resource_spans.count` | Attributes are set when the span is recording. |
| `tailsampling.samplingPolicyOnTick` | Internal | `batch.size`, `policy.count`, `policy.errors`, `decisions.sampled`, `decisions.not_sampled`, `decisions.dropped` | Emitted for non-empty decision batches; status is Error when policy evaluation errors occur. With feature gate `processor.tailsamplingprocessor.recordpolicy`, processed output ScopeSpans may also receive `tailsampling.policy`, `tailsampling.composite_policy`, and `tailsampling.cached_decision`. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_tail_sampling_count_bytes_sampled` | Counter | By | `policy`, `sampled`, `decision` | Enabled by feature gate `processor.tailsamplingprocessor.metricstatcountbytessampled`. |
| `otelcol_processor_tail_sampling_count_spans_sampled` | Counter | `{spans}` | `policy`, `sampled`, `decision` | Enabled by feature gate `processor.tailsamplingprocessor.metricstatcountspanssampled`. |
| `otelcol_processor_tail_sampling_count_spans_with_unparseable_tracestate` | Counter | `{spans}` | - | Emitted by tracestate threshold rewriting; feature gate `processor.tailsamplingprocessor.usetracestate`. |
| `otelcol_processor_tail_sampling_count_traces_sampled` | Counter | `{traces}` | `policy`, `sampled`, `decision` | - |
| `otelcol_processor_tail_sampling_early_releases_from_cache_decision` | Counter | `{spans}` | `sampled` | - |
| `otelcol_processor_tail_sampling_global_count_traces_sampled` | Counter | `{traces}` | `sampled`, `decision` | - |
| `otelcol_processor_tail_sampling_new_trace_id_received` | Counter | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_sampling_decision_timer_latency` | Histogram | ms | - | - |
| `otelcol_processor_tail_sampling_sampling_late_span_age` | Histogram | s | - | - |
| `otelcol_processor_tail_sampling_sampling_policy_evaluation_error` | Counter | `{errors}` | - | - |
| `otelcol_processor_tail_sampling_sampling_policy_execution_count` | Counter | `{executions}` | `policy` | - |
| `otelcol_processor_tail_sampling_sampling_policy_execution_time_sum` | Counter | us | `policy` | - |
| `otelcol_processor_tail_sampling_sampling_trace_dropped_too_early` | Counter | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_sampling_trace_removal_age` | Histogram | s | - | - |
| `otelcol_processor_tail_sampling_sampling_traces_on_memory` | Gauge | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_traces_dropped_too_large` | Counter | `{traces}` | - | - |

## Sources

- `processor/tailsamplingprocessor/metadata.yaml`
- `processor/tailsamplingprocessor/processor.go`
- `processor/tailsamplingprocessor/internal/metadata/generated_telemetry.go`
- `processor/tailsamplingprocessor/internal/metadata/generated_feature_gates.go`
        • v0.162.0.md 3.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/tailsamplingprocessor
version: v0.162.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/tailsamplingprocessor
commit_sha: ae8c507510f48f433ab47dd1c6b01a59d6c388b5
last_verified: 2026-10-14
---

# Tail Sampling Processor

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `tailsampling.ConsumeTraces` | Internal | `traces.count`, `spans.count`, `resource_spans.count` | Attributes are set when the span is recording. |
| `tailsampling.samplingPolicyOnTick` | Internal | `batch.size`, `policy.count`, `policy.errors`, `decisions.sampled`, `decisions.not_sampled`, `decisions.dropped` | Emitted for non-empty decision batches; status is Error when policy evaluation errors occur. With feature gate `processor.tailsamplingprocessor.recordpolicy`, processed output ScopeSpans may also receive `tailsampling.policy`, `tailsampling.composite_policy`, and `tailsampling.cached_decision`. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_tail_sampling_count_bytes_sampled` | Counter | By | `policy`, `sampled`, `decision` | Enabled by feature gate `processor.tailsamplingprocessor.metricstatcountbytessampled`. |
| `otelcol_processor_tail_sampling_count_spans_sampled` | Counter | `{spans}` | `policy`, `sampled`, `decision` | Enabled by feature gate `processor.tailsamplingprocessor.metricstatcountspanssampled`. |
| `otelcol_processor_tail_sampling_count_spans_with_unparseable_tracestate` | Counter | `{spans}` | - | Emitted by tracestate threshold rewriting; feature gate `processor.tailsamplingprocessor.usetracestate`. |
| `otelcol_processor_tail_sampling_count_traces_sampled` | Counter | `{traces}` | `policy`, `sampled`, `decision` | - |
| `otelcol_processor_tail_sampling_early_releases_from_cache_decision` | Counter | `{spans}` | `sampled` | - |
| `otelcol_processor_tail_sampling_global_count_traces_sampled` | Counter | `{traces}` | `sampled`, `decision` | - |
| `otelcol_processor_tail_sampling_new_trace_id_received` | Counter | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_sampling_decision_timer_latency` | Histogram | ms | - | - |
| `otelcol_processor_tail_sampling_sampling_late_span_age` | Histogram | s | - | - |
| `otelcol_processor_tail_sampling_sampling_policy_evaluation_error` | Counter | `{errors}` | - | - |
| `otelcol_processor_tail_sampling_sampling_policy_execution_count` | Counter | `{executions}` | `policy` | - |
| `otelcol_processor_tail_sampling_sampling_policy_execution_time_sum` | Counter | us | `policy` | - |
| `otelcol_processor_tail_sampling_sampling_trace_dropped_too_early` | Counter | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_sampling_trace_removal_age` | Histogram | s | - | - |
| `otelcol_processor_tail_sampling_sampling_traces_on_memory` | Gauge | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_traces_dropped_too_large` | Counter | `{traces}` | - | - |

## Sources

- `processor/tailsamplingprocessor/metadata.yaml`
- `processor/tailsamplingprocessor/processor.go`
- `processor/tailsamplingprocessor/internal/metadata/generated_telemetry.go`
- `processor/tailsamplingprocessor/internal/metadata/generated_feature_gates.go`
        • v0.163.0.md 3.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: processor/tailsamplingprocessor
version: v0.163.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/processor/tailsamplingprocessor
commit_sha: df849b5403c041d5e799e7846392a6f18b0b55ae
last_verified: 2026-10-14
---

# Tail Sampling Processor

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `tailsampling.ConsumeTraces` | Internal | `traces.count`, `spans.count`, `resource_spans.count` | Attributes are set when the span is recording. |
| `tailsampling.samplingPolicyOnTick` | Internal | `batch.size`, `policy.count`, `policy.errors`, `decisions.sampled`, `decisions.not_sampled`, `decisions.dropped` | Emitted for non-empty decision batches; status is Error when policy evaluation errors occur. With feature gate `processor.tailsamplingprocessor.recordpolicy`, processed output ScopeSpans may also receive `tailsampling.policy`, `tailsampling.composite_policy`, and `tailsampling.cached_decision`. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_processor_tail_sampling_count_bytes_sampled` | Counter | By | `policy`, `sampled`, `decision` | Enabled by feature gate `processor.tailsamplingprocessor.metricstatcountbytessampled`. |
| `otelcol_processor_tail_sampling_count_spans_sampled` | Counter | `{spans}` | `policy`, `sampled`, `decision` | Enabled by feature gate `processor.tailsamplingprocessor.metricstatcountspanssampled`. |
| `otelcol_processor_tail_sampling_count_spans_with_unparseable_tracestate` | Counter | `{spans}` | - | Emitted by tracestate threshold rewriting; feature gate `processor.tailsamplingprocessor.usetracestate`. |
| `otelcol_processor_tail_sampling_count_traces_sampled` | Counter | `{traces}` | `policy`, `sampled`, `decision` | - |
| `otelcol_processor_tail_sampling_early_releases_from_cache_decision` | Counter | `{spans}` | `sampled` | - |
| `otelcol_processor_tail_sampling_global_count_traces_sampled` | Counter | `{traces}` | `sampled`, `decision` | - |
| `otelcol_processor_tail_sampling_new_trace_id_received` | Counter | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_sampling_decision_timer_latency` | Histogram | ms | - | - |
| `otelcol_processor_tail_sampling_sampling_late_span_age` | Histogram | s | - | - |
| `otelcol_processor_tail_sampling_sampling_policy_evaluation_error` | Counter | `{errors}` | - | - |
| `otelcol_processor_tail_sampling_sampling_policy_execution_count` | Counter | `{executions}` | `policy` | - |
| `otelcol_processor_tail_sampling_sampling_policy_execution_time_sum` | Counter | us | `policy` | - |
| `otelcol_processor_tail_sampling_sampling_trace_dropped_too_early` | Counter | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_sampling_trace_removal_age` | Histogram | s | - | - |
| `otelcol_processor_tail_sampling_sampling_traces_on_memory` | Gauge | `{traces}` | - | - |
| `otelcol_processor_tail_sampling_traces_dropped_too_large` | Counter | `{traces}` | - | - |

## Sources

- `processor/tailsamplingprocessor/metadata.yaml`
- `processor/tailsamplingprocessor/processor.go`
- `processor/tailsamplingprocessor/internal/metadata/generated_telemetry.go`
- `processor/tailsamplingprocessor/internal/metadata/generated_feature_gates.go`
    • receiver
      • dockerstatsreceiver
        • v0.153.0.md 12.8 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/dockerstatsreceiver
version: v0.153.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/dockerstatsreceiver
commit_sha: 42f949127580c0d00088b785cd0b35842dc0ddb8
last_verified: 2026-08-11
---

# Docker Stats Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `container.blockio.io_merged_recursive` | Sum (cumulative, monotonic) | `{operations}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_merged_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_queued_recursive` | Sum (cumulative, monotonic) | `{operations}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_queued_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_service_bytes_recursive` | Sum (cumulative, monotonic) | `By` | device_major, device_minor, operation | - |
| `container.blockio.io_service_time_recursive` | Sum (cumulative, monotonic) | `ns` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_service_time_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_serviced_recursive` | Sum (cumulative, monotonic) | `{operations}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_serviced_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_time_recursive` | Sum (cumulative, monotonic) | `ms` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_time_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_wait_time_recursive` | Sum (cumulative, monotonic) | `ns` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_wait_time_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.sectors_recursive` | Sum (cumulative, monotonic) | `{sectors}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.sectors_recursive.enabled`. Only available with cgroups v1 |
| `container.cpu.limit` | Gauge | `{cpus}` | - | Disabled by default; enable with `metrics.container.cpu.limit.enabled`. Only reported if the container has CPU limits set. |
| `container.cpu.logical.count` | Gauge | `{cpus}` | - | Disabled by default; enable with `metrics.container.cpu.logical.count.enabled`. |
| `container.cpu.shares` | Gauge | `1` | - | Disabled by default; enable with `metrics.container.cpu.shares.enabled`. |
| `container.cpu.throttling_data.periods` | Sum (cumulative, monotonic) | `{periods}` | - | Disabled by default; enable with `metrics.container.cpu.throttling_data.periods.enabled`. |
| `container.cpu.throttling_data.throttled_periods` | Sum (cumulative, monotonic) | `{periods}` | - | Disabled by default; enable with `metrics.container.cpu.throttling_data.throttled_periods.enabled`. |
| `container.cpu.throttling_data.throttled_time` | Sum (cumulative, monotonic) | `ns` | - | Disabled by default; enable with `metrics.container.cpu.throttling_data.throttled_time.enabled`. |
| `container.cpu.usage.kernelmode` | Sum (cumulative, monotonic) | `ns` | - | - |
| `container.cpu.usage.percpu` | Sum (cumulative, monotonic) | `ns` | core | Disabled by default; enable with `metrics.container.cpu.usage.percpu.enabled`. Only available with cgroups v1 |
| `container.cpu.usage.system` | Sum (cumulative, monotonic) | `ns` | - | Disabled by default; enable with `metrics.container.cpu.usage.system.enabled`. |
| `container.cpu.usage.total` | Sum (cumulative, monotonic) | `ns` | - | - |
| `container.cpu.usage.usermode` | Sum (cumulative, monotonic) | `ns` | - | - |
| `container.cpu.utilization` | Gauge | `1` | - | - |
| `container.memory.active_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.active_anon.enabled`. |
| `container.memory.active_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.active_file.enabled`. |
| `container.memory.anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.anon.enabled`. Only available with cgroups v2 |
| `container.memory.cache` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.cache.enabled`. Only available with cgroups v1 |
| `container.memory.dirty` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.dirty.enabled`. Only available with cgroups v1 |
| `container.memory.fails` | Sum (cumulative, monotonic) | `{fails}` | - | Disabled by default; enable with `metrics.container.memory.fails.enabled`. |
| `container.memory.file` | Sum (cumulative, non-monotonic) | `By` | - | Only available with cgroups v2 |
| `container.memory.hierarchical_memory_limit` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.hierarchical_memory_limit.enabled`. Only available with cgroups v1 |
| `container.memory.hierarchical_memsw_limit` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.hierarchical_memsw_limit.enabled`. Only available with cgroups v1 |
| `container.memory.inactive_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.inactive_anon.enabled`. |
| `container.memory.inactive_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.inactive_file.enabled`. |
| `container.memory.mapped_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.mapped_file.enabled`. Only available with cgroups v1 |
| `container.memory.percent` | Gauge | `1` | - | Not supported on Windows. |
| `container.memory.pgfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.pgfault.enabled`. |
| `container.memory.pgmajfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.pgmajfault.enabled`. |
| `container.memory.pgpgin` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.pgpgin.enabled`. Only available with cgroups v1 |
| `container.memory.pgpgout` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.pgpgout.enabled`. Only available with cgroups v1 |
| `container.memory.rss` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.rss.enabled`. Only available with cgroups v1 |
| `container.memory.rss_huge` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.rss_huge.enabled`. Only available with cgroups v1 |
| `container.memory.total_active_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_active_anon.enabled`. Only available with cgroups v1 |
| `container.memory.total_active_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_active_file.enabled`. Only available with cgroups v1 |
| `container.memory.total_cache` | Sum (cumulative, non-monotonic) | `By` | - | Only available with cgroups v1 |
| `container.memory.total_dirty` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_dirty.enabled`. Only available with cgroups v1 |
| `container.memory.total_inactive_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_inactive_anon.enabled`. Only available with cgroups v1 |
| `container.memory.total_inactive_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_inactive_file.enabled`. Only available with cgroups v1 |
| `container.memory.total_mapped_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_mapped_file.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.total_pgfault.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgmajfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.total_pgmajfault.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgpgin` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.total_pgpgin.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgpgout` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.total_pgpgout.enabled`. Only available with cgroups v1 |
| `container.memory.total_rss` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_rss.enabled`. Only available with cgroups v1 |
| `container.memory.total_rss_huge` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_rss_huge.enabled`. Only available with cgroups v1 |
| `container.memory.total_unevictable` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_unevictable.enabled`. Only available with cgroups v1 |
| `container.memory.total_writeback` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_writeback.enabled`. Only available with cgroups v1 |
| `container.memory.unevictable` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.unevictable.enabled`. |
| `container.memory.usage.limit` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `container.memory.usage.max` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.usage.max.enabled`. |
| `container.memory.usage.total` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `container.memory.writeback` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.writeback.enabled`. Only available with cgroups v1 |
| `container.network.io.usage.rx_bytes` | Sum (cumulative, monotonic) | `By` | interface | - |
| `container.network.io.usage.rx_dropped` | Sum (cumulative, monotonic) | `{packets}` | interface | - |
| `container.network.io.usage.rx_errors` | Sum (cumulative, monotonic) | `{errors}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.rx_errors.enabled`. Not supported on Windows. |
| `container.network.io.usage.rx_packets` | Sum (cumulative, monotonic) | `{packets}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.rx_packets.enabled`. |
| `container.network.io.usage.tx_bytes` | Sum (cumulative, monotonic) | `By` | interface | - |
| `container.network.io.usage.tx_dropped` | Sum (cumulative, monotonic) | `{packets}` | interface | - |
| `container.network.io.usage.tx_errors` | Sum (cumulative, monotonic) | `{errors}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.tx_errors.enabled`. Not supported on Windows. |
| `container.network.io.usage.tx_packets` | Sum (cumulative, monotonic) | `{packets}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.tx_packets.enabled`. |
| `container.pids.count` | Sum (cumulative, non-monotonic) | `{pids}` | - | Disabled by default; enable with `metrics.container.pids.count.enabled`. Requires Docker API 1.23+ and a kernel with the pids cgroup. |
| `container.pids.limit` | Sum (cumulative, non-monotonic) | `{pids}` | - | Disabled by default; enable with `metrics.container.pids.limit.enabled`. Requires Docker API 1.23+ and a kernel with the pids cgroup. |
| `container.restarts` | Sum (cumulative, monotonic) | `{restarts}` | - | Disabled by default; enable with `metrics.container.restarts.enabled`. |
| `container.uptime` | Gauge | `s` | - | Disabled by default; enable with `metrics.container.uptime.enabled`. |

## Sources

- `receiver/dockerstatsreceiver/metadata.yaml`
- `receiver/dockerstatsreceiver/receiver.go`
- `receiver/dockerstatsreceiver/metric_helper.go`
- `receiver/dockerstatsreceiver/metric_helper_others.go`
- `receiver/dockerstatsreceiver/metric_helper_windows.go`
- `receiver/dockerstatsreceiver/factory.go`
- `receiver/dockerstatsreceiver/config.go`
- `receiver/dockerstatsreceiver/internal/metadata/generated_metrics.go`
        • v0.154.0.md 12.8 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/dockerstatsreceiver
version: v0.154.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/dockerstatsreceiver
commit_sha: 853eda0e12b3ba142552ecd2b63cec07062904f0
last_verified: 2026-08-11
---

# Docker Stats Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `container.blockio.io_merged_recursive` | Sum (cumulative, monotonic) | `{operations}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_merged_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_queued_recursive` | Sum (cumulative, monotonic) | `{operations}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_queued_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_service_bytes_recursive` | Sum (cumulative, monotonic) | `By` | device_major, device_minor, operation | - |
| `container.blockio.io_service_time_recursive` | Sum (cumulative, monotonic) | `ns` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_service_time_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_serviced_recursive` | Sum (cumulative, monotonic) | `{operations}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_serviced_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_time_recursive` | Sum (cumulative, monotonic) | `ms` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_time_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_wait_time_recursive` | Sum (cumulative, monotonic) | `ns` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_wait_time_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.sectors_recursive` | Sum (cumulative, monotonic) | `{sectors}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.sectors_recursive.enabled`. Only available with cgroups v1 |
| `container.cpu.limit` | Gauge | `{cpus}` | - | Disabled by default; enable with `metrics.container.cpu.limit.enabled`. Only reported if the container has CPU limits set. |
| `container.cpu.logical.count` | Gauge | `{cpus}` | - | Disabled by default; enable with `metrics.container.cpu.logical.count.enabled`. |
| `container.cpu.shares` | Gauge | `1` | - | Disabled by default; enable with `metrics.container.cpu.shares.enabled`. |
| `container.cpu.throttling_data.periods` | Sum (cumulative, monotonic) | `{periods}` | - | Disabled by default; enable with `metrics.container.cpu.throttling_data.periods.enabled`. |
| `container.cpu.throttling_data.throttled_periods` | Sum (cumulative, monotonic) | `{periods}` | - | Disabled by default; enable with `metrics.container.cpu.throttling_data.throttled_periods.enabled`. |
| `container.cpu.throttling_data.throttled_time` | Sum (cumulative, monotonic) | `ns` | - | Disabled by default; enable with `metrics.container.cpu.throttling_data.throttled_time.enabled`. |
| `container.cpu.usage.kernelmode` | Sum (cumulative, monotonic) | `ns` | - | - |
| `container.cpu.usage.percpu` | Sum (cumulative, monotonic) | `ns` | core | Disabled by default; enable with `metrics.container.cpu.usage.percpu.enabled`. Only available with cgroups v1 |
| `container.cpu.usage.system` | Sum (cumulative, monotonic) | `ns` | - | Disabled by default; enable with `metrics.container.cpu.usage.system.enabled`. |
| `container.cpu.usage.total` | Sum (cumulative, monotonic) | `ns` | - | - |
| `container.cpu.usage.usermode` | Sum (cumulative, monotonic) | `ns` | - | - |
| `container.cpu.utilization` | Gauge | `1` | - | - |
| `container.memory.active_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.active_anon.enabled`. |
| `container.memory.active_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.active_file.enabled`. |
| `container.memory.anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.anon.enabled`. Only available with cgroups v2 |
| `container.memory.cache` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.cache.enabled`. Only available with cgroups v1 |
| `container.memory.dirty` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.dirty.enabled`. Only available with cgroups v1 |
| `container.memory.fails` | Sum (cumulative, monotonic) | `{fails}` | - | Disabled by default; enable with `metrics.container.memory.fails.enabled`. |
| `container.memory.file` | Sum (cumulative, non-monotonic) | `By` | - | Only available with cgroups v2 |
| `container.memory.hierarchical_memory_limit` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.hierarchical_memory_limit.enabled`. Only available with cgroups v1 |
| `container.memory.hierarchical_memsw_limit` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.hierarchical_memsw_limit.enabled`. Only available with cgroups v1 |
| `container.memory.inactive_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.inactive_anon.enabled`. |
| `container.memory.inactive_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.inactive_file.enabled`. |
| `container.memory.mapped_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.mapped_file.enabled`. Only available with cgroups v1 |
| `container.memory.percent` | Gauge | `1` | - | Not supported on Windows. |
| `container.memory.pgfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.pgfault.enabled`. |
| `container.memory.pgmajfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.pgmajfault.enabled`. |
| `container.memory.pgpgin` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.pgpgin.enabled`. Only available with cgroups v1 |
| `container.memory.pgpgout` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.pgpgout.enabled`. Only available with cgroups v1 |
| `container.memory.rss` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.rss.enabled`. Only available with cgroups v1 |
| `container.memory.rss_huge` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.rss_huge.enabled`. Only available with cgroups v1 |
| `container.memory.total_active_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_active_anon.enabled`. Only available with cgroups v1 |
| `container.memory.total_active_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_active_file.enabled`. Only available with cgroups v1 |
| `container.memory.total_cache` | Sum (cumulative, non-monotonic) | `By` | - | Only available with cgroups v1 |
| `container.memory.total_dirty` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_dirty.enabled`. Only available with cgroups v1 |
| `container.memory.total_inactive_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_inactive_anon.enabled`. Only available with cgroups v1 |
| `container.memory.total_inactive_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_inactive_file.enabled`. Only available with cgroups v1 |
| `container.memory.total_mapped_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_mapped_file.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.total_pgfault.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgmajfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.total_pgmajfault.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgpgin` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.total_pgpgin.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgpgout` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.total_pgpgout.enabled`. Only available with cgroups v1 |
| `container.memory.total_rss` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_rss.enabled`. Only available with cgroups v1 |
| `container.memory.total_rss_huge` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_rss_huge.enabled`. Only available with cgroups v1 |
| `container.memory.total_unevictable` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_unevictable.enabled`. Only available with cgroups v1 |
| `container.memory.total_writeback` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_writeback.enabled`. Only available with cgroups v1 |
| `container.memory.unevictable` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.unevictable.enabled`. |
| `container.memory.usage.limit` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `container.memory.usage.max` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.usage.max.enabled`. |
| `container.memory.usage.total` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `container.memory.writeback` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.writeback.enabled`. Only available with cgroups v1 |
| `container.network.io.usage.rx_bytes` | Sum (cumulative, monotonic) | `By` | interface | - |
| `container.network.io.usage.rx_dropped` | Sum (cumulative, monotonic) | `{packets}` | interface | - |
| `container.network.io.usage.rx_errors` | Sum (cumulative, monotonic) | `{errors}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.rx_errors.enabled`. Not supported on Windows. |
| `container.network.io.usage.rx_packets` | Sum (cumulative, monotonic) | `{packets}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.rx_packets.enabled`. |
| `container.network.io.usage.tx_bytes` | Sum (cumulative, monotonic) | `By` | interface | - |
| `container.network.io.usage.tx_dropped` | Sum (cumulative, monotonic) | `{packets}` | interface | - |
| `container.network.io.usage.tx_errors` | Sum (cumulative, monotonic) | `{errors}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.tx_errors.enabled`. Not supported on Windows. |
| `container.network.io.usage.tx_packets` | Sum (cumulative, monotonic) | `{packets}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.tx_packets.enabled`. |
| `container.pids.count` | Sum (cumulative, non-monotonic) | `{pids}` | - | Disabled by default; enable with `metrics.container.pids.count.enabled`. Requires Docker API 1.23+ and a kernel with the pids cgroup. |
| `container.pids.limit` | Sum (cumulative, non-monotonic) | `{pids}` | - | Disabled by default; enable with `metrics.container.pids.limit.enabled`. Requires Docker API 1.23+ and a kernel with the pids cgroup. |
| `container.restarts` | Sum (cumulative, monotonic) | `{restarts}` | - | Disabled by default; enable with `metrics.container.restarts.enabled`. |
| `container.uptime` | Gauge | `s` | - | Disabled by default; enable with `metrics.container.uptime.enabled`. |

## Sources

- `receiver/dockerstatsreceiver/metadata.yaml`
- `receiver/dockerstatsreceiver/receiver.go`
- `receiver/dockerstatsreceiver/metric_helper.go`
- `receiver/dockerstatsreceiver/metric_helper_others.go`
- `receiver/dockerstatsreceiver/metric_helper_windows.go`
- `receiver/dockerstatsreceiver/factory.go`
- `receiver/dockerstatsreceiver/config.go`
- `receiver/dockerstatsreceiver/internal/metadata/generated_metrics.go`
        • v0.155.0.md 12.8 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/dockerstatsreceiver
version: v0.155.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/dockerstatsreceiver
commit_sha: aaf5045a24c0a6f000225c97ad5449e69aeb5835
last_verified: 2026-08-11
---

# Docker Stats Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `container.blockio.io_merged_recursive` | Sum (cumulative, monotonic) | `{operations}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_merged_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_queued_recursive` | Sum (cumulative, monotonic) | `{operations}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_queued_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_service_bytes_recursive` | Sum (cumulative, monotonic) | `By` | device_major, device_minor, operation | - |
| `container.blockio.io_service_time_recursive` | Sum (cumulative, monotonic) | `ns` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_service_time_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_serviced_recursive` | Sum (cumulative, monotonic) | `{operations}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_serviced_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_time_recursive` | Sum (cumulative, monotonic) | `ms` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_time_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_wait_time_recursive` | Sum (cumulative, monotonic) | `ns` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_wait_time_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.sectors_recursive` | Sum (cumulative, monotonic) | `{sectors}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.sectors_recursive.enabled`. Only available with cgroups v1 |
| `container.cpu.limit` | Gauge | `{cpus}` | - | Disabled by default; enable with `metrics.container.cpu.limit.enabled`. Only reported if the container has CPU limits set. |
| `container.cpu.logical.count` | Gauge | `{cpus}` | - | Disabled by default; enable with `metrics.container.cpu.logical.count.enabled`. |
| `container.cpu.shares` | Gauge | `1` | - | Disabled by default; enable with `metrics.container.cpu.shares.enabled`. |
| `container.cpu.throttling_data.periods` | Sum (cumulative, monotonic) | `{periods}` | - | Disabled by default; enable with `metrics.container.cpu.throttling_data.periods.enabled`. |
| `container.cpu.throttling_data.throttled_periods` | Sum (cumulative, monotonic) | `{periods}` | - | Disabled by default; enable with `metrics.container.cpu.throttling_data.throttled_periods.enabled`. |
| `container.cpu.throttling_data.throttled_time` | Sum (cumulative, monotonic) | `ns` | - | Disabled by default; enable with `metrics.container.cpu.throttling_data.throttled_time.enabled`. |
| `container.cpu.usage.kernelmode` | Sum (cumulative, monotonic) | `ns` | - | - |
| `container.cpu.usage.percpu` | Sum (cumulative, monotonic) | `ns` | core | Disabled by default; enable with `metrics.container.cpu.usage.percpu.enabled`. Only available with cgroups v1 |
| `container.cpu.usage.system` | Sum (cumulative, monotonic) | `ns` | - | Disabled by default; enable with `metrics.container.cpu.usage.system.enabled`. |
| `container.cpu.usage.total` | Sum (cumulative, monotonic) | `ns` | - | - |
| `container.cpu.usage.usermode` | Sum (cumulative, monotonic) | `ns` | - | - |
| `container.cpu.utilization` | Gauge | `1` | - | - |
| `container.memory.active_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.active_anon.enabled`. |
| `container.memory.active_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.active_file.enabled`. |
| `container.memory.anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.anon.enabled`. Only available with cgroups v2 |
| `container.memory.cache` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.cache.enabled`. Only available with cgroups v1 |
| `container.memory.dirty` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.dirty.enabled`. Only available with cgroups v1 |
| `container.memory.fails` | Sum (cumulative, monotonic) | `{fails}` | - | Disabled by default; enable with `metrics.container.memory.fails.enabled`. |
| `container.memory.file` | Sum (cumulative, non-monotonic) | `By` | - | Only available with cgroups v2 |
| `container.memory.hierarchical_memory_limit` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.hierarchical_memory_limit.enabled`. Only available with cgroups v1 |
| `container.memory.hierarchical_memsw_limit` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.hierarchical_memsw_limit.enabled`. Only available with cgroups v1 |
| `container.memory.inactive_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.inactive_anon.enabled`. |
| `container.memory.inactive_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.inactive_file.enabled`. |
| `container.memory.mapped_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.mapped_file.enabled`. Only available with cgroups v1 |
| `container.memory.percent` | Gauge | `1` | - | Not supported on Windows. |
| `container.memory.pgfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.pgfault.enabled`. |
| `container.memory.pgmajfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.pgmajfault.enabled`. |
| `container.memory.pgpgin` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.pgpgin.enabled`. Only available with cgroups v1 |
| `container.memory.pgpgout` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.pgpgout.enabled`. Only available with cgroups v1 |
| `container.memory.rss` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.rss.enabled`. Only available with cgroups v1 |
| `container.memory.rss_huge` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.rss_huge.enabled`. Only available with cgroups v1 |
| `container.memory.total_active_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_active_anon.enabled`. Only available with cgroups v1 |
| `container.memory.total_active_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_active_file.enabled`. Only available with cgroups v1 |
| `container.memory.total_cache` | Sum (cumulative, non-monotonic) | `By` | - | Only available with cgroups v1 |
| `container.memory.total_dirty` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_dirty.enabled`. Only available with cgroups v1 |
| `container.memory.total_inactive_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_inactive_anon.enabled`. Only available with cgroups v1 |
| `container.memory.total_inactive_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_inactive_file.enabled`. Only available with cgroups v1 |
| `container.memory.total_mapped_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_mapped_file.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.total_pgfault.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgmajfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.total_pgmajfault.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgpgin` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.total_pgpgin.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgpgout` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.total_pgpgout.enabled`. Only available with cgroups v1 |
| `container.memory.total_rss` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_rss.enabled`. Only available with cgroups v1 |
| `container.memory.total_rss_huge` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_rss_huge.enabled`. Only available with cgroups v1 |
| `container.memory.total_unevictable` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_unevictable.enabled`. Only available with cgroups v1 |
| `container.memory.total_writeback` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_writeback.enabled`. Only available with cgroups v1 |
| `container.memory.unevictable` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.unevictable.enabled`. |
| `container.memory.usage.limit` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `container.memory.usage.max` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.usage.max.enabled`. |
| `container.memory.usage.total` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `container.memory.writeback` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.writeback.enabled`. Only available with cgroups v1 |
| `container.network.io.usage.rx_bytes` | Sum (cumulative, monotonic) | `By` | interface | - |
| `container.network.io.usage.rx_dropped` | Sum (cumulative, monotonic) | `{packets}` | interface | - |
| `container.network.io.usage.rx_errors` | Sum (cumulative, monotonic) | `{errors}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.rx_errors.enabled`. Not supported on Windows. |
| `container.network.io.usage.rx_packets` | Sum (cumulative, monotonic) | `{packets}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.rx_packets.enabled`. |
| `container.network.io.usage.tx_bytes` | Sum (cumulative, monotonic) | `By` | interface | - |
| `container.network.io.usage.tx_dropped` | Sum (cumulative, monotonic) | `{packets}` | interface | - |
| `container.network.io.usage.tx_errors` | Sum (cumulative, monotonic) | `{errors}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.tx_errors.enabled`. Not supported on Windows. |
| `container.network.io.usage.tx_packets` | Sum (cumulative, monotonic) | `{packets}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.tx_packets.enabled`. |
| `container.pids.count` | Sum (cumulative, non-monotonic) | `{pids}` | - | Disabled by default; enable with `metrics.container.pids.count.enabled`. Requires Docker API 1.23+ and a kernel with the pids cgroup. |
| `container.pids.limit` | Sum (cumulative, non-monotonic) | `{pids}` | - | Disabled by default; enable with `metrics.container.pids.limit.enabled`. Requires Docker API 1.23+ and a kernel with the pids cgroup. |
| `container.restarts` | Sum (cumulative, monotonic) | `{restarts}` | - | Disabled by default; enable with `metrics.container.restarts.enabled`. |
| `container.uptime` | Gauge | `s` | - | Disabled by default; enable with `metrics.container.uptime.enabled`. |

## Sources

- `receiver/dockerstatsreceiver/metadata.yaml`
- `receiver/dockerstatsreceiver/receiver.go`
- `receiver/dockerstatsreceiver/metric_helper.go`
- `receiver/dockerstatsreceiver/metric_helper_others.go`
- `receiver/dockerstatsreceiver/metric_helper_windows.go`
- `receiver/dockerstatsreceiver/factory.go`
- `receiver/dockerstatsreceiver/config.go`
- `receiver/dockerstatsreceiver/internal/metadata/generated_metrics.go`
        • v0.156.0.md 12.8 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/dockerstatsreceiver
version: v0.156.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/dockerstatsreceiver
commit_sha: 41e24cd516dd69a5b4277465cdb2ff4ef0676f49
last_verified: 2026-08-11
---

# Docker Stats Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `container.blockio.io_merged_recursive` | Sum (cumulative, monotonic) | `{operations}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_merged_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_queued_recursive` | Sum (cumulative, monotonic) | `{operations}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_queued_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_service_bytes_recursive` | Sum (cumulative, monotonic) | `By` | device_major, device_minor, operation | - |
| `container.blockio.io_service_time_recursive` | Sum (cumulative, monotonic) | `ns` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_service_time_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_serviced_recursive` | Sum (cumulative, monotonic) | `{operations}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_serviced_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_time_recursive` | Sum (cumulative, monotonic) | `ms` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_time_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_wait_time_recursive` | Sum (cumulative, monotonic) | `ns` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_wait_time_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.sectors_recursive` | Sum (cumulative, monotonic) | `{sectors}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.sectors_recursive.enabled`. Only available with cgroups v1 |
| `container.cpu.limit` | Gauge | `{cpus}` | - | Disabled by default; enable with `metrics.container.cpu.limit.enabled`. Only reported if the container has CPU limits set. |
| `container.cpu.logical.count` | Gauge | `{cpus}` | - | Disabled by default; enable with `metrics.container.cpu.logical.count.enabled`. |
| `container.cpu.shares` | Gauge | `1` | - | Disabled by default; enable with `metrics.container.cpu.shares.enabled`. |
| `container.cpu.throttling_data.periods` | Sum (cumulative, monotonic) | `{periods}` | - | Disabled by default; enable with `metrics.container.cpu.throttling_data.periods.enabled`. |
| `container.cpu.throttling_data.throttled_periods` | Sum (cumulative, monotonic) | `{periods}` | - | Disabled by default; enable with `metrics.container.cpu.throttling_data.throttled_periods.enabled`. |
| `container.cpu.throttling_data.throttled_time` | Sum (cumulative, monotonic) | `ns` | - | Disabled by default; enable with `metrics.container.cpu.throttling_data.throttled_time.enabled`. |
| `container.cpu.usage.kernelmode` | Sum (cumulative, monotonic) | `ns` | - | - |
| `container.cpu.usage.percpu` | Sum (cumulative, monotonic) | `ns` | core | Disabled by default; enable with `metrics.container.cpu.usage.percpu.enabled`. Only available with cgroups v1 |
| `container.cpu.usage.system` | Sum (cumulative, monotonic) | `ns` | - | Disabled by default; enable with `metrics.container.cpu.usage.system.enabled`. |
| `container.cpu.usage.total` | Sum (cumulative, monotonic) | `ns` | - | - |
| `container.cpu.usage.usermode` | Sum (cumulative, monotonic) | `ns` | - | - |
| `container.cpu.utilization` | Gauge | `1` | - | - |
| `container.memory.active_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.active_anon.enabled`. |
| `container.memory.active_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.active_file.enabled`. |
| `container.memory.anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.anon.enabled`. Only available with cgroups v2 |
| `container.memory.cache` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.cache.enabled`. Only available with cgroups v1 |
| `container.memory.dirty` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.dirty.enabled`. Only available with cgroups v1 |
| `container.memory.fails` | Sum (cumulative, monotonic) | `{fails}` | - | Disabled by default; enable with `metrics.container.memory.fails.enabled`. |
| `container.memory.file` | Sum (cumulative, non-monotonic) | `By` | - | Only available with cgroups v2 |
| `container.memory.hierarchical_memory_limit` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.hierarchical_memory_limit.enabled`. Only available with cgroups v1 |
| `container.memory.hierarchical_memsw_limit` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.hierarchical_memsw_limit.enabled`. Only available with cgroups v1 |
| `container.memory.inactive_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.inactive_anon.enabled`. |
| `container.memory.inactive_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.inactive_file.enabled`. |
| `container.memory.mapped_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.mapped_file.enabled`. Only available with cgroups v1 |
| `container.memory.percent` | Gauge | `1` | - | Not supported on Windows. |
| `container.memory.pgfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.pgfault.enabled`. |
| `container.memory.pgmajfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.pgmajfault.enabled`. |
| `container.memory.pgpgin` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.pgpgin.enabled`. Only available with cgroups v1 |
| `container.memory.pgpgout` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.pgpgout.enabled`. Only available with cgroups v1 |
| `container.memory.rss` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.rss.enabled`. Only available with cgroups v1 |
| `container.memory.rss_huge` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.rss_huge.enabled`. Only available with cgroups v1 |
| `container.memory.total_active_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_active_anon.enabled`. Only available with cgroups v1 |
| `container.memory.total_active_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_active_file.enabled`. Only available with cgroups v1 |
| `container.memory.total_cache` | Sum (cumulative, non-monotonic) | `By` | - | Only available with cgroups v1 |
| `container.memory.total_dirty` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_dirty.enabled`. Only available with cgroups v1 |
| `container.memory.total_inactive_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_inactive_anon.enabled`. Only available with cgroups v1 |
| `container.memory.total_inactive_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_inactive_file.enabled`. Only available with cgroups v1 |
| `container.memory.total_mapped_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_mapped_file.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.total_pgfault.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgmajfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.total_pgmajfault.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgpgin` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.total_pgpgin.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgpgout` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.total_pgpgout.enabled`. Only available with cgroups v1 |
| `container.memory.total_rss` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_rss.enabled`. Only available with cgroups v1 |
| `container.memory.total_rss_huge` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_rss_huge.enabled`. Only available with cgroups v1 |
| `container.memory.total_unevictable` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_unevictable.enabled`. Only available with cgroups v1 |
| `container.memory.total_writeback` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_writeback.enabled`. Only available with cgroups v1 |
| `container.memory.unevictable` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.unevictable.enabled`. |
| `container.memory.usage.limit` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `container.memory.usage.max` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.usage.max.enabled`. |
| `container.memory.usage.total` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `container.memory.writeback` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.writeback.enabled`. Only available with cgroups v1 |
| `container.network.io.usage.rx_bytes` | Sum (cumulative, monotonic) | `By` | interface | - |
| `container.network.io.usage.rx_dropped` | Sum (cumulative, monotonic) | `{packets}` | interface | - |
| `container.network.io.usage.rx_errors` | Sum (cumulative, monotonic) | `{errors}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.rx_errors.enabled`. Not supported on Windows. |
| `container.network.io.usage.rx_packets` | Sum (cumulative, monotonic) | `{packets}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.rx_packets.enabled`. |
| `container.network.io.usage.tx_bytes` | Sum (cumulative, monotonic) | `By` | interface | - |
| `container.network.io.usage.tx_dropped` | Sum (cumulative, monotonic) | `{packets}` | interface | - |
| `container.network.io.usage.tx_errors` | Sum (cumulative, monotonic) | `{errors}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.tx_errors.enabled`. Not supported on Windows. |
| `container.network.io.usage.tx_packets` | Sum (cumulative, monotonic) | `{packets}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.tx_packets.enabled`. |
| `container.pids.count` | Sum (cumulative, non-monotonic) | `{pids}` | - | Disabled by default; enable with `metrics.container.pids.count.enabled`. Requires Docker API 1.23+ and a kernel with the pids cgroup. |
| `container.pids.limit` | Sum (cumulative, non-monotonic) | `{pids}` | - | Disabled by default; enable with `metrics.container.pids.limit.enabled`. Requires Docker API 1.23+ and a kernel with the pids cgroup. |
| `container.restarts` | Sum (cumulative, monotonic) | `{restarts}` | - | Disabled by default; enable with `metrics.container.restarts.enabled`. |
| `container.uptime` | Gauge | `s` | - | Disabled by default; enable with `metrics.container.uptime.enabled`. |

## Sources

- `receiver/dockerstatsreceiver/metadata.yaml`
- `receiver/dockerstatsreceiver/receiver.go`
- `receiver/dockerstatsreceiver/metric_helper.go`
- `receiver/dockerstatsreceiver/metric_helper_others.go`
- `receiver/dockerstatsreceiver/metric_helper_windows.go`
- `receiver/dockerstatsreceiver/factory.go`
- `receiver/dockerstatsreceiver/config.go`
- `receiver/dockerstatsreceiver/internal/metadata/generated_metrics.go`
        • v0.157.0.md 12.8 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/dockerstatsreceiver
version: v0.157.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/dockerstatsreceiver
commit_sha: 89e43555904cd97c2d36605347c5d5237b1bdc8c
last_verified: 2026-08-11
---

# Docker Stats Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `container.blockio.io_merged_recursive` | Sum (cumulative, monotonic) | `{operations}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_merged_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_queued_recursive` | Sum (cumulative, monotonic) | `{operations}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_queued_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_service_bytes_recursive` | Sum (cumulative, monotonic) | `By` | device_major, device_minor, operation | - |
| `container.blockio.io_service_time_recursive` | Sum (cumulative, monotonic) | `ns` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_service_time_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_serviced_recursive` | Sum (cumulative, monotonic) | `{operations}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_serviced_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_time_recursive` | Sum (cumulative, monotonic) | `ms` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_time_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_wait_time_recursive` | Sum (cumulative, monotonic) | `ns` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_wait_time_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.sectors_recursive` | Sum (cumulative, monotonic) | `{sectors}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.sectors_recursive.enabled`. Only available with cgroups v1 |
| `container.cpu.limit` | Gauge | `{cpus}` | - | Disabled by default; enable with `metrics.container.cpu.limit.enabled`. Only reported if the container has CPU limits set. |
| `container.cpu.logical.count` | Gauge | `{cpus}` | - | Disabled by default; enable with `metrics.container.cpu.logical.count.enabled`. |
| `container.cpu.shares` | Gauge | `1` | - | Disabled by default; enable with `metrics.container.cpu.shares.enabled`. |
| `container.cpu.throttling_data.periods` | Sum (cumulative, monotonic) | `{periods}` | - | Disabled by default; enable with `metrics.container.cpu.throttling_data.periods.enabled`. |
| `container.cpu.throttling_data.throttled_periods` | Sum (cumulative, monotonic) | `{periods}` | - | Disabled by default; enable with `metrics.container.cpu.throttling_data.throttled_periods.enabled`. |
| `container.cpu.throttling_data.throttled_time` | Sum (cumulative, monotonic) | `ns` | - | Disabled by default; enable with `metrics.container.cpu.throttling_data.throttled_time.enabled`. |
| `container.cpu.usage.kernelmode` | Sum (cumulative, monotonic) | `ns` | - | - |
| `container.cpu.usage.percpu` | Sum (cumulative, monotonic) | `ns` | core | Disabled by default; enable with `metrics.container.cpu.usage.percpu.enabled`. Only available with cgroups v1 |
| `container.cpu.usage.system` | Sum (cumulative, monotonic) | `ns` | - | Disabled by default; enable with `metrics.container.cpu.usage.system.enabled`. |
| `container.cpu.usage.total` | Sum (cumulative, monotonic) | `ns` | - | - |
| `container.cpu.usage.usermode` | Sum (cumulative, monotonic) | `ns` | - | - |
| `container.cpu.utilization` | Gauge | `1` | - | - |
| `container.memory.active_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.active_anon.enabled`. |
| `container.memory.active_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.active_file.enabled`. |
| `container.memory.anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.anon.enabled`. Only available with cgroups v2 |
| `container.memory.cache` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.cache.enabled`. Only available with cgroups v1 |
| `container.memory.dirty` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.dirty.enabled`. Only available with cgroups v1 |
| `container.memory.fails` | Sum (cumulative, monotonic) | `{fails}` | - | Disabled by default; enable with `metrics.container.memory.fails.enabled`. |
| `container.memory.file` | Sum (cumulative, non-monotonic) | `By` | - | Only available with cgroups v2 |
| `container.memory.hierarchical_memory_limit` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.hierarchical_memory_limit.enabled`. Only available with cgroups v1 |
| `container.memory.hierarchical_memsw_limit` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.hierarchical_memsw_limit.enabled`. Only available with cgroups v1 |
| `container.memory.inactive_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.inactive_anon.enabled`. |
| `container.memory.inactive_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.inactive_file.enabled`. |
| `container.memory.mapped_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.mapped_file.enabled`. Only available with cgroups v1 |
| `container.memory.percent` | Gauge | `1` | - | Not supported on Windows. |
| `container.memory.pgfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.pgfault.enabled`. |
| `container.memory.pgmajfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.pgmajfault.enabled`. |
| `container.memory.pgpgin` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.pgpgin.enabled`. Only available with cgroups v1 |
| `container.memory.pgpgout` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.pgpgout.enabled`. Only available with cgroups v1 |
| `container.memory.rss` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.rss.enabled`. Only available with cgroups v1 |
| `container.memory.rss_huge` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.rss_huge.enabled`. Only available with cgroups v1 |
| `container.memory.total_active_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_active_anon.enabled`. Only available with cgroups v1 |
| `container.memory.total_active_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_active_file.enabled`. Only available with cgroups v1 |
| `container.memory.total_cache` | Sum (cumulative, non-monotonic) | `By` | - | Only available with cgroups v1 |
| `container.memory.total_dirty` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_dirty.enabled`. Only available with cgroups v1 |
| `container.memory.total_inactive_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_inactive_anon.enabled`. Only available with cgroups v1 |
| `container.memory.total_inactive_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_inactive_file.enabled`. Only available with cgroups v1 |
| `container.memory.total_mapped_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_mapped_file.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.total_pgfault.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgmajfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.total_pgmajfault.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgpgin` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.total_pgpgin.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgpgout` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.total_pgpgout.enabled`. Only available with cgroups v1 |
| `container.memory.total_rss` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_rss.enabled`. Only available with cgroups v1 |
| `container.memory.total_rss_huge` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_rss_huge.enabled`. Only available with cgroups v1 |
| `container.memory.total_unevictable` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_unevictable.enabled`. Only available with cgroups v1 |
| `container.memory.total_writeback` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_writeback.enabled`. Only available with cgroups v1 |
| `container.memory.unevictable` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.unevictable.enabled`. |
| `container.memory.usage.limit` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `container.memory.usage.max` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.usage.max.enabled`. |
| `container.memory.usage.total` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `container.memory.writeback` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.writeback.enabled`. Only available with cgroups v1 |
| `container.network.io.usage.rx_bytes` | Sum (cumulative, monotonic) | `By` | interface | - |
| `container.network.io.usage.rx_dropped` | Sum (cumulative, monotonic) | `{packets}` | interface | - |
| `container.network.io.usage.rx_errors` | Sum (cumulative, monotonic) | `{errors}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.rx_errors.enabled`. Not supported on Windows. |
| `container.network.io.usage.rx_packets` | Sum (cumulative, monotonic) | `{packets}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.rx_packets.enabled`. |
| `container.network.io.usage.tx_bytes` | Sum (cumulative, monotonic) | `By` | interface | - |
| `container.network.io.usage.tx_dropped` | Sum (cumulative, monotonic) | `{packets}` | interface | - |
| `container.network.io.usage.tx_errors` | Sum (cumulative, monotonic) | `{errors}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.tx_errors.enabled`. Not supported on Windows. |
| `container.network.io.usage.tx_packets` | Sum (cumulative, monotonic) | `{packets}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.tx_packets.enabled`. |
| `container.pids.count` | Sum (cumulative, non-monotonic) | `{pids}` | - | Disabled by default; enable with `metrics.container.pids.count.enabled`. Requires Docker API 1.23+ and a kernel with the pids cgroup. |
| `container.pids.limit` | Sum (cumulative, non-monotonic) | `{pids}` | - | Disabled by default; enable with `metrics.container.pids.limit.enabled`. Requires Docker API 1.23+ and a kernel with the pids cgroup. |
| `container.restarts` | Sum (cumulative, monotonic) | `{restarts}` | - | Disabled by default; enable with `metrics.container.restarts.enabled`. |
| `container.uptime` | Gauge | `s` | - | Disabled by default; enable with `metrics.container.uptime.enabled`. |

## Sources

- `receiver/dockerstatsreceiver/metadata.yaml`
- `receiver/dockerstatsreceiver/receiver.go`
- `receiver/dockerstatsreceiver/metric_helper.go`
- `receiver/dockerstatsreceiver/metric_helper_others.go`
- `receiver/dockerstatsreceiver/metric_helper_windows.go`
- `receiver/dockerstatsreceiver/factory.go`
- `receiver/dockerstatsreceiver/config.go`
- `receiver/dockerstatsreceiver/internal/metadata/generated_metrics.go`
        • v0.158.0.md 12.8 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/dockerstatsreceiver
version: v0.158.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/dockerstatsreceiver
commit_sha: 821a9d9c2c1623c4a0ceba5d47b57c48879c3f84
last_verified: 2026-08-11
---

# Docker Stats Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `container.blockio.io_merged_recursive` | Sum (cumulative, monotonic) | `{operations}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_merged_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_queued_recursive` | Sum (cumulative, monotonic) | `{operations}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_queued_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_service_bytes_recursive` | Sum (cumulative, monotonic) | `By` | device_major, device_minor, operation | - |
| `container.blockio.io_service_time_recursive` | Sum (cumulative, monotonic) | `ns` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_service_time_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_serviced_recursive` | Sum (cumulative, monotonic) | `{operations}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_serviced_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_time_recursive` | Sum (cumulative, monotonic) | `ms` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_time_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_wait_time_recursive` | Sum (cumulative, monotonic) | `ns` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_wait_time_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.sectors_recursive` | Sum (cumulative, monotonic) | `{sectors}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.sectors_recursive.enabled`. Only available with cgroups v1 |
| `container.cpu.limit` | Gauge | `{cpus}` | - | Disabled by default; enable with `metrics.container.cpu.limit.enabled`. Only reported if the container has CPU limits set. |
| `container.cpu.logical.count` | Gauge | `{cpus}` | - | Disabled by default; enable with `metrics.container.cpu.logical.count.enabled`. |
| `container.cpu.shares` | Gauge | `1` | - | Disabled by default; enable with `metrics.container.cpu.shares.enabled`. |
| `container.cpu.throttling_data.periods` | Sum (cumulative, monotonic) | `{periods}` | - | Disabled by default; enable with `metrics.container.cpu.throttling_data.periods.enabled`. |
| `container.cpu.throttling_data.throttled_periods` | Sum (cumulative, monotonic) | `{periods}` | - | Disabled by default; enable with `metrics.container.cpu.throttling_data.throttled_periods.enabled`. |
| `container.cpu.throttling_data.throttled_time` | Sum (cumulative, monotonic) | `ns` | - | Disabled by default; enable with `metrics.container.cpu.throttling_data.throttled_time.enabled`. |
| `container.cpu.usage.kernelmode` | Sum (cumulative, monotonic) | `ns` | - | - |
| `container.cpu.usage.percpu` | Sum (cumulative, monotonic) | `ns` | core | Disabled by default; enable with `metrics.container.cpu.usage.percpu.enabled`. Only available with cgroups v1 |
| `container.cpu.usage.system` | Sum (cumulative, monotonic) | `ns` | - | Disabled by default; enable with `metrics.container.cpu.usage.system.enabled`. |
| `container.cpu.usage.total` | Sum (cumulative, monotonic) | `ns` | - | - |
| `container.cpu.usage.usermode` | Sum (cumulative, monotonic) | `ns` | - | - |
| `container.cpu.utilization` | Gauge | `1` | - | - |
| `container.memory.active_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.active_anon.enabled`. |
| `container.memory.active_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.active_file.enabled`. |
| `container.memory.anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.anon.enabled`. Only available with cgroups v2 |
| `container.memory.cache` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.cache.enabled`. Only available with cgroups v1 |
| `container.memory.dirty` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.dirty.enabled`. Only available with cgroups v1 |
| `container.memory.fails` | Sum (cumulative, monotonic) | `{fails}` | - | Disabled by default; enable with `metrics.container.memory.fails.enabled`. |
| `container.memory.file` | Sum (cumulative, non-monotonic) | `By` | - | Only available with cgroups v2 |
| `container.memory.hierarchical_memory_limit` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.hierarchical_memory_limit.enabled`. Only available with cgroups v1 |
| `container.memory.hierarchical_memsw_limit` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.hierarchical_memsw_limit.enabled`. Only available with cgroups v1 |
| `container.memory.inactive_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.inactive_anon.enabled`. |
| `container.memory.inactive_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.inactive_file.enabled`. |
| `container.memory.mapped_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.mapped_file.enabled`. Only available with cgroups v1 |
| `container.memory.percent` | Gauge | `1` | - | Not supported on Windows. |
| `container.memory.pgfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.pgfault.enabled`. |
| `container.memory.pgmajfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.pgmajfault.enabled`. |
| `container.memory.pgpgin` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.pgpgin.enabled`. Only available with cgroups v1 |
| `container.memory.pgpgout` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.pgpgout.enabled`. Only available with cgroups v1 |
| `container.memory.rss` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.rss.enabled`. Only available with cgroups v1 |
| `container.memory.rss_huge` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.rss_huge.enabled`. Only available with cgroups v1 |
| `container.memory.total_active_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_active_anon.enabled`. Only available with cgroups v1 |
| `container.memory.total_active_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_active_file.enabled`. Only available with cgroups v1 |
| `container.memory.total_cache` | Sum (cumulative, non-monotonic) | `By` | - | Only available with cgroups v1 |
| `container.memory.total_dirty` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_dirty.enabled`. Only available with cgroups v1 |
| `container.memory.total_inactive_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_inactive_anon.enabled`. Only available with cgroups v1 |
| `container.memory.total_inactive_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_inactive_file.enabled`. Only available with cgroups v1 |
| `container.memory.total_mapped_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_mapped_file.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.total_pgfault.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgmajfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.total_pgmajfault.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgpgin` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.total_pgpgin.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgpgout` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.total_pgpgout.enabled`. Only available with cgroups v1 |
| `container.memory.total_rss` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_rss.enabled`. Only available with cgroups v1 |
| `container.memory.total_rss_huge` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_rss_huge.enabled`. Only available with cgroups v1 |
| `container.memory.total_unevictable` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_unevictable.enabled`. Only available with cgroups v1 |
| `container.memory.total_writeback` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_writeback.enabled`. Only available with cgroups v1 |
| `container.memory.unevictable` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.unevictable.enabled`. |
| `container.memory.usage.limit` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `container.memory.usage.max` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.usage.max.enabled`. |
| `container.memory.usage.total` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `container.memory.writeback` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.writeback.enabled`. Only available with cgroups v1 |
| `container.network.io.usage.rx_bytes` | Sum (cumulative, monotonic) | `By` | interface | - |
| `container.network.io.usage.rx_dropped` | Sum (cumulative, monotonic) | `{packets}` | interface | - |
| `container.network.io.usage.rx_errors` | Sum (cumulative, monotonic) | `{errors}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.rx_errors.enabled`. Not supported on Windows. |
| `container.network.io.usage.rx_packets` | Sum (cumulative, monotonic) | `{packets}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.rx_packets.enabled`. |
| `container.network.io.usage.tx_bytes` | Sum (cumulative, monotonic) | `By` | interface | - |
| `container.network.io.usage.tx_dropped` | Sum (cumulative, monotonic) | `{packets}` | interface | - |
| `container.network.io.usage.tx_errors` | Sum (cumulative, monotonic) | `{errors}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.tx_errors.enabled`. Not supported on Windows. |
| `container.network.io.usage.tx_packets` | Sum (cumulative, monotonic) | `{packets}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.tx_packets.enabled`. |
| `container.pids.count` | Sum (cumulative, non-monotonic) | `{pids}` | - | Disabled by default; enable with `metrics.container.pids.count.enabled`. Requires Docker API 1.23+ and a kernel with the pids cgroup. |
| `container.pids.limit` | Sum (cumulative, non-monotonic) | `{pids}` | - | Disabled by default; enable with `metrics.container.pids.limit.enabled`. Requires Docker API 1.23+ and a kernel with the pids cgroup. |
| `container.restarts` | Sum (cumulative, monotonic) | `{restarts}` | - | Disabled by default; enable with `metrics.container.restarts.enabled`. |
| `container.uptime` | Gauge | `s` | - | Disabled by default; enable with `metrics.container.uptime.enabled`. |

## Sources

- `receiver/dockerstatsreceiver/metadata.yaml`
- `receiver/dockerstatsreceiver/receiver.go`
- `receiver/dockerstatsreceiver/metric_helper.go`
- `receiver/dockerstatsreceiver/metric_helper_others.go`
- `receiver/dockerstatsreceiver/metric_helper_windows.go`
- `receiver/dockerstatsreceiver/factory.go`
- `receiver/dockerstatsreceiver/config.go`
- `receiver/dockerstatsreceiver/internal/metadata/generated_metrics.go`
        • v0.159.0.md 12.8 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/dockerstatsreceiver
version: v0.159.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/dockerstatsreceiver
commit_sha: 1120cc0714bf4d14600105e5673c3b00fe87467a
last_verified: 2026-08-24
---

# Docker Stats Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `container.blockio.io_merged_recursive` | Sum (cumulative, monotonic) | `{operations}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_merged_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_queued_recursive` | Sum (cumulative, monotonic) | `{operations}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_queued_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_service_bytes_recursive` | Sum (cumulative, monotonic) | `By` | device_major, device_minor, operation | - |
| `container.blockio.io_service_time_recursive` | Sum (cumulative, monotonic) | `ns` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_service_time_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_serviced_recursive` | Sum (cumulative, monotonic) | `{operations}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_serviced_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_time_recursive` | Sum (cumulative, monotonic) | `ms` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_time_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_wait_time_recursive` | Sum (cumulative, monotonic) | `ns` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_wait_time_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.sectors_recursive` | Sum (cumulative, monotonic) | `{sectors}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.sectors_recursive.enabled`. Only available with cgroups v1 |
| `container.cpu.limit` | Gauge | `{cpus}` | - | Disabled by default; enable with `metrics.container.cpu.limit.enabled`. Only reported if the container has CPU limits set. |
| `container.cpu.logical.count` | Gauge | `{cpus}` | - | Disabled by default; enable with `metrics.container.cpu.logical.count.enabled`. |
| `container.cpu.shares` | Gauge | `1` | - | Disabled by default; enable with `metrics.container.cpu.shares.enabled`. |
| `container.cpu.throttling_data.periods` | Sum (cumulative, monotonic) | `{periods}` | - | Disabled by default; enable with `metrics.container.cpu.throttling_data.periods.enabled`. |
| `container.cpu.throttling_data.throttled_periods` | Sum (cumulative, monotonic) | `{periods}` | - | Disabled by default; enable with `metrics.container.cpu.throttling_data.throttled_periods.enabled`. |
| `container.cpu.throttling_data.throttled_time` | Sum (cumulative, monotonic) | `ns` | - | Disabled by default; enable with `metrics.container.cpu.throttling_data.throttled_time.enabled`. |
| `container.cpu.usage.kernelmode` | Sum (cumulative, monotonic) | `ns` | - | - |
| `container.cpu.usage.percpu` | Sum (cumulative, monotonic) | `ns` | core | Disabled by default; enable with `metrics.container.cpu.usage.percpu.enabled`. Only available with cgroups v1 |
| `container.cpu.usage.system` | Sum (cumulative, monotonic) | `ns` | - | Disabled by default; enable with `metrics.container.cpu.usage.system.enabled`. |
| `container.cpu.usage.total` | Sum (cumulative, monotonic) | `ns` | - | - |
| `container.cpu.usage.usermode` | Sum (cumulative, monotonic) | `ns` | - | - |
| `container.cpu.utilization` | Gauge | `1` | - | - |
| `container.memory.active_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.active_anon.enabled`. |
| `container.memory.active_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.active_file.enabled`. |
| `container.memory.anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.anon.enabled`. Only available with cgroups v2 |
| `container.memory.cache` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.cache.enabled`. Only available with cgroups v1 |
| `container.memory.dirty` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.dirty.enabled`. Only available with cgroups v1 |
| `container.memory.fails` | Sum (cumulative, monotonic) | `{fails}` | - | Disabled by default; enable with `metrics.container.memory.fails.enabled`. |
| `container.memory.file` | Sum (cumulative, non-monotonic) | `By` | - | Only available with cgroups v2 |
| `container.memory.hierarchical_memory_limit` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.hierarchical_memory_limit.enabled`. Only available with cgroups v1 |
| `container.memory.hierarchical_memsw_limit` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.hierarchical_memsw_limit.enabled`. Only available with cgroups v1 |
| `container.memory.inactive_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.inactive_anon.enabled`. |
| `container.memory.inactive_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.inactive_file.enabled`. |
| `container.memory.mapped_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.mapped_file.enabled`. Only available with cgroups v1 |
| `container.memory.percent` | Gauge | `1` | - | Not supported on Windows. |
| `container.memory.pgfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.pgfault.enabled`. |
| `container.memory.pgmajfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.pgmajfault.enabled`. |
| `container.memory.pgpgin` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.pgpgin.enabled`. Only available with cgroups v1 |
| `container.memory.pgpgout` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.pgpgout.enabled`. Only available with cgroups v1 |
| `container.memory.rss` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.rss.enabled`. Only available with cgroups v1 |
| `container.memory.rss_huge` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.rss_huge.enabled`. Only available with cgroups v1 |
| `container.memory.total_active_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_active_anon.enabled`. Only available with cgroups v1 |
| `container.memory.total_active_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_active_file.enabled`. Only available with cgroups v1 |
| `container.memory.total_cache` | Sum (cumulative, non-monotonic) | `By` | - | Only available with cgroups v1 |
| `container.memory.total_dirty` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_dirty.enabled`. Only available with cgroups v1 |
| `container.memory.total_inactive_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_inactive_anon.enabled`. Only available with cgroups v1 |
| `container.memory.total_inactive_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_inactive_file.enabled`. Only available with cgroups v1 |
| `container.memory.total_mapped_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_mapped_file.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.total_pgfault.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgmajfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.total_pgmajfault.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgpgin` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.total_pgpgin.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgpgout` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.total_pgpgout.enabled`. Only available with cgroups v1 |
| `container.memory.total_rss` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_rss.enabled`. Only available with cgroups v1 |
| `container.memory.total_rss_huge` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_rss_huge.enabled`. Only available with cgroups v1 |
| `container.memory.total_unevictable` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_unevictable.enabled`. Only available with cgroups v1 |
| `container.memory.total_writeback` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_writeback.enabled`. Only available with cgroups v1 |
| `container.memory.unevictable` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.unevictable.enabled`. |
| `container.memory.usage.limit` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `container.memory.usage.max` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.usage.max.enabled`. |
| `container.memory.usage.total` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `container.memory.writeback` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.writeback.enabled`. Only available with cgroups v1 |
| `container.network.io.usage.rx_bytes` | Sum (cumulative, monotonic) | `By` | interface | - |
| `container.network.io.usage.rx_dropped` | Sum (cumulative, monotonic) | `{packets}` | interface | - |
| `container.network.io.usage.rx_errors` | Sum (cumulative, monotonic) | `{errors}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.rx_errors.enabled`. Not supported on Windows. |
| `container.network.io.usage.rx_packets` | Sum (cumulative, monotonic) | `{packets}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.rx_packets.enabled`. |
| `container.network.io.usage.tx_bytes` | Sum (cumulative, monotonic) | `By` | interface | - |
| `container.network.io.usage.tx_dropped` | Sum (cumulative, monotonic) | `{packets}` | interface | - |
| `container.network.io.usage.tx_errors` | Sum (cumulative, monotonic) | `{errors}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.tx_errors.enabled`. Not supported on Windows. |
| `container.network.io.usage.tx_packets` | Sum (cumulative, monotonic) | `{packets}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.tx_packets.enabled`. |
| `container.pids.count` | Sum (cumulative, non-monotonic) | `{pids}` | - | Disabled by default; enable with `metrics.container.pids.count.enabled`. Requires Docker API 1.23+ and a kernel with the pids cgroup. |
| `container.pids.limit` | Sum (cumulative, non-monotonic) | `{pids}` | - | Disabled by default; enable with `metrics.container.pids.limit.enabled`. Requires Docker API 1.23+ and a kernel with the pids cgroup. |
| `container.restarts` | Sum (cumulative, monotonic) | `{restarts}` | - | Disabled by default; enable with `metrics.container.restarts.enabled`. |
| `container.uptime` | Gauge | `s` | - | Disabled by default; enable with `metrics.container.uptime.enabled`. |

## Sources

- `receiver/dockerstatsreceiver/metadata.yaml`
- `receiver/dockerstatsreceiver/receiver.go`
- `receiver/dockerstatsreceiver/metric_helper.go`
- `receiver/dockerstatsreceiver/metric_helper_others.go`
- `receiver/dockerstatsreceiver/metric_helper_windows.go`
- `receiver/dockerstatsreceiver/factory.go`
- `receiver/dockerstatsreceiver/config.go`
- `receiver/dockerstatsreceiver/internal/metadata/generated_metrics.go`
        • v0.160.0.md 13.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/dockerstatsreceiver
version: v0.160.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/dockerstatsreceiver
commit_sha: 982f20b8a8e8a2569fab3e27cf8b008e8a5080c1
last_verified: 2026-09-03
---

# Docker Stats Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `container.blockio.io_merged_recursive` | Sum (cumulative, monotonic) | `{operations}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_merged_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_queued_recursive` | Sum (cumulative, monotonic) | `{operations}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_queued_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_service_bytes_recursive` | Sum (cumulative, monotonic) | `By` | device_major, device_minor, operation | - |
| `container.blockio.io_service_time_recursive` | Sum (cumulative, monotonic) | `ns` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_service_time_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_serviced_recursive` | Sum (cumulative, monotonic) | `{operations}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_serviced_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_time_recursive` | Sum (cumulative, monotonic) | `ms` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_time_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_wait_time_recursive` | Sum (cumulative, monotonic) | `ns` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_wait_time_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.sectors_recursive` | Sum (cumulative, monotonic) | `{sectors}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.sectors_recursive.enabled`. Only available with cgroups v1 |
| `container.cpu.limit` | Gauge | `{cpus}` | - | Disabled by default; enable with `metrics.container.cpu.limit.enabled`. Only reported if the container has CPU limits set. |
| `container.cpu.logical.count` | Gauge | `{cpus}` | - | Disabled by default; enable with `metrics.container.cpu.logical.count.enabled`. |
| `container.cpu.shares` | Gauge | `1` | - | Disabled by default; enable with `metrics.container.cpu.shares.enabled`. |
| `container.cpu.throttling_data.periods` | Sum (cumulative, monotonic) | `{periods}` | - | Disabled by default; enable with `metrics.container.cpu.throttling_data.periods.enabled`. |
| `container.cpu.throttling_data.throttled_periods` | Sum (cumulative, monotonic) | `{periods}` | - | Disabled by default; enable with `metrics.container.cpu.throttling_data.throttled_periods.enabled`. |
| `container.cpu.throttling_data.throttled_time` | Sum (cumulative, monotonic) | `ns` | - | Disabled by default; enable with `metrics.container.cpu.throttling_data.throttled_time.enabled`. |
| `container.cpu.usage.kernelmode` | Sum (cumulative, monotonic) | `ns` | - | - |
| `container.cpu.usage.percpu` | Sum (cumulative, monotonic) | `ns` | core | Disabled by default; enable with `metrics.container.cpu.usage.percpu.enabled`. Only available with cgroups v1 |
| `container.cpu.usage.system` | Sum (cumulative, monotonic) | `ns` | - | Disabled by default; enable with `metrics.container.cpu.usage.system.enabled`. |
| `container.cpu.usage.total` | Sum (cumulative, monotonic) | `ns` | - | - |
| `container.cpu.usage.usermode` | Sum (cumulative, monotonic) | `ns` | - | - |
| `container.cpu.utilization` | Gauge | `1` | - | - |
| `container.memory.active_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.active_anon.enabled`. |
| `container.memory.active_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.active_file.enabled`. |
| `container.memory.anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.anon.enabled`. Only available with cgroups v2 |
| `container.memory.cache` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.cache.enabled`. Only available with cgroups v1 |
| `container.memory.dirty` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.dirty.enabled`. Only available with cgroups v1 |
| `container.memory.fails` | Sum (cumulative, monotonic) | `{fails}` | - | Disabled by default; enable with `metrics.container.memory.fails.enabled`. |
| `container.memory.file` | Sum (cumulative, non-monotonic) | `By` | - | Only available with cgroups v2 |
| `container.memory.hierarchical_memory_limit` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.hierarchical_memory_limit.enabled`. Only available with cgroups v1 |
| `container.memory.hierarchical_memsw_limit` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.hierarchical_memsw_limit.enabled`. Only available with cgroups v1 |
| `container.memory.inactive_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.inactive_anon.enabled`. |
| `container.memory.inactive_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.inactive_file.enabled`. |
| `container.memory.mapped_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.mapped_file.enabled`. Only available with cgroups v1 |
| `container.memory.percent` | Gauge | `1` | - | Not supported on Windows. |
| `container.memory.pgfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.pgfault.enabled`. |
| `container.memory.pgmajfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.pgmajfault.enabled`. |
| `container.memory.pgpgin` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.pgpgin.enabled`. Only available with cgroups v1 |
| `container.memory.pgpgout` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.pgpgout.enabled`. Only available with cgroups v1 |
| `container.memory.rss` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.rss.enabled`. Only available with cgroups v1 |
| `container.memory.rss_huge` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.rss_huge.enabled`. Only available with cgroups v1 |
| `container.memory.total_active_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_active_anon.enabled`. Only available with cgroups v1 |
| `container.memory.total_active_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_active_file.enabled`. Only available with cgroups v1 |
| `container.memory.total_cache` | Sum (cumulative, non-monotonic) | `By` | - | Only available with cgroups v1 |
| `container.memory.total_dirty` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_dirty.enabled`. Only available with cgroups v1 |
| `container.memory.total_inactive_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_inactive_anon.enabled`. Only available with cgroups v1 |
| `container.memory.total_inactive_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_inactive_file.enabled`. Only available with cgroups v1 |
| `container.memory.total_mapped_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_mapped_file.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.total_pgfault.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgmajfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.total_pgmajfault.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgpgin` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.total_pgpgin.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgpgout` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.total_pgpgout.enabled`. Only available with cgroups v1 |
| `container.memory.total_rss` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_rss.enabled`. Only available with cgroups v1 |
| `container.memory.total_rss_huge` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_rss_huge.enabled`. Only available with cgroups v1 |
| `container.memory.total_unevictable` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_unevictable.enabled`. Only available with cgroups v1 |
| `container.memory.total_writeback` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_writeback.enabled`. Only available with cgroups v1 |
| `container.memory.unevictable` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.unevictable.enabled`. |
| `container.memory.usage.limit` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `container.memory.usage.max` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.usage.max.enabled`. |
| `container.memory.usage.total` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `container.memory.writeback` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.writeback.enabled`. Only available with cgroups v1 |
| `container.network.io.usage.rx_bytes` | Sum (cumulative, monotonic) | `By` | interface | - |
| `container.network.io.usage.rx_dropped` | Sum (cumulative, monotonic) | `{packets}` | interface | - |
| `container.network.io.usage.rx_errors` | Sum (cumulative, monotonic) | `{errors}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.rx_errors.enabled`. Not supported on Windows. |
| `container.network.io.usage.rx_packets` | Sum (cumulative, monotonic) | `{packets}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.rx_packets.enabled`. |
| `container.network.io.usage.tx_bytes` | Sum (cumulative, monotonic) | `By` | interface | - |
| `container.network.io.usage.tx_dropped` | Sum (cumulative, monotonic) | `{packets}` | interface | - |
| `container.network.io.usage.tx_errors` | Sum (cumulative, monotonic) | `{errors}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.tx_errors.enabled`. Not supported on Windows. |
| `container.network.io.usage.tx_packets` | Sum (cumulative, monotonic) | `{packets}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.tx_packets.enabled`. |
| `container.pids.count` | Sum (cumulative, non-monotonic) | `{pids}` | - | Disabled by default; enable with `metrics.container.pids.count.enabled`. Requires Docker API 1.23+ and a kernel with the pids cgroup. |
| `container.pids.limit` | Sum (cumulative, non-monotonic) | `{pids}` | - | Disabled by default; enable with `metrics.container.pids.limit.enabled`. Requires Docker API 1.23+ and a kernel with the pids cgroup. |
| `container.restarts` | Sum (cumulative, monotonic) | `{restarts}` | - | Disabled by default; enable with `metrics.container.restarts.enabled`. |
| `container.state.health.status` | Sum (cumulative, non-monotonic) | `{container}` | `container.state.health.state` | Disabled by default; reports all health states with only the current state non-zero. |
| `container.state.status` | Sum (cumulative, non-monotonic) | `{status}` | `container.state.status` | Disabled by default; reports all container states with only the current state non-zero. |
| `container.uptime` | Gauge | `s` | - | Disabled by default; enable with `metrics.container.uptime.enabled`. |

## Sources

- `receiver/dockerstatsreceiver/metadata.yaml`
- `receiver/dockerstatsreceiver/receiver.go`
- `receiver/dockerstatsreceiver/metric_helper.go`
- `receiver/dockerstatsreceiver/metric_helper_others.go`
- `receiver/dockerstatsreceiver/metric_helper_windows.go`
- `receiver/dockerstatsreceiver/factory.go`
- `receiver/dockerstatsreceiver/config.go`
- `receiver/dockerstatsreceiver/internal/metadata/generated_metrics.go`
        • v0.161.0.md 13.3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/dockerstatsreceiver
version: v0.161.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/dockerstatsreceiver
commit_sha: 3f8455d8038a985398861171e5310bc9b4e988b2
last_verified: 2026-10-03
---

# Docker Stats Receiver

Upstream `metadata.yaml` lists `darwin` and `windows` as unsupported platforms for this receiver.

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `container.blockio.io_merged_recursive` | Sum (cumulative, monotonic) | `{operations}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_merged_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_queued_recursive` | Sum (cumulative, monotonic) | `{operations}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_queued_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_service_bytes_recursive` | Sum (cumulative, monotonic) | `By` | device_major, device_minor, operation | - |
| `container.blockio.io_service_time_recursive` | Sum (cumulative, monotonic) | `ns` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_service_time_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_serviced_recursive` | Sum (cumulative, monotonic) | `{operations}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_serviced_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_time_recursive` | Sum (cumulative, monotonic) | `ms` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_time_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_wait_time_recursive` | Sum (cumulative, monotonic) | `ns` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_wait_time_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.sectors_recursive` | Sum (cumulative, monotonic) | `{sectors}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.sectors_recursive.enabled`. Only available with cgroups v1 |
| `container.cpu.limit` | Gauge | `{cpus}` | - | Disabled by default; enable with `metrics.container.cpu.limit.enabled`. Only reported if the container has CPU limits set. |
| `container.cpu.logical.count` | Gauge | `{cpus}` | - | Disabled by default; enable with `metrics.container.cpu.logical.count.enabled`. |
| `container.cpu.shares` | Gauge | `1` | - | Disabled by default; enable with `metrics.container.cpu.shares.enabled`. |
| `container.cpu.throttling_data.periods` | Sum (cumulative, monotonic) | `{periods}` | - | Disabled by default; enable with `metrics.container.cpu.throttling_data.periods.enabled`. |
| `container.cpu.throttling_data.throttled_periods` | Sum (cumulative, monotonic) | `{periods}` | - | Disabled by default; enable with `metrics.container.cpu.throttling_data.throttled_periods.enabled`. |
| `container.cpu.throttling_data.throttled_time` | Sum (cumulative, monotonic) | `ns` | - | Disabled by default; enable with `metrics.container.cpu.throttling_data.throttled_time.enabled`. |
| `container.cpu.usage.kernelmode` | Sum (cumulative, monotonic) | `ns` | - | - |
| `container.cpu.usage.percpu` | Sum (cumulative, monotonic) | `ns` | core | Disabled by default; enable with `metrics.container.cpu.usage.percpu.enabled`. Only available with cgroups v1 |
| `container.cpu.usage.system` | Sum (cumulative, monotonic) | `ns` | - | Disabled by default; enable with `metrics.container.cpu.usage.system.enabled`. |
| `container.cpu.usage.total` | Sum (cumulative, monotonic) | `ns` | - | - |
| `container.cpu.usage.usermode` | Sum (cumulative, monotonic) | `ns` | - | - |
| `container.cpu.utilization` | Gauge | `1` | - | - |
| `container.memory.active_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.active_anon.enabled`. |
| `container.memory.active_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.active_file.enabled`. |
| `container.memory.anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.anon.enabled`. Only available with cgroups v2 |
| `container.memory.cache` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.cache.enabled`. Only available with cgroups v1 |
| `container.memory.dirty` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.dirty.enabled`. Only available with cgroups v1 |
| `container.memory.fails` | Sum (cumulative, monotonic) | `{fails}` | - | Disabled by default; enable with `metrics.container.memory.fails.enabled`. |
| `container.memory.file` | Sum (cumulative, non-monotonic) | `By` | - | Only available with cgroups v2 |
| `container.memory.hierarchical_memory_limit` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.hierarchical_memory_limit.enabled`. Only available with cgroups v1 |
| `container.memory.hierarchical_memsw_limit` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.hierarchical_memsw_limit.enabled`. Only available with cgroups v1 |
| `container.memory.inactive_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.inactive_anon.enabled`. |
| `container.memory.inactive_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.inactive_file.enabled`. |
| `container.memory.mapped_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.mapped_file.enabled`. Only available with cgroups v1 |
| `container.memory.percent` | Gauge | `1` | - | Not supported on Windows. |
| `container.memory.pgfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.pgfault.enabled`. |
| `container.memory.pgmajfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.pgmajfault.enabled`. |
| `container.memory.pgpgin` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.pgpgin.enabled`. Only available with cgroups v1 |
| `container.memory.pgpgout` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.pgpgout.enabled`. Only available with cgroups v1 |
| `container.memory.rss` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.rss.enabled`. Only available with cgroups v1 |
| `container.memory.rss_huge` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.rss_huge.enabled`. Only available with cgroups v1 |
| `container.memory.total_active_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_active_anon.enabled`. Only available with cgroups v1 |
| `container.memory.total_active_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_active_file.enabled`. Only available with cgroups v1 |
| `container.memory.total_cache` | Sum (cumulative, non-monotonic) | `By` | - | Only available with cgroups v1 |
| `container.memory.total_dirty` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_dirty.enabled`. Only available with cgroups v1 |
| `container.memory.total_inactive_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_inactive_anon.enabled`. Only available with cgroups v1 |
| `container.memory.total_inactive_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_inactive_file.enabled`. Only available with cgroups v1 |
| `container.memory.total_mapped_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_mapped_file.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.total_pgfault.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgmajfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.total_pgmajfault.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgpgin` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.total_pgpgin.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgpgout` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.total_pgpgout.enabled`. Only available with cgroups v1 |
| `container.memory.total_rss` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_rss.enabled`. Only available with cgroups v1 |
| `container.memory.total_rss_huge` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_rss_huge.enabled`. Only available with cgroups v1 |
| `container.memory.total_unevictable` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_unevictable.enabled`. Only available with cgroups v1 |
| `container.memory.total_writeback` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_writeback.enabled`. Only available with cgroups v1 |
| `container.memory.unevictable` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.unevictable.enabled`. |
| `container.memory.usage.limit` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `container.memory.usage.max` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.usage.max.enabled`. |
| `container.memory.usage.total` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `container.memory.writeback` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.writeback.enabled`. Only available with cgroups v1 |
| `container.network.io.usage.rx_bytes` | Sum (cumulative, monotonic) | `By` | interface | - |
| `container.network.io.usage.rx_dropped` | Sum (cumulative, monotonic) | `{packets}` | interface | - |
| `container.network.io.usage.rx_errors` | Sum (cumulative, monotonic) | `{errors}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.rx_errors.enabled`. Not supported on Windows. |
| `container.network.io.usage.rx_packets` | Sum (cumulative, monotonic) | `{packets}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.rx_packets.enabled`. |
| `container.network.io.usage.tx_bytes` | Sum (cumulative, monotonic) | `By` | interface | - |
| `container.network.io.usage.tx_dropped` | Sum (cumulative, monotonic) | `{packets}` | interface | - |
| `container.network.io.usage.tx_errors` | Sum (cumulative, monotonic) | `{errors}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.tx_errors.enabled`. Not supported on Windows. |
| `container.network.io.usage.tx_packets` | Sum (cumulative, monotonic) | `{packets}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.tx_packets.enabled`. |
| `container.pids.count` | Sum (cumulative, non-monotonic) | `{pids}` | - | Disabled by default; enable with `metrics.container.pids.count.enabled`. Requires Docker API 1.23+ and a kernel with the pids cgroup. |
| `container.pids.limit` | Sum (cumulative, non-monotonic) | `{pids}` | - | Disabled by default; enable with `metrics.container.pids.limit.enabled`. Requires Docker API 1.23+ and a kernel with the pids cgroup. |
| `container.restarts` | Sum (cumulative, monotonic) | `{restarts}` | - | Disabled by default; enable with `metrics.container.restarts.enabled`. |
| `container.state.health.status` | Sum (cumulative, non-monotonic) | `{container}` | `container.state.health.state` | Disabled by default; reports all health states with only the current state non-zero. |
| `container.state.status` | Sum (cumulative, non-monotonic) | `{status}` | `container.state.status` | Disabled by default; reports all container states with only the current state non-zero. |
| `container.uptime` | Gauge | `s` | - | Disabled by default; enable with `metrics.container.uptime.enabled`. |

## Sources

- `receiver/dockerstatsreceiver/metadata.yaml`
- `receiver/dockerstatsreceiver/receiver.go`
- `receiver/dockerstatsreceiver/metric_helper.go`
- `receiver/dockerstatsreceiver/metric_helper_others.go`
- `receiver/dockerstatsreceiver/metric_helper_windows.go`
- `receiver/dockerstatsreceiver/factory.go`
- `receiver/dockerstatsreceiver/config.go`
- `receiver/dockerstatsreceiver/internal/metadata/generated_metrics.go`
        • v0.162.0.md 13.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/dockerstatsreceiver
version: v0.162.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/dockerstatsreceiver
commit_sha: ae8c507510f48f433ab47dd1c6b01a59d6c388b5
last_verified: 2026-10-03
---

# Docker Stats Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `container.blockio.io_merged_recursive` | Sum (cumulative, monotonic) | `{operations}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_merged_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_queued_recursive` | Sum (cumulative, monotonic) | `{operations}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_queued_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_service_bytes_recursive` | Sum (cumulative, monotonic) | `By` | device_major, device_minor, operation | - |
| `container.blockio.io_service_time_recursive` | Sum (cumulative, monotonic) | `ns` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_service_time_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_serviced_recursive` | Sum (cumulative, monotonic) | `{operations}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_serviced_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_time_recursive` | Sum (cumulative, monotonic) | `ms` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_time_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.io_wait_time_recursive` | Sum (cumulative, monotonic) | `ns` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.io_wait_time_recursive.enabled`. Only available with cgroups v1 |
| `container.blockio.sectors_recursive` | Sum (cumulative, monotonic) | `{sectors}` | device_major, device_minor, operation | Disabled by default; enable with `metrics.container.blockio.sectors_recursive.enabled`. Only available with cgroups v1 |
| `container.cpu.limit` | Gauge | `{cpus}` | - | Disabled by default; enable with `metrics.container.cpu.limit.enabled`. Only reported if the container has CPU limits set. |
| `container.cpu.logical.count` | Gauge | `{cpus}` | - | Disabled by default; enable with `metrics.container.cpu.logical.count.enabled`. |
| `container.cpu.shares` | Gauge | `1` | - | Disabled by default; enable with `metrics.container.cpu.shares.enabled`. |
| `container.cpu.throttling_data.periods` | Sum (cumulative, monotonic) | `{periods}` | - | Disabled by default; enable with `metrics.container.cpu.throttling_data.periods.enabled`. |
| `container.cpu.throttling_data.throttled_periods` | Sum (cumulative, monotonic) | `{periods}` | - | Disabled by default; enable with `metrics.container.cpu.throttling_data.throttled_periods.enabled`. |
| `container.cpu.throttling_data.throttled_time` | Sum (cumulative, monotonic) | `ns` | - | Disabled by default; enable with `metrics.container.cpu.throttling_data.throttled_time.enabled`. |
| `container.cpu.usage.kernelmode` | Sum (cumulative, monotonic) | `ns` | - | - |
| `container.cpu.usage.percpu` | Sum (cumulative, monotonic) | `ns` | core | Disabled by default; enable with `metrics.container.cpu.usage.percpu.enabled`. Only available with cgroups v1 |
| `container.cpu.usage.system` | Sum (cumulative, monotonic) | `ns` | - | Disabled by default; enable with `metrics.container.cpu.usage.system.enabled`. |
| `container.cpu.usage.total` | Sum (cumulative, monotonic) | `ns` | - | - |
| `container.cpu.usage.usermode` | Sum (cumulative, monotonic) | `ns` | - | - |
| `container.cpu.utilization` | Gauge | `1` | - | - |
| `container.memory.active_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.active_anon.enabled`. |
| `container.memory.active_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.active_file.enabled`. |
| `container.memory.anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.anon.enabled`. Only available with cgroups v2 |
| `container.memory.cache` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.cache.enabled`. Only available with cgroups v1 |
| `container.memory.dirty` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.dirty.enabled`. Only available with cgroups v1 |
| `container.memory.fails` | Sum (cumulative, monotonic) | `{fails}` | - | Disabled by default; enable with `metrics.container.memory.fails.enabled`. |
| `container.memory.file` | Sum (cumulative, non-monotonic) | `By` | - | Only available with cgroups v2 |
| `container.memory.hierarchical_memory_limit` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.hierarchical_memory_limit.enabled`. Only available with cgroups v1 |
| `container.memory.hierarchical_memsw_limit` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.hierarchical_memsw_limit.enabled`. Only available with cgroups v1 |
| `container.memory.inactive_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.inactive_anon.enabled`. |
| `container.memory.inactive_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.inactive_file.enabled`. |
| `container.memory.mapped_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.mapped_file.enabled`. Only available with cgroups v1 |
| `container.memory.percent` | Gauge | `1` | - | Not supported on Windows. |
| `container.memory.pgfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.pgfault.enabled`. |
| `container.memory.pgmajfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.pgmajfault.enabled`. |
| `container.memory.pgpgin` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.pgpgin.enabled`. Only available with cgroups v1 |
| `container.memory.pgpgout` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.pgpgout.enabled`. Only available with cgroups v1 |
| `container.memory.rss` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.rss.enabled`. Only available with cgroups v1 |
| `container.memory.rss_huge` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.rss_huge.enabled`. Only available with cgroups v1 |
| `container.memory.total_active_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_active_anon.enabled`. Only available with cgroups v1 |
| `container.memory.total_active_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_active_file.enabled`. Only available with cgroups v1 |
| `container.memory.total_cache` | Sum (cumulative, non-monotonic) | `By` | - | Only available with cgroups v1 |
| `container.memory.total_dirty` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_dirty.enabled`. Only available with cgroups v1 |
| `container.memory.total_inactive_anon` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_inactive_anon.enabled`. Only available with cgroups v1 |
| `container.memory.total_inactive_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_inactive_file.enabled`. Only available with cgroups v1 |
| `container.memory.total_mapped_file` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_mapped_file.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.total_pgfault.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgmajfault` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.container.memory.total_pgmajfault.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgpgin` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.total_pgpgin.enabled`. Only available with cgroups v1 |
| `container.memory.total_pgpgout` | Sum (cumulative, monotonic) | `{operations}` | - | Disabled by default; enable with `metrics.container.memory.total_pgpgout.enabled`. Only available with cgroups v1 |
| `container.memory.total_rss` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_rss.enabled`. Only available with cgroups v1 |
| `container.memory.total_rss_huge` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_rss_huge.enabled`. Only available with cgroups v1 |
| `container.memory.total_unevictable` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_unevictable.enabled`. Only available with cgroups v1 |
| `container.memory.total_writeback` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.total_writeback.enabled`. Only available with cgroups v1 |
| `container.memory.unevictable` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.unevictable.enabled`. |
| `container.memory.usage.limit` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `container.memory.usage.max` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.usage.max.enabled`. |
| `container.memory.usage.total` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `container.memory.writeback` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.container.memory.writeback.enabled`. Only available with cgroups v1 |
| `container.network.io.usage.rx_bytes` | Sum (cumulative, monotonic) | `By` | interface | - |
| `container.network.io.usage.rx_dropped` | Sum (cumulative, monotonic) | `{packets}` | interface | - |
| `container.network.io.usage.rx_errors` | Sum (cumulative, monotonic) | `{errors}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.rx_errors.enabled`. Not supported on Windows. |
| `container.network.io.usage.rx_packets` | Sum (cumulative, monotonic) | `{packets}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.rx_packets.enabled`. |
| `container.network.io.usage.tx_bytes` | Sum (cumulative, monotonic) | `By` | interface | - |
| `container.network.io.usage.tx_dropped` | Sum (cumulative, monotonic) | `{packets}` | interface | - |
| `container.network.io.usage.tx_errors` | Sum (cumulative, monotonic) | `{errors}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.tx_errors.enabled`. Not supported on Windows. |
| `container.network.io.usage.tx_packets` | Sum (cumulative, monotonic) | `{packets}` | interface | Disabled by default; enable with `metrics.container.network.io.usage.tx_packets.enabled`. |
| `container.pids.count` | Sum (cumulative, non-monotonic) | `{pids}` | - | Disabled by default; enable with `metrics.container.pids.count.enabled`. Requires Docker API 1.23+ and a kernel with the pids cgroup. |
| `container.pids.limit` | Sum (cumulative, non-monotonic) | `{pids}` | - | Disabled by default; enable with `metrics.container.pids.limit.enabled`. Requires Docker API 1.23+ and a kernel with the pids cgroup. |
| `container.restarts` | Sum (cumulative, monotonic) | `{restarts}` | - | Disabled by default; enable with `metrics.container.restarts.enabled`. |
| `container.state.health.status` | Sum (cumulative, non-monotonic) | `{container}` | `container.state.health.state` | Disabled by default; reports all health states with only the current state non-zero. |
| `container.state.status` | Sum (cumulative, non-monotonic) | `{status}` | `container.state.status` | Disabled by default; reports all container states with only the current state non-zero. |
| `container.uptime` | Gauge | `s` | - | Disabled by default; enable with `metrics.container.uptime.enabled`. |

## Sources

- `receiver/dockerstatsreceiver/metadata.yaml`
- `receiver/dockerstatsreceiver/receiver.go`
- `receiver/dockerstatsreceiver/metric_helper.go`
- `receiver/dockerstatsreceiver/metric_helper_others.go`
- `receiver/dockerstatsreceiver/metric_helper_windows.go`
- `receiver/dockerstatsreceiver/factory.go`
- `receiver/dockerstatsreceiver/config.go`
- `receiver/dockerstatsreceiver/internal/metadata/generated_metrics.go`
        • v0.163.0.md 1.8 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/dockerstatsreceiver
version: v0.163.0
scope_name: otelcol/dockerstatsreceiver
commit_sha: df849b5403c041d5e799e7846392a6f18b0b55ae
last_verified: 2026-10-14
---

# Docker Stats Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| container.blockio.io_service_bytes_recursive | Sum (monotonic, cumulative, int) | By | device_major, device_minor, operation | - |
| container.cpu.usage.kernelmode | Sum (monotonic, cumulative, int) | ns | - | - |
| container.cpu.usage.total | Sum (monotonic, cumulative, int) | ns | - | - |
| container.cpu.usage.usermode | Sum (monotonic, cumulative, int) | ns | - | - |
| container.cpu.utilization | Gauge (double) | 1 | - | - |
| container.memory.file | Gauge (int) | By | - | - |
| container.memory.percent | Gauge (double) | 1 | - | - |
| container.memory.total_cache | Gauge (int) | By | - | - |
| container.memory.usage.limit | Gauge (int) | By | - | - |
| container.memory.usage.total | Gauge (int) | By | - | - |
| container.network.io.usage.rx_bytes | Sum (monotonic, cumulative, int) | By | interface | - |
| container.network.io.usage.rx_dropped | Sum (monotonic, cumulative, int) | {packets} | interface | - |
| container.network.io.usage.tx_bytes | Sum (monotonic, cumulative, int) | By | interface | - |
| container.network.io.usage.tx_dropped | Sum (monotonic, cumulative, int) | {packets} | interface | - |

## Sources

- `receiver/dockerstatsreceiver/metadata.yaml`
- `receiver/dockerstatsreceiver/receiver.go`
- `receiver/dockerstatsreceiver/metric_helper.go`
- `receiver/dockerstatsreceiver/metric_helper_others.go`
- `receiver/dockerstatsreceiver/metric_helper_windows.go`
- `receiver/dockerstatsreceiver/internal/metadata/generated_metrics.go`
      • filelogreceiver
        • v0.153.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/filelogreceiver
version: v0.153.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/filelogreceiver
commit_sha: 42f949127580c0d00088b785cd0b35842dc0ddb8
last_verified: 2026-08-11
---

# File Log Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_fileconsumer_open_files` | UpDownCounter | `1` | - | Development stability; emitted by the fileconsumer meter scope. |
| `otelcol_fileconsumer_reading_files` | UpDownCounter | `1` | - | Development stability; emitted by the fileconsumer meter scope. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| File log record | `log.file.name`; `log.file.path`; `log.file.name_resolved`; `log.file.path_resolved`; `log.file.owner.name`; `log.file.owner.group.name`; `log.file.permissions`; `log.file.record_number`; `log.file.record_offset`; user-configured attributes | Attributes are conditional on the file input resolver settings and `include_file_record_number`/`include_file_record_offset`; operators may add or change attributes. The record body contains the read file entry. |

## Sources

- `receiver/filelogreceiver/filelog.go`
- `receiver/filelogreceiver/metadata.yaml`
- `receiver/filelogreceiver/internal/metadata/generated_status.go`
- `pkg/stanza/operator/input/file/input.go`
- `pkg/stanza/fileconsumer/attrs/attrs.go`
- `pkg/stanza/fileconsumer/metadata.yaml`
- `pkg/stanza/fileconsumer/internal/metadata/generated_telemetry.go`
- `pkg/stanza/fileconsumer/file.go`
        • v0.154.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/filelogreceiver
version: v0.154.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/filelogreceiver
commit_sha: 853eda0e12b3ba142552ecd2b63cec07062904f0
last_verified: 2026-08-11
---

# File Log Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_fileconsumer_open_files` | UpDownCounter | `1` | - | Development stability; emitted by the fileconsumer meter scope. |
| `otelcol_fileconsumer_reading_files` | UpDownCounter | `1` | - | Development stability; emitted by the fileconsumer meter scope. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| File log record | `log.file.name`; `log.file.path`; `log.file.name_resolved`; `log.file.path_resolved`; `log.file.owner.name`; `log.file.owner.group.name`; `log.file.permissions`; `log.file.record_number`; `log.file.record_offset`; user-configured attributes | Attributes are conditional on the file input resolver settings and `include_file_record_number`/`include_file_record_offset`; operators may add or change attributes. The record body contains the read file entry. |

## Sources

- `receiver/filelogreceiver/filelog.go`
- `receiver/filelogreceiver/metadata.yaml`
- `receiver/filelogreceiver/internal/metadata/generated_status.go`
- `pkg/stanza/operator/input/file/input.go`
- `pkg/stanza/fileconsumer/attrs/attrs.go`
- `pkg/stanza/fileconsumer/metadata.yaml`
- `pkg/stanza/fileconsumer/internal/metadata/generated_telemetry.go`
- `pkg/stanza/fileconsumer/file.go`
        • v0.155.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/filelogreceiver
version: v0.155.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/filelogreceiver
commit_sha: aaf5045a24c0a6f000225c97ad5449e69aeb5835
last_verified: 2026-08-11
---

# File Log Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_fileconsumer_open_files` | UpDownCounter | `1` | - | Development stability; emitted by the fileconsumer meter scope. |
| `otelcol_fileconsumer_reading_files` | UpDownCounter | `1` | - | Development stability; emitted by the fileconsumer meter scope. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| File log record | `log.file.name`; `log.file.path`; `log.file.name_resolved`; `log.file.path_resolved`; `log.file.owner.name`; `log.file.owner.group.name`; `log.file.permissions`; `log.file.record_number`; `log.file.record_offset`; user-configured attributes | Attributes are conditional on the file input resolver settings and `include_file_record_number`/`include_file_record_offset`; operators may add or change attributes. The record body contains the read file entry. |

## Sources

- `receiver/filelogreceiver/filelog.go`
- `receiver/filelogreceiver/metadata.yaml`
- `receiver/filelogreceiver/internal/metadata/generated_status.go`
- `pkg/stanza/operator/input/file/input.go`
- `pkg/stanza/fileconsumer/attrs/attrs.go`
- `pkg/stanza/fileconsumer/metadata.yaml`
- `pkg/stanza/fileconsumer/internal/metadata/generated_telemetry.go`
- `pkg/stanza/fileconsumer/file.go`
        • v0.156.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/filelogreceiver
version: v0.156.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/filelogreceiver
commit_sha: 41e24cd516dd69a5b4277465cdb2ff4ef0676f49
last_verified: 2026-08-11
---

# File Log Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_fileconsumer_open_files` | UpDownCounter | `1` | - | Development stability; emitted by the fileconsumer meter scope. |
| `otelcol_fileconsumer_reading_files` | UpDownCounter | `1` | - | Development stability; emitted by the fileconsumer meter scope. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| File log record | `log.file.name`; `log.file.path`; `log.file.name_resolved`; `log.file.path_resolved`; `log.file.owner.name`; `log.file.owner.group.name`; `log.file.permissions`; `log.file.record_number`; `log.file.record_offset`; user-configured attributes | Attributes are conditional on the file input resolver settings and `include_file_record_number`/`include_file_record_offset`; operators may add or change attributes. The record body contains the read file entry. |

## Sources

- `receiver/filelogreceiver/filelog.go`
- `receiver/filelogreceiver/metadata.yaml`
- `receiver/filelogreceiver/internal/metadata/generated_status.go`
- `pkg/stanza/operator/input/file/input.go`
- `pkg/stanza/fileconsumer/attrs/attrs.go`
- `pkg/stanza/fileconsumer/metadata.yaml`
- `pkg/stanza/fileconsumer/internal/metadata/generated_telemetry.go`
- `pkg/stanza/fileconsumer/file.go`
        • v0.157.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/filelogreceiver
version: v0.157.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/filelogreceiver
commit_sha: 89e43555904cd97c2d36605347c5d5237b1bdc8c
last_verified: 2026-08-11
---

# File Log Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_fileconsumer_open_files` | UpDownCounter | `1` | - | Development stability; emitted by the fileconsumer meter scope. |
| `otelcol_fileconsumer_reading_files` | UpDownCounter | `1` | - | Development stability; emitted by the fileconsumer meter scope. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| File log record | `log.file.name`; `log.file.path`; `log.file.name_resolved`; `log.file.path_resolved`; `log.file.owner.name`; `log.file.owner.group.name`; `log.file.permissions`; `log.file.record_number`; `log.file.record_offset`; user-configured attributes | Attributes are conditional on the file input resolver settings and `include_file_record_number`/`include_file_record_offset`; operators may add or change attributes. The record body contains the read file entry. |

## Sources

- `receiver/filelogreceiver/filelog.go`
- `receiver/filelogreceiver/metadata.yaml`
- `receiver/filelogreceiver/internal/metadata/generated_status.go`
- `pkg/stanza/operator/input/file/input.go`
- `pkg/stanza/fileconsumer/attrs/attrs.go`
- `pkg/stanza/fileconsumer/metadata.yaml`
- `pkg/stanza/fileconsumer/internal/metadata/generated_telemetry.go`
- `pkg/stanza/fileconsumer/file.go`
        • v0.158.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/filelogreceiver
version: v0.158.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/filelogreceiver
commit_sha: 821a9d9c2c1623c4a0ceba5d47b57c48879c3f84
last_verified: 2026-08-11
---

# File Log Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_fileconsumer_open_files` | UpDownCounter | `1` | - | Development stability; emitted by the fileconsumer meter scope. |
| `otelcol_fileconsumer_reading_files` | UpDownCounter | `1` | - | Development stability; emitted by the fileconsumer meter scope. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| File log record | `log.file.name`; `log.file.path`; `log.file.name_resolved`; `log.file.path_resolved`; `log.file.owner.name`; `log.file.owner.group.name`; `log.file.permissions`; `log.file.record_number`; `log.file.record_offset`; user-configured attributes | Attributes are conditional on the file input resolver settings and `include_file_record_number`/`include_file_record_offset`; operators may add or change attributes. The record body contains the read file entry. |

## Sources

- `receiver/filelogreceiver/filelog.go`
- `receiver/filelogreceiver/metadata.yaml`
- `receiver/filelogreceiver/internal/metadata/generated_status.go`
- `pkg/stanza/operator/input/file/input.go`
- `pkg/stanza/fileconsumer/attrs/attrs.go`
- `pkg/stanza/fileconsumer/metadata.yaml`
- `pkg/stanza/fileconsumer/internal/metadata/generated_telemetry.go`
- `pkg/stanza/fileconsumer/file.go`
        • v0.159.0.md 1.5 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/filelogreceiver
version: v0.159.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/pkg/stanza/fileconsumer
commit_sha: 1120cc0714bf4d14600105e5673c3b00fe87467a
last_verified: null
---

# File Log Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_fileconsumer_open_files` | UpDownCounter | `1` | - | Development stability; emitted by the fileconsumer meter scope. |
| `otelcol_fileconsumer_reading_files` | UpDownCounter | `1` | - | Development stability; emitted by the fileconsumer meter scope. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| File log record | `log.file.name`; `log.file.path`; `log.file.name_resolved`; `log.file.path_resolved`; `log.file.owner.name`; `log.file.owner.group.name`; `log.file.permissions`; `log.file.record_number`; `log.file.record_offset`; user-configured attributes | Attributes are conditional on the file input resolver settings and `include_file_record_number`/`include_file_record_offset`; operators may add or change attributes. The record body contains the read file entry. |

## Sources

- `receiver/filelogreceiver/filelog.go`
- `receiver/filelogreceiver/metadata.yaml`
- `pkg/stanza/operator/input/file/input.go`
- `pkg/stanza/fileconsumer/attrs/attrs.go`
- `pkg/stanza/fileconsumer/metadata.yaml`
- `pkg/stanza/fileconsumer/internal/metadata/generated_telemetry.go`
- `pkg/stanza/fileconsumer/file.go`
        • v0.160.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/filelogreceiver
version: v0.160.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/filelogreceiver
commit_sha: 982f20b8a8e8a2569fab3e27cf8b008e8a5080c1
last_verified: 2026-09-03
---

# File Log Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_fileconsumer_open_files` | UpDownCounter | `1` | - | Development stability; emitted by the fileconsumer meter scope. |
| `otelcol_fileconsumer_reading_files` | UpDownCounter | `1` | - | Development stability; emitted by the fileconsumer meter scope. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| File log record | `log.file.name`; `log.file.path`; `log.file.name_resolved`; `log.file.path_resolved`; `log.file.owner.name`; `log.file.owner.group.name`; `log.file.permissions`; `log.file.record_number`; `log.file.record_offset`; user-configured attributes | Attributes are conditional on the file input resolver settings and `include_file_record_number`/`include_file_record_offset`; operators may add or change attributes. The record body contains the read file entry. |

## Sources

- `receiver/filelogreceiver/filelog.go`
- `receiver/filelogreceiver/metadata.yaml`
- `receiver/filelogreceiver/internal/metadata/generated_status.go`
- `pkg/stanza/operator/input/file/input.go`
- `pkg/stanza/fileconsumer/attrs/attrs.go`
- `pkg/stanza/fileconsumer/metadata.yaml`
- `pkg/stanza/fileconsumer/internal/metadata/generated_telemetry.go`
- `pkg/stanza/fileconsumer/file.go`
        • v0.161.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/filelogreceiver
version: v0.161.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/filelogreceiver
commit_sha: 3f8455d8038a985398861171e5310bc9b4e988b2
last_verified: 2026-10-03
---

# File Log Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_fileconsumer_open_files` | UpDownCounter | `1` | - | Development stability; emitted by the fileconsumer meter scope. |
| `otelcol_fileconsumer_reading_files` | UpDownCounter | `1` | - | Development stability; emitted by the fileconsumer meter scope. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| File log record | `log.file.name`; `log.file.path`; `log.file.name_resolved`; `log.file.path_resolved`; `log.file.owner.name`; `log.file.owner.group.name`; `log.file.permissions`; `log.file.record_number`; `log.file.record_offset`; user-configured attributes | Attributes are conditional on the file input resolver settings and `include_file_record_number`/`include_file_record_offset`; operators may add or change attributes. The record body contains the read file entry. |

## Sources

- `receiver/filelogreceiver/filelog.go`
- `receiver/filelogreceiver/metadata.yaml`
- `receiver/filelogreceiver/internal/metadata/generated_status.go`
- `pkg/stanza/operator/input/file/input.go`
- `pkg/stanza/fileconsumer/attrs/attrs.go`
- `pkg/stanza/fileconsumer/metadata.yaml`
- `pkg/stanza/fileconsumer/internal/metadata/generated_telemetry.go`
- `pkg/stanza/fileconsumer/file.go`
        • v0.162.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/filelogreceiver
version: v0.162.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/filelogreceiver
commit_sha: ae8c507510f48f433ab47dd1c6b01a59d6c388b5
last_verified: 2026-10-03
---

# File Log Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_fileconsumer_open_files` | UpDownCounter | `1` | - | Development stability; emitted by the fileconsumer meter scope. |
| `otelcol_fileconsumer_reading_files` | UpDownCounter | `1` | - | Development stability; emitted by the fileconsumer meter scope. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| File log record | `log.file.name`; `log.file.path`; `log.file.name_resolved`; `log.file.path_resolved`; `log.file.owner.name`; `log.file.owner.group.name`; `log.file.permissions`; `log.file.record_number`; `log.file.record_offset`; user-configured attributes | Attributes are conditional on the file input resolver settings and `include_file_record_number`/`include_file_record_offset`; operators may add or change attributes. The record body contains the read file entry. |

## Sources

- `receiver/filelogreceiver/filelog.go`
- `receiver/filelogreceiver/metadata.yaml`
- `receiver/filelogreceiver/internal/metadata/generated_status.go`
- `pkg/stanza/operator/input/file/input.go`
- `pkg/stanza/fileconsumer/attrs/attrs.go`
- `pkg/stanza/fileconsumer/metadata.yaml`
- `pkg/stanza/fileconsumer/internal/metadata/generated_telemetry.go`
- `pkg/stanza/fileconsumer/file.go`
        • v0.163.0.md 1.5 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/filelogreceiver
version: v0.163.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/pkg/stanza/fileconsumer
commit_sha: df849b5403c041d5e799e7846392a6f18b0b55ae
last_verified: null
---

# File Log Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_fileconsumer_open_files` | UpDownCounter | `1` | - | Development stability; emitted by the fileconsumer meter scope. |
| `otelcol_fileconsumer_reading_files` | UpDownCounter | `1` | - | Development stability; emitted by the fileconsumer meter scope. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| File log record | `log.file.name`; `log.file.path`; `log.file.name_resolved`; `log.file.path_resolved`; `log.file.owner.name`; `log.file.owner.group.name`; `log.file.permissions`; `log.file.record_number`; `log.file.record_offset`; user-configured attributes | Attributes are conditional on the file input resolver settings and `include_file_record_number`/`include_file_record_offset`; operators may add or change attributes. The record body contains the read file entry. |

## Sources

- `receiver/filelogreceiver/filelog.go`
- `receiver/filelogreceiver/metadata.yaml`
- `pkg/stanza/operator/input/file/input.go`
- `pkg/stanza/fileconsumer/attrs/attrs.go`
- `pkg/stanza/fileconsumer/metadata.yaml`
- `pkg/stanza/fileconsumer/internal/metadata/generated_telemetry.go`
- `pkg/stanza/fileconsumer/file.go`
      • hostmetricsreceiver
        • v0.153.0.md 8.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/hostmetricsreceiver
version: v0.153.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/hostmetricsreceiver
commit_sha: 42f949127580c0d00088b785cd0b35842dc0ddb8
last_verified: 2026-08-11
---

# Host Metrics Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|
| nfs.client.net.count | Sum (cumulative, monotonic) | {record} | network.transport | - |
| nfs.client.net.tcp.connection.accepted | Sum (cumulative, monotonic) | {connection} | - | - |
| nfs.client.operation.count | Sum (cumulative, monotonic) | {operation} | onc_rpc.version, nfs.operation.name | - |
| nfs.client.procedure.count | Sum (cumulative, monotonic) | {procedure} | onc_rpc.version, onc_rpc.procedure.name | - |
| nfs.client.rpc.authrefresh.count | Sum (cumulative, monotonic) | {authrefresh} | - | - |
| nfs.client.rpc.count | Sum (cumulative, monotonic) | {request} | - | - |
| nfs.client.rpc.retransmit.count | Sum (cumulative, monotonic) | {retransmit} | - | - |
| nfs.server.fh.stale.count | Sum (cumulative, monotonic) | {fh} | - | - |
| nfs.server.io | Sum (cumulative, monotonic) | By | network.io.direction | - |
| nfs.server.net.count | Sum (cumulative, monotonic) | {request} | network.transport | - |
| nfs.server.net.tcp.connection.accepted | Sum (cumulative, monotonic) | {connection} | - | - |
| nfs.server.operation.count | Sum (cumulative, monotonic) | {operation} | onc_rpc.version, nfs.operation.name | - |
| nfs.server.procedure.count | Sum (cumulative, monotonic) | {procedure} | onc_rpc.version, onc_rpc.procedure.name | - |
| nfs.server.repcache.requests | Sum (cumulative, monotonic) | {request} | nfs.server.repcache.status | - |
| nfs.server.rpc.count | Sum (cumulative, monotonic) | {request} | error.type | - |
| nfs.server.thread.count | Sum (cumulative, non-monotonic) | {thread} | - | - |
| process.context_switches | Sum (cumulative, monotonic) | {count} | context_switch_type | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.cpu.time | Sum (cumulative, monotonic) | s | state | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.cpu.utilization | Gauge | 1 | state | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.disk.io | Sum (cumulative, monotonic) | By | direction | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.disk.operations | Sum (cumulative, monotonic) | {operations} | direction | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.handles | Sum (cumulative, non-monotonic) | {count} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.usage | Sum (cumulative, non-monotonic) | By | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.utilization | Gauge | 1 | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.virtual | Sum (cumulative, non-monotonic) | By | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.open_file_descriptors | Sum (cumulative, non-monotonic) | {count} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.paging.faults | Sum (cumulative, monotonic) | {faults} | paging_fault_type | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.signals_pending | Sum (cumulative, non-monotonic) | {signals} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.threads | Sum (cumulative, non-monotonic) | {threads} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.uptime | Gauge | s | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| system.cpu.frequency | Gauge | Hz | cpu | - |
| system.cpu.load_average.15m | Gauge | {thread} | - | - |
| system.cpu.load_average.1m | Gauge | {thread} | - | - |
| system.cpu.load_average.5m | Gauge | {thread} | - | - |
| system.cpu.logical.count | Sum (cumulative, non-monotonic) | {cpu} | - | - |
| system.cpu.physical.count | Sum (cumulative, non-monotonic) | {cpu} | - | - |
| system.cpu.time | Sum (cumulative, monotonic) | s | cpu, state | - |
| system.cpu.utilization | Gauge | 1 | cpu, state | - |
| system.disk.io | Sum (cumulative, monotonic) | By | device, direction | - |
| system.disk.io_time | Sum (cumulative, monotonic) | s | device | - |
| system.disk.merged | Sum (cumulative, monotonic) | {operations} | device, direction | - |
| system.disk.operation_time | Sum (cumulative, monotonic) | s | device, direction | - |
| system.disk.operations | Sum (cumulative, monotonic) | {operations} | device, direction | - |
| system.disk.pending_operations | Sum (cumulative, non-monotonic) | {operations} | device | - |
| system.disk.weighted_io_time | Sum (cumulative, monotonic) | s | device | - |
| system.filesystem.inodes.usage | Sum (cumulative, non-monotonic) | {inodes} | device, mode, mountpoint, type, state | - |
| system.filesystem.usage | Sum (cumulative, non-monotonic) | By | device, mode, mountpoint, type, state | - |
| system.filesystem.utilization | Gauge | 1 | device, mode, mountpoint, type | - |
| system.linux.memory.available | Sum (cumulative, non-monotonic) | By | - | - |
| system.linux.memory.dirty | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.limit | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.linux.hugepages.limit | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.page_size | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.linux.hugepages.reserved | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.surplus | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.usage | Sum (cumulative, non-monotonic) | {page} | system.memory.linux.hugepages.state | - |
| system.memory.linux.hugepages.utilization | Gauge | 1 | system.memory.linux.hugepages.state | - |
| system.memory.linux.shared | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.page_size | Gauge | By | - | - |
| system.memory.usage | Sum (cumulative, non-monotonic) | By | state | Scraper and metric must be enabled; Linux value selection is gated by `receiver.hostmetricsreceiver.UseLinuxMemAvailable`. |
| system.memory.utilization | Gauge | 1 | state | Scraper and metric must be enabled; Linux value selection is gated by `receiver.hostmetricsreceiver.UseLinuxMemAvailable`. |
| system.network.connections | Sum (cumulative, non-monotonic) | {connections} | protocol, state | - |
| system.network.conntrack.count | Sum (cumulative, non-monotonic) | {entries} | - | - |
| system.network.conntrack.max | Sum (cumulative, non-monotonic) | {entries} | - | - |
| system.network.dropped | Sum (cumulative, monotonic) | {packets} | device, direction | - |
| system.network.errors | Sum (cumulative, monotonic) | {errors} | device, direction | - |
| system.network.io | Sum (cumulative, monotonic) | By | device, direction | - |
| system.network.packets | Sum (cumulative, monotonic) | {packets} | device, direction | - |
| system.paging.faults | Sum (cumulative, monotonic) | {faults} | type | - |
| system.paging.operations | Sum (cumulative, monotonic) | {operations} | direction, type | - |
| system.paging.usage | Sum (cumulative, non-monotonic) | By | device, state | - |
| system.paging.utilization | Gauge | 1 | device, state | - |
| system.processes.count | Sum (cumulative, non-monotonic) | {processes} | status | - |
| system.processes.created | Sum (cumulative, monotonic) | {processes} | - | - |
| system.uptime | Gauge | s | - | - |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| entity.state | `entity.type=host`; `entity.report.interval` (when configured); scope `otel.entity.event_as_log=true` | Experimental host EntityState event, emitted at start and every `metadata_collection_interval` (default 5m); format is gated by `pkg.experimentalmetricmetadata.useEntityEventsSpecification` (legacy mode uses `otel.entity.event.type=entity_state` and `otel.entity.*`). |

## Sources

- receiver/hostmetricsreceiver/receiver.go
- receiver/hostmetricsreceiver/metadata.yaml
- receiver/hostmetricsreceiver/internal/scraper/*/metadata.yaml
- pkg/experimentalmetricmetadata/entity_events.go
        • v0.154.0.md 8.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/hostmetricsreceiver
version: v0.154.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/hostmetricsreceiver
commit_sha: 853eda0e12b3ba142552ecd2b63cec07062904f0
last_verified: 2026-08-11
---

# Host Metrics Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|
| nfs.client.net.count | Sum (cumulative, monotonic) | {record} | network.transport | - |
| nfs.client.net.tcp.connection.accepted | Sum (cumulative, monotonic) | {connection} | - | - |
| nfs.client.operation.count | Sum (cumulative, monotonic) | {operation} | onc_rpc.version, nfs.operation.name | - |
| nfs.client.procedure.count | Sum (cumulative, monotonic) | {procedure} | onc_rpc.version, onc_rpc.procedure.name | - |
| nfs.client.rpc.authrefresh.count | Sum (cumulative, monotonic) | {authrefresh} | - | - |
| nfs.client.rpc.count | Sum (cumulative, monotonic) | {request} | - | - |
| nfs.client.rpc.retransmit.count | Sum (cumulative, monotonic) | {retransmit} | - | - |
| nfs.server.fh.stale.count | Sum (cumulative, monotonic) | {fh} | - | - |
| nfs.server.io | Sum (cumulative, monotonic) | By | network.io.direction | - |
| nfs.server.net.count | Sum (cumulative, monotonic) | {request} | network.transport | - |
| nfs.server.net.tcp.connection.accepted | Sum (cumulative, monotonic) | {connection} | - | - |
| nfs.server.operation.count | Sum (cumulative, monotonic) | {operation} | onc_rpc.version, nfs.operation.name | - |
| nfs.server.procedure.count | Sum (cumulative, monotonic) | {procedure} | onc_rpc.version, onc_rpc.procedure.name | - |
| nfs.server.repcache.requests | Sum (cumulative, monotonic) | {request} | nfs.server.repcache.status | - |
| nfs.server.rpc.count | Sum (cumulative, monotonic) | {request} | error.type | - |
| nfs.server.thread.count | Sum (cumulative, non-monotonic) | {thread} | - | - |
| process.context_switches | Sum (cumulative, monotonic) | {count} | context_switch_type | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.cpu.time | Sum (cumulative, monotonic) | s | state | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.cpu.utilization | Gauge | 1 | state | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.disk.io | Sum (cumulative, monotonic) | By | direction | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.disk.operations | Sum (cumulative, monotonic) | {operations} | direction | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.handles | Sum (cumulative, non-monotonic) | {count} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.usage | Sum (cumulative, non-monotonic) | By | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.utilization | Gauge | 1 | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.virtual | Sum (cumulative, non-monotonic) | By | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.open_file_descriptors | Sum (cumulative, non-monotonic) | {count} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.paging.faults | Sum (cumulative, monotonic) | {faults} | paging_fault_type | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.signals_pending | Sum (cumulative, non-monotonic) | {signals} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.threads | Sum (cumulative, non-monotonic) | {threads} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.uptime | Gauge | s | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| system.cpu.frequency | Gauge | Hz | cpu | - |
| system.cpu.load_average.15m | Gauge | {thread} | - | - |
| system.cpu.load_average.1m | Gauge | {thread} | - | - |
| system.cpu.load_average.5m | Gauge | {thread} | - | - |
| system.cpu.logical.count | Sum (cumulative, non-monotonic) | {cpu} | - | - |
| system.cpu.physical.count | Sum (cumulative, non-monotonic) | {cpu} | - | - |
| system.cpu.time | Sum (cumulative, monotonic) | s | cpu, state | - |
| system.cpu.utilization | Gauge | 1 | cpu, state | - |
| system.disk.io | Sum (cumulative, monotonic) | By | device, direction | - |
| system.disk.io_time | Sum (cumulative, monotonic) | s | device | - |
| system.disk.merged | Sum (cumulative, monotonic) | {operations} | device, direction | - |
| system.disk.operation_time | Sum (cumulative, monotonic) | s | device, direction | - |
| system.disk.operations | Sum (cumulative, monotonic) | {operations} | device, direction | - |
| system.disk.pending_operations | Sum (cumulative, non-monotonic) | {operations} | device | - |
| system.disk.weighted_io_time | Sum (cumulative, monotonic) | s | device | - |
| system.filesystem.inodes.usage | Sum (cumulative, non-monotonic) | {inodes} | device, mode, mountpoint, type, state | - |
| system.filesystem.usage | Sum (cumulative, non-monotonic) | By | device, mode, mountpoint, type, state | - |
| system.filesystem.utilization | Gauge | 1 | device, mode, mountpoint, type | - |
| system.linux.memory.available | Sum (cumulative, non-monotonic) | By | - | - |
| system.linux.memory.dirty | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.limit | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.linux.hugepages.limit | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.page_size | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.linux.hugepages.reserved | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.surplus | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.usage | Sum (cumulative, non-monotonic) | {page} | system.memory.linux.hugepages.state | - |
| system.memory.linux.hugepages.utilization | Gauge | 1 | system.memory.linux.hugepages.state | - |
| system.memory.linux.shared | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.page_size | Gauge | By | - | - |
| system.memory.usage | Sum (cumulative, non-monotonic) | By | state | Scraper and metric must be enabled; Linux value selection is gated by `receiver.hostmetricsreceiver.UseLinuxMemAvailable`. |
| system.memory.utilization | Gauge | 1 | state | Scraper and metric must be enabled; Linux value selection is gated by `receiver.hostmetricsreceiver.UseLinuxMemAvailable`. |
| system.network.connections | Sum (cumulative, non-monotonic) | {connections} | protocol, state | - |
| system.network.conntrack.count | Sum (cumulative, non-monotonic) | {entries} | - | - |
| system.network.conntrack.max | Sum (cumulative, non-monotonic) | {entries} | - | - |
| system.network.dropped | Sum (cumulative, monotonic) | {packets} | device, direction | - |
| system.network.errors | Sum (cumulative, monotonic) | {errors} | device, direction | - |
| system.network.io | Sum (cumulative, monotonic) | By | device, direction | - |
| system.network.packets | Sum (cumulative, monotonic) | {packets} | device, direction | - |
| system.paging.faults | Sum (cumulative, monotonic) | {faults} | type | - |
| system.paging.operations | Sum (cumulative, monotonic) | {operations} | direction, type | - |
| system.paging.usage | Sum (cumulative, non-monotonic) | By | device, state | - |
| system.paging.utilization | Gauge | 1 | device, state | - |
| system.processes.count | Sum (cumulative, non-monotonic) | {processes} | status | - |
| system.processes.created | Sum (cumulative, monotonic) | {processes} | - | - |
| system.uptime | Gauge | s | - | - |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| entity.state | `entity.type=host`; `entity.report.interval` (when configured); scope `otel.entity.event_as_log=true` | Experimental host EntityState event, emitted at start and every `metadata_collection_interval` (default 5m); format is gated by `pkg.experimentalmetricmetadata.useEntityEventsSpecification` (legacy mode uses `otel.entity.event.type=entity_state` and `otel.entity.*`). |

## Sources

- receiver/hostmetricsreceiver/receiver.go
- receiver/hostmetricsreceiver/metadata.yaml
- receiver/hostmetricsreceiver/internal/scraper/*/metadata.yaml
- pkg/experimentalmetricmetadata/entity_events.go
        • v0.155.0.md 8.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/hostmetricsreceiver
version: v0.155.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/hostmetricsreceiver
commit_sha: aaf5045a24c0a6f000225c97ad5449e69aeb5835
last_verified: 2026-08-11
---

# Host Metrics Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|
| nfs.client.net.count | Sum (cumulative, monotonic) | {record} | network.transport | - |
| nfs.client.net.tcp.connection.accepted | Sum (cumulative, monotonic) | {connection} | - | - |
| nfs.client.operation.count | Sum (cumulative, monotonic) | {operation} | onc_rpc.version, nfs.operation.name | - |
| nfs.client.procedure.count | Sum (cumulative, monotonic) | {procedure} | onc_rpc.version, onc_rpc.procedure.name | - |
| nfs.client.rpc.authrefresh.count | Sum (cumulative, monotonic) | {authrefresh} | - | - |
| nfs.client.rpc.count | Sum (cumulative, monotonic) | {request} | - | - |
| nfs.client.rpc.retransmit.count | Sum (cumulative, monotonic) | {retransmit} | - | - |
| nfs.server.fh.stale.count | Sum (cumulative, monotonic) | {fh} | - | - |
| nfs.server.io | Sum (cumulative, monotonic) | By | network.io.direction | - |
| nfs.server.net.count | Sum (cumulative, monotonic) | {request} | network.transport | - |
| nfs.server.net.tcp.connection.accepted | Sum (cumulative, monotonic) | {connection} | - | - |
| nfs.server.operation.count | Sum (cumulative, monotonic) | {operation} | onc_rpc.version, nfs.operation.name | - |
| nfs.server.procedure.count | Sum (cumulative, monotonic) | {procedure} | onc_rpc.version, onc_rpc.procedure.name | - |
| nfs.server.repcache.requests | Sum (cumulative, monotonic) | {request} | nfs.server.repcache.status | - |
| nfs.server.rpc.count | Sum (cumulative, monotonic) | {request} | error.type | - |
| nfs.server.thread.count | Sum (cumulative, non-monotonic) | {thread} | - | - |
| process.context_switches | Sum (cumulative, monotonic) | {count} | context_switch_type | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.cpu.time | Sum (cumulative, monotonic) | s | state | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.cpu.utilization | Gauge | 1 | state | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.disk.io | Sum (cumulative, monotonic) | By | direction | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.disk.operations | Sum (cumulative, monotonic) | {operations} | direction | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.handles | Sum (cumulative, non-monotonic) | {count} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.usage | Sum (cumulative, non-monotonic) | By | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.utilization | Gauge | 1 | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.virtual | Sum (cumulative, non-monotonic) | By | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.open_file_descriptors | Sum (cumulative, non-monotonic) | {count} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.paging.faults | Sum (cumulative, monotonic) | {faults} | paging_fault_type | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.signals_pending | Sum (cumulative, non-monotonic) | {signals} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.threads | Sum (cumulative, non-monotonic) | {threads} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.uptime | Gauge | s | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| system.cpu.frequency | Gauge | Hz | cpu | - |
| system.cpu.load_average.15m | Gauge | {thread} | - | - |
| system.cpu.load_average.1m | Gauge | {thread} | - | - |
| system.cpu.load_average.5m | Gauge | {thread} | - | - |
| system.cpu.logical.count | Sum (cumulative, non-monotonic) | {cpu} | - | - |
| system.cpu.physical.count | Sum (cumulative, non-monotonic) | {cpu} | - | - |
| system.cpu.time | Sum (cumulative, monotonic) | s | cpu, state | - |
| system.cpu.utilization | Gauge | 1 | cpu, state | - |
| system.disk.io | Sum (cumulative, monotonic) | By | device, direction | - |
| system.disk.io_time | Sum (cumulative, monotonic) | s | device | - |
| system.disk.merged | Sum (cumulative, monotonic) | {operations} | device, direction | - |
| system.disk.operation_time | Sum (cumulative, monotonic) | s | device, direction | - |
| system.disk.operations | Sum (cumulative, monotonic) | {operations} | device, direction | - |
| system.disk.pending_operations | Sum (cumulative, non-monotonic) | {operations} | device | - |
| system.disk.weighted_io_time | Sum (cumulative, monotonic) | s | device | - |
| system.filesystem.inodes.usage | Sum (cumulative, non-monotonic) | {inodes} | device, mode, mountpoint, type, state | - |
| system.filesystem.usage | Sum (cumulative, non-monotonic) | By | device, mode, mountpoint, type, state | - |
| system.filesystem.utilization | Gauge | 1 | device, mode, mountpoint, type | - |
| system.linux.memory.available | Sum (cumulative, non-monotonic) | By | - | - |
| system.linux.memory.dirty | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.limit | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.linux.hugepages.limit | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.page_size | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.linux.hugepages.reserved | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.surplus | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.usage | Sum (cumulative, non-monotonic) | {page} | system.memory.linux.hugepages.state | - |
| system.memory.linux.hugepages.utilization | Gauge | 1 | system.memory.linux.hugepages.state | - |
| system.memory.linux.shared | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.page_size | Gauge | By | - | - |
| system.memory.usage | Sum (cumulative, non-monotonic) | By | state | Scraper and metric must be enabled; Linux value selection is gated by `receiver.hostmetricsreceiver.UseLinuxMemAvailable`. |
| system.memory.utilization | Gauge | 1 | state | Scraper and metric must be enabled; Linux value selection is gated by `receiver.hostmetricsreceiver.UseLinuxMemAvailable`. |
| system.network.connections | Sum (cumulative, non-monotonic) | {connections} | protocol, state | - |
| system.network.conntrack.count | Sum (cumulative, non-monotonic) | {entries} | - | - |
| system.network.conntrack.max | Sum (cumulative, non-monotonic) | {entries} | - | - |
| system.network.dropped | Sum (cumulative, monotonic) | {packets} | device, direction | - |
| system.network.errors | Sum (cumulative, monotonic) | {errors} | device, direction | - |
| system.network.io | Sum (cumulative, monotonic) | By | device, direction | - |
| system.network.packets | Sum (cumulative, monotonic) | {packets} | device, direction | - |
| system.paging.faults | Sum (cumulative, monotonic) | {faults} | type | - |
| system.paging.operations | Sum (cumulative, monotonic) | {operations} | direction, type | - |
| system.paging.usage | Sum (cumulative, non-monotonic) | By | device, state | - |
| system.paging.utilization | Gauge | 1 | device, state | - |
| system.processes.count | Sum (cumulative, non-monotonic) | {processes} | status | - |
| system.processes.created | Sum (cumulative, monotonic) | {processes} | - | - |
| system.uptime | Gauge | s | - | - |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| entity.state | `entity.type=host`; `entity.report.interval` (when configured); scope `otel.entity.event_as_log=true` | Experimental host EntityState event, emitted at start and every `metadata_collection_interval` (default 5m); format is gated by `pkg.experimentalmetricmetadata.useEntityEventsSpecification` (legacy mode uses `otel.entity.event.type=entity_state` and `otel.entity.*`). |

## Sources

- receiver/hostmetricsreceiver/receiver.go
- receiver/hostmetricsreceiver/metadata.yaml
- receiver/hostmetricsreceiver/internal/scraper/*/metadata.yaml
- pkg/experimentalmetricmetadata/entity_events.go
        • v0.156.0.md 8.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/hostmetricsreceiver
version: v0.156.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/hostmetricsreceiver
commit_sha: 41e24cd516dd69a5b4277465cdb2ff4ef0676f49
last_verified: 2026-08-06
---

# Host Metrics Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|
| nfs.client.net.count | Sum (cumulative, monotonic) | {record} | network.transport | - |
| nfs.client.net.tcp.connection.accepted | Sum (cumulative, monotonic) | {connection} | - | - |
| nfs.client.operation.count | Sum (cumulative, monotonic) | {operation} | onc_rpc.version, nfs.operation.name | - |
| nfs.client.procedure.count | Sum (cumulative, monotonic) | {procedure} | onc_rpc.version, onc_rpc.procedure.name | - |
| nfs.client.rpc.authrefresh.count | Sum (cumulative, monotonic) | {authrefresh} | - | - |
| nfs.client.rpc.count | Sum (cumulative, monotonic) | {request} | - | - |
| nfs.client.rpc.retransmit.count | Sum (cumulative, monotonic) | {retransmit} | - | - |
| nfs.server.fh.stale.count | Sum (cumulative, monotonic) | {fh} | - | - |
| nfs.server.io | Sum (cumulative, monotonic) | By | network.io.direction | - |
| nfs.server.net.count | Sum (cumulative, monotonic) | {request} | network.transport | - |
| nfs.server.net.tcp.connection.accepted | Sum (cumulative, monotonic) | {connection} | - | - |
| nfs.server.operation.count | Sum (cumulative, monotonic) | {operation} | onc_rpc.version, nfs.operation.name | - |
| nfs.server.procedure.count | Sum (cumulative, monotonic) | {procedure} | onc_rpc.version, onc_rpc.procedure.name | - |
| nfs.server.repcache.requests | Sum (cumulative, monotonic) | {request} | nfs.server.repcache.status | - |
| nfs.server.rpc.count | Sum (cumulative, monotonic) | {request} | error.type | - |
| nfs.server.thread.count | Sum (cumulative, non-monotonic) | {thread} | - | - |
| process.context_switches | Sum (cumulative, monotonic) | {count} | context_switch_type | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.cpu.time | Sum (cumulative, monotonic) | s | state | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.cpu.utilization | Gauge | 1 | state | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.disk.io | Sum (cumulative, monotonic) | By | direction | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.disk.operations | Sum (cumulative, monotonic) | {operations} | direction | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.handles | Sum (cumulative, non-monotonic) | {count} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.usage | Sum (cumulative, non-monotonic) | By | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.utilization | Gauge | 1 | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.virtual | Sum (cumulative, non-monotonic) | By | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.open_file_descriptors | Sum (cumulative, non-monotonic) | {count} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.paging.faults | Sum (cumulative, monotonic) | {faults} | paging_fault_type | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.signals_pending | Sum (cumulative, non-monotonic) | {signals} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.threads | Sum (cumulative, non-monotonic) | {threads} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.uptime | Gauge | s | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| system.cpu.frequency | Gauge | Hz | cpu | - |
| system.cpu.load_average.15m | Gauge | {thread} | - | - |
| system.cpu.load_average.1m | Gauge | {thread} | - | - |
| system.cpu.load_average.5m | Gauge | {thread} | - | - |
| system.cpu.logical.count | Sum (cumulative, non-monotonic) | {cpu} | - | - |
| system.cpu.physical.count | Sum (cumulative, non-monotonic) | {cpu} | - | - |
| system.cpu.time | Sum (cumulative, monotonic) | s | cpu, state | - |
| system.cpu.utilization | Gauge | 1 | cpu, state | - |
| system.disk.io | Sum (cumulative, monotonic) | By | device, direction | - |
| system.disk.io_time | Sum (cumulative, monotonic) | s | device | - |
| system.disk.merged | Sum (cumulative, monotonic) | {operations} | device, direction | - |
| system.disk.operation_time | Sum (cumulative, monotonic) | s | device, direction | - |
| system.disk.operations | Sum (cumulative, monotonic) | {operations} | device, direction | - |
| system.disk.pending_operations | Sum (cumulative, non-monotonic) | {operations} | device | - |
| system.disk.weighted_io_time | Sum (cumulative, monotonic) | s | device | - |
| system.filesystem.inodes.usage | Sum (cumulative, non-monotonic) | {inodes} | device, mode, mountpoint, type, state | - |
| system.filesystem.usage | Sum (cumulative, non-monotonic) | By | device, mode, mountpoint, type, state | - |
| system.filesystem.utilization | Gauge | 1 | device, mode, mountpoint, type | - |
| system.linux.memory.available | Sum (cumulative, non-monotonic) | By | - | - |
| system.linux.memory.dirty | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.limit | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.linux.hugepages.limit | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.page_size | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.linux.hugepages.reserved | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.surplus | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.usage | Sum (cumulative, non-monotonic) | {page} | system.memory.linux.hugepages.state | - |
| system.memory.linux.hugepages.utilization | Gauge | 1 | system.memory.linux.hugepages.state | - |
| system.memory.linux.shared | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.page_size | Gauge | By | - | - |
| system.memory.usage | Sum (cumulative, non-monotonic) | By | state | Scraper and metric must be enabled; Linux value selection is gated by `receiver.hostmetricsreceiver.UseLinuxMemAvailable`. |
| system.memory.utilization | Gauge | 1 | state | Scraper and metric must be enabled; Linux value selection is gated by `receiver.hostmetricsreceiver.UseLinuxMemAvailable`. |
| system.network.connections | Sum (cumulative, non-monotonic) | {connections} | protocol, state | - |
| system.network.conntrack.count | Sum (cumulative, non-monotonic) | {entries} | - | - |
| system.network.conntrack.max | Sum (cumulative, non-monotonic) | {entries} | - | - |
| system.network.dropped | Sum (cumulative, monotonic) | {packets} | device, direction | - |
| system.network.errors | Sum (cumulative, monotonic) | {errors} | device, direction | - |
| system.network.io | Sum (cumulative, monotonic) | By | device, direction | - |
| system.network.packets | Sum (cumulative, monotonic) | {packets} | device, direction | - |
| system.paging.faults | Sum (cumulative, monotonic) | {faults} | type | - |
| system.paging.operations | Sum (cumulative, monotonic) | {operations} | direction, type | - |
| system.paging.usage | Sum (cumulative, non-monotonic) | By | device, state | - |
| system.paging.utilization | Gauge | 1 | device, state | - |
| system.processes.count | Sum (cumulative, non-monotonic) | {processes} | status | - |
| system.processes.created | Sum (cumulative, monotonic) | {processes} | - | - |
| system.uptime | Gauge | s | - | - |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| entity.state | `entity.type=host`; `entity.report.interval` (when configured); scope `otel.entity.event_as_log=true` | Experimental host EntityState event, emitted at start and every `metadata_collection_interval` (default 5m); format is gated by `pkg.experimentalmetricmetadata.useEntityEventsSpecification` (legacy mode uses `otel.entity.event.type=entity_state` and `otel.entity.*`). |

## Sources

- receiver/hostmetricsreceiver/receiver.go
- receiver/hostmetricsreceiver/metadata.yaml
- receiver/hostmetricsreceiver/internal/scraper/*/metadata.yaml
- pkg/experimentalmetricmetadata/entity_events.go
        • v0.157.0.md 8.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/hostmetricsreceiver
version: v0.157.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/hostmetricsreceiver
commit_sha: 89e43555904cd97c2d36605347c5d5237b1bdc8c
last_verified: 2026-08-06
---

# Host Metrics Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|
| nfs.client.net.count | Sum (cumulative, monotonic) | {record} | network.transport | - |
| nfs.client.net.tcp.connection.accepted | Sum (cumulative, monotonic) | {connection} | - | - |
| nfs.client.operation.count | Sum (cumulative, monotonic) | {operation} | onc_rpc.version, nfs.operation.name | - |
| nfs.client.procedure.count | Sum (cumulative, monotonic) | {procedure} | onc_rpc.version, onc_rpc.procedure.name | - |
| nfs.client.rpc.authrefresh.count | Sum (cumulative, monotonic) | {authrefresh} | - | - |
| nfs.client.rpc.count | Sum (cumulative, monotonic) | {request} | - | - |
| nfs.client.rpc.retransmit.count | Sum (cumulative, monotonic) | {retransmit} | - | - |
| nfs.server.fh.stale.count | Sum (cumulative, monotonic) | {fh} | - | - |
| nfs.server.io | Sum (cumulative, monotonic) | By | network.io.direction | - |
| nfs.server.net.count | Sum (cumulative, monotonic) | {request} | network.transport | - |
| nfs.server.net.tcp.connection.accepted | Sum (cumulative, monotonic) | {connection} | - | - |
| nfs.server.operation.count | Sum (cumulative, monotonic) | {operation} | onc_rpc.version, nfs.operation.name | - |
| nfs.server.procedure.count | Sum (cumulative, monotonic) | {procedure} | onc_rpc.version, onc_rpc.procedure.name | - |
| nfs.server.repcache.requests | Sum (cumulative, monotonic) | {request} | nfs.server.repcache.status | - |
| nfs.server.rpc.count | Sum (cumulative, monotonic) | {request} | error.type | - |
| nfs.server.thread.count | Sum (cumulative, non-monotonic) | {thread} | - | - |
| process.context_switches | Sum (cumulative, monotonic) | {count} | context_switch_type | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.cpu.time | Sum (cumulative, monotonic) | s | state | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.cpu.utilization | Gauge | 1 | state | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.disk.io | Sum (cumulative, monotonic) | By | direction | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.disk.operations | Sum (cumulative, monotonic) | {operations} | direction | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.handles | Sum (cumulative, non-monotonic) | {count} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.usage | Sum (cumulative, non-monotonic) | By | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.utilization | Gauge | 1 | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.virtual | Sum (cumulative, non-monotonic) | By | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.open_file_descriptors | Sum (cumulative, non-monotonic) | {count} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.paging.faults | Sum (cumulative, monotonic) | {faults} | paging_fault_type | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.signals_pending | Sum (cumulative, non-monotonic) | {signals} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.threads | Sum (cumulative, non-monotonic) | {threads} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.uptime | Gauge | s | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| system.cpu.frequency | Gauge | Hz | cpu | - |
| system.cpu.load_average.15m | Gauge | {thread} | - | - |
| system.cpu.load_average.1m | Gauge | {thread} | - | - |
| system.cpu.load_average.5m | Gauge | {thread} | - | - |
| system.cpu.logical.count | Sum (cumulative, non-monotonic) | {cpu} | - | - |
| system.cpu.physical.count | Sum (cumulative, non-monotonic) | {cpu} | - | - |
| system.cpu.time | Sum (cumulative, monotonic) | s | cpu, state | - |
| system.cpu.utilization | Gauge | 1 | cpu, state | - |
| system.disk.io | Sum (cumulative, monotonic) | By | device, direction | - |
| system.disk.io_time | Sum (cumulative, monotonic) | s | device | - |
| system.disk.merged | Sum (cumulative, monotonic) | {operations} | device, direction | - |
| system.disk.operation_time | Sum (cumulative, monotonic) | s | device, direction | - |
| system.disk.operations | Sum (cumulative, monotonic) | {operations} | device, direction | - |
| system.disk.pending_operations | Sum (cumulative, non-monotonic) | {operations} | device | - |
| system.disk.weighted_io_time | Sum (cumulative, monotonic) | s | device | - |
| system.filesystem.inodes.usage | Sum (cumulative, non-monotonic) | {inodes} | device, mode, mountpoint, type, state | - |
| system.filesystem.usage | Sum (cumulative, non-monotonic) | By | device, mode, mountpoint, type, state | - |
| system.filesystem.utilization | Gauge | 1 | device, mode, mountpoint, type | - |
| system.linux.memory.available | Sum (cumulative, non-monotonic) | By | - | - |
| system.linux.memory.dirty | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.limit | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.linux.hugepages.limit | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.page_size | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.linux.hugepages.reserved | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.surplus | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.usage | Sum (cumulative, non-monotonic) | {page} | system.memory.linux.hugepages.state | - |
| system.memory.linux.hugepages.utilization | Gauge | 1 | system.memory.linux.hugepages.state | - |
| system.memory.linux.shared | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.page_size | Gauge | By | - | - |
| system.memory.usage | Sum (cumulative, non-monotonic) | By | state | Scraper and metric must be enabled; Linux value selection is gated by `receiver.hostmetricsreceiver.UseLinuxMemAvailable`. |
| system.memory.utilization | Gauge | 1 | state | Scraper and metric must be enabled; Linux value selection is gated by `receiver.hostmetricsreceiver.UseLinuxMemAvailable`. |
| system.network.connections | Sum (cumulative, non-monotonic) | {connections} | protocol, state | - |
| system.network.conntrack.count | Sum (cumulative, non-monotonic) | {entries} | - | - |
| system.network.conntrack.max | Sum (cumulative, non-monotonic) | {entries} | - | - |
| system.network.dropped | Sum (cumulative, monotonic) | {packets} | device, direction | - |
| system.network.errors | Sum (cumulative, monotonic) | {errors} | device, direction | - |
| system.network.io | Sum (cumulative, monotonic) | By | device, direction | - |
| system.network.packets | Sum (cumulative, monotonic) | {packets} | device, direction | - |
| system.paging.faults | Sum (cumulative, monotonic) | {faults} | type | - |
| system.paging.operations | Sum (cumulative, monotonic) | {operations} | direction, type | - |
| system.paging.usage | Sum (cumulative, non-monotonic) | By | device, state | - |
| system.paging.utilization | Gauge | 1 | device, state | - |
| system.processes.count | Sum (cumulative, non-monotonic) | {processes} | status | - |
| system.processes.created | Sum (cumulative, monotonic) | {processes} | - | - |
| system.uptime | Gauge | s | - | - |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| entity.state | `entity.type=host`; `entity.report.interval` (when configured); scope `otel.entity.event_as_log=true` | Experimental host EntityState event, emitted at start and every `metadata_collection_interval` (default 5m); format is gated by `pkg.experimentalmetricmetadata.useEntityEventsSpecification` (legacy mode uses `otel.entity.event.type=entity_state` and `otel.entity.*`). |

## Sources

- receiver/hostmetricsreceiver/receiver.go
- receiver/hostmetricsreceiver/metadata.yaml
- receiver/hostmetricsreceiver/internal/scraper/*/metadata.yaml
- pkg/experimentalmetricmetadata/entity_events.go
        • v0.158.0.md 8.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/hostmetricsreceiver
version: v0.158.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/hostmetricsreceiver
commit_sha: 821a9d9c2c1623c4a0ceba5d47b57c48879c3f84
last_verified: 2026-08-06
---

# Host Metrics Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|
| nfs.client.net.count | Sum (cumulative, monotonic) | {record} | network.transport | - |
| nfs.client.net.tcp.connection.accepted | Sum (cumulative, monotonic) | {connection} | - | - |
| nfs.client.operation.count | Sum (cumulative, monotonic) | {operation} | onc_rpc.version, nfs.operation.name | - |
| nfs.client.procedure.count | Sum (cumulative, monotonic) | {procedure} | onc_rpc.version, onc_rpc.procedure.name | - |
| nfs.client.rpc.authrefresh.count | Sum (cumulative, monotonic) | {authrefresh} | - | - |
| nfs.client.rpc.count | Sum (cumulative, monotonic) | {request} | - | - |
| nfs.client.rpc.retransmit.count | Sum (cumulative, monotonic) | {retransmit} | - | - |
| nfs.server.fh.stale.count | Sum (cumulative, monotonic) | {fh} | - | - |
| nfs.server.io | Sum (cumulative, monotonic) | By | network.io.direction | - |
| nfs.server.net.count | Sum (cumulative, monotonic) | {request} | network.transport | - |
| nfs.server.net.tcp.connection.accepted | Sum (cumulative, monotonic) | {connection} | - | - |
| nfs.server.operation.count | Sum (cumulative, monotonic) | {operation} | onc_rpc.version, nfs.operation.name | - |
| nfs.server.procedure.count | Sum (cumulative, monotonic) | {procedure} | onc_rpc.version, onc_rpc.procedure.name | - |
| nfs.server.repcache.requests | Sum (cumulative, monotonic) | {request} | nfs.server.repcache.status | - |
| nfs.server.rpc.count | Sum (cumulative, monotonic) | {request} | error.type | - |
| nfs.server.thread.count | Sum (cumulative, non-monotonic) | {thread} | - | - |
| process.context_switches | Sum (cumulative, monotonic) | {count} | context_switch_type | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.cpu.time | Sum (cumulative, monotonic) | s | state | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.cpu.utilization | Gauge | 1 | state | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.disk.io | Sum (cumulative, monotonic) | By | direction | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.disk.operations | Sum (cumulative, monotonic) | {operations} | direction | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.handles | Sum (cumulative, non-monotonic) | {count} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.usage | Sum (cumulative, non-monotonic) | By | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.utilization | Gauge | 1 | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.virtual | Sum (cumulative, non-monotonic) | By | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.open_file_descriptors | Sum (cumulative, non-monotonic) | {count} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.paging.faults | Sum (cumulative, monotonic) | {faults} | paging_fault_type | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.signals_pending | Sum (cumulative, non-monotonic) | {signals} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.threads | Sum (cumulative, non-monotonic) | {threads} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.uptime | Gauge | s | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| system.cpu.frequency | Gauge | Hz | cpu | - |
| system.cpu.load_average.15m | Gauge | {thread} | - | - |
| system.cpu.load_average.1m | Gauge | {thread} | - | - |
| system.cpu.load_average.5m | Gauge | {thread} | - | - |
| system.cpu.logical.count | Sum (cumulative, non-monotonic) | {cpu} | - | - |
| system.cpu.physical.count | Sum (cumulative, non-monotonic) | {cpu} | - | - |
| system.cpu.time | Sum (cumulative, monotonic) | s | cpu, state | - |
| system.cpu.utilization | Gauge | 1 | cpu, state | - |
| system.disk.io | Sum (cumulative, monotonic) | By | device, direction | - |
| system.disk.io_time | Sum (cumulative, monotonic) | s | device | - |
| system.disk.merged | Sum (cumulative, monotonic) | {operations} | device, direction | - |
| system.disk.operation_time | Sum (cumulative, monotonic) | s | device, direction | - |
| system.disk.operations | Sum (cumulative, monotonic) | {operations} | device, direction | - |
| system.disk.pending_operations | Sum (cumulative, non-monotonic) | {operations} | device | - |
| system.disk.weighted_io_time | Sum (cumulative, monotonic) | s | device | - |
| system.filesystem.inodes.usage | Sum (cumulative, non-monotonic) | {inodes} | device, mode, mountpoint, type, state | - |
| system.filesystem.usage | Sum (cumulative, non-monotonic) | By | device, mode, mountpoint, type, state | - |
| system.filesystem.utilization | Gauge | 1 | device, mode, mountpoint, type | - |
| system.linux.memory.available | Sum (cumulative, non-monotonic) | By | - | - |
| system.linux.memory.dirty | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.limit | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.linux.hugepages.limit | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.page_size | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.linux.hugepages.reserved | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.surplus | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.usage | Sum (cumulative, non-monotonic) | {page} | system.memory.linux.hugepages.state | - |
| system.memory.linux.hugepages.utilization | Gauge | 1 | system.memory.linux.hugepages.state | - |
| system.memory.linux.shared | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.page_size | Gauge | By | - | - |
| system.memory.usage | Sum (cumulative, non-monotonic) | By | state | Scraper and metric must be enabled; Linux value selection is gated by `receiver.hostmetricsreceiver.UseLinuxMemAvailable`. |
| system.memory.utilization | Gauge | 1 | state | Scraper and metric must be enabled; Linux value selection is gated by `receiver.hostmetricsreceiver.UseLinuxMemAvailable`. |
| system.network.connections | Sum (cumulative, non-monotonic) | {connections} | protocol, state | - |
| system.network.conntrack.count | Sum (cumulative, non-monotonic) | {entries} | - | - |
| system.network.conntrack.max | Sum (cumulative, non-monotonic) | {entries} | - | - |
| system.network.dropped | Sum (cumulative, monotonic) | {packets} | device, direction | - |
| system.network.errors | Sum (cumulative, monotonic) | {errors} | device, direction | - |
| system.network.io | Sum (cumulative, monotonic) | By | device, direction | - |
| system.network.packets | Sum (cumulative, monotonic) | {packets} | device, direction | - |
| system.paging.faults | Sum (cumulative, monotonic) | {faults} | type | - |
| system.paging.operations | Sum (cumulative, monotonic) | {operations} | direction, type | - |
| system.paging.usage | Sum (cumulative, non-monotonic) | By | device, state | - |
| system.paging.utilization | Gauge | 1 | device, state | - |
| system.processes.count | Sum (cumulative, non-monotonic) | {processes} | status | - |
| system.processes.created | Sum (cumulative, monotonic) | {processes} | - | - |
| system.uptime | Gauge | s | - | - |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| entity.state | `entity.type=host`; `entity.report.interval` (when configured); scope `otel.entity.event_as_log=true` | Experimental host EntityState event, emitted at start and every `metadata_collection_interval` (default 5m); format is gated by `pkg.experimentalmetricmetadata.useEntityEventsSpecification` (legacy mode uses `otel.entity.event.type=entity_state` and `otel.entity.*`). |

## Sources

- receiver/hostmetricsreceiver/receiver.go
- receiver/hostmetricsreceiver/metadata.yaml
- receiver/hostmetricsreceiver/internal/scraper/*/metadata.yaml
- pkg/experimentalmetricmetadata/entity_events.go
        • v0.159.0.md 8.4 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/hostmetricsreceiver
version: v0.159.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/hostmetricsreceiver
commit_sha: 1120cc0714bf4d14600105e5673c3b00fe87467a
last_verified: 2026-10-14
---

# Host Metrics Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| nfs.client.net.count | Sum (cumulative, monotonic) | {record} | network.transport | - |
| nfs.client.net.tcp.connection.accepted | Sum (cumulative, monotonic) | {connection} | - | - |
| nfs.client.operation.count | Sum (cumulative, monotonic) | {operation} | onc_rpc.version, nfs.operation.name | - |
| nfs.client.procedure.count | Sum (cumulative, monotonic) | {procedure} | onc_rpc.version, onc_rpc.procedure.name | - |
| nfs.client.rpc.authrefresh.count | Sum (cumulative, monotonic) | {authrefresh} | - | - |
| nfs.client.rpc.count | Sum (cumulative, monotonic) | {request} | - | - |
| nfs.client.rpc.retransmit.count | Sum (cumulative, monotonic) | {retransmit} | - | - |
| nfs.server.fh.stale.count | Sum (cumulative, monotonic) | {fh} | - | - |
| nfs.server.io | Sum (cumulative, monotonic) | By | network.io.direction | - |
| nfs.server.net.count | Sum (cumulative, monotonic) | {request} | network.transport | - |
| nfs.server.net.tcp.connection.accepted | Sum (cumulative, monotonic) | {connection} | - | - |
| nfs.server.operation.count | Sum (cumulative, monotonic) | {operation} | onc_rpc.version, nfs.operation.name | - |
| nfs.server.procedure.count | Sum (cumulative, monotonic) | {procedure} | onc_rpc.version, onc_rpc.procedure.name | - |
| nfs.server.repcache.requests | Sum (cumulative, monotonic) | {request} | nfs.server.repcache.status | - |
| nfs.server.rpc.count | Sum (cumulative, monotonic) | {request} | error.type | - |
| nfs.server.thread.count | Sum (cumulative, non-monotonic) | {thread} | - | - |
| process.context_switches | Sum (cumulative, monotonic) | {count} | context_switch_type | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.cpu.time | Sum (cumulative, monotonic) | s | state | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.cpu.utilization | Gauge | 1 | state | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.disk.io | Sum (cumulative, monotonic) | By | direction | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.disk.operations | Sum (cumulative, monotonic) | {operations} | direction | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.handles | Sum (cumulative, non-monotonic) | {count} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.usage | Sum (cumulative, non-monotonic) | By | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.utilization | Gauge | 1 | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.virtual | Sum (cumulative, non-monotonic) | By | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.open_file_descriptors | Sum (cumulative, non-monotonic) | {count} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.paging.faults | Sum (cumulative, monotonic) | {faults} | paging_fault_type | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.signals_pending | Sum (cumulative, non-monotonic) | {signals} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.threads | Sum (cumulative, non-monotonic) | {threads} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.uptime | Gauge | s | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| system.cpu.frequency | Gauge | Hz | cpu | - |
| system.cpu.load_average.15m | Gauge | {thread} | - | - |
| system.cpu.load_average.1m | Gauge | {thread} | - | - |
| system.cpu.load_average.5m | Gauge | {thread} | - | - |
| system.cpu.logical.count | Sum (cumulative, non-monotonic) | {cpu} | - | - |
| system.cpu.physical.count | Sum (cumulative, non-monotonic) | {cpu} | - | - |
| system.cpu.time | Sum (cumulative, monotonic) | s | cpu, state | - |
| system.cpu.utilization | Gauge | 1 | cpu, state | - |
| system.disk.io | Sum (cumulative, monotonic) | By | device, direction | - |
| system.disk.io_time | Sum (cumulative, monotonic) | s | device | - |
| system.disk.merged | Sum (cumulative, monotonic) | {operations} | device, direction | - |
| system.disk.operation_time | Sum (cumulative, monotonic) | s | device, direction | - |
| system.disk.operations | Sum (cumulative, monotonic) | {operations} | device, direction | - |
| system.disk.pending_operations | Sum (cumulative, non-monotonic) | {operations} | device | - |
| system.disk.weighted_io_time | Sum (cumulative, monotonic) | s | device | - |
| system.filesystem.inodes.usage | Sum (cumulative, non-monotonic) | {inodes} | device, mode, mountpoint, type, state | - |
| system.filesystem.usage | Sum (cumulative, non-monotonic) | By | device, mode, mountpoint, type, state | - |
| system.filesystem.utilization | Gauge | 1 | device, mode, mountpoint, type | - |
| system.linux.memory.available | Sum (cumulative, non-monotonic) | By | - | - |
| system.linux.memory.dirty | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.limit | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.linux.hugepages.limit | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.page_size | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.linux.hugepages.reserved | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.surplus | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.usage | Sum (cumulative, non-monotonic) | {page} | system.memory.linux.hugepages.state | - |
| system.memory.linux.hugepages.utilization | Gauge | 1 | system.memory.linux.hugepages.state | - |
| system.memory.linux.shared | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.page_size | Gauge | By | - | - |
| system.memory.usage | Sum (cumulative, non-monotonic) | By | state | Scraper and metric must be enabled; Linux value selection is gated by `receiver.hostmetricsreceiver.UseLinuxMemAvailable`. |
| system.memory.utilization | Gauge | 1 | state | Scraper and metric must be enabled; Linux value selection is gated by `receiver.hostmetricsreceiver.UseLinuxMemAvailable`. |
| system.network.connections | Sum (cumulative, non-monotonic) | {connections} | protocol, state | - |
| system.network.conntrack.count | Sum (cumulative, non-monotonic) | {entries} | - | - |
| system.network.conntrack.max | Sum (cumulative, non-monotonic) | {entries} | - | - |
| system.network.dropped | Sum (cumulative, monotonic) | {packets} | device, direction | - |
| system.network.errors | Sum (cumulative, monotonic) | {errors} | device, direction | - |
| system.network.io | Sum (cumulative, monotonic) | By | device, direction | - |
| system.network.packets | Sum (cumulative, monotonic) | {packets} | device, direction | - |
| system.paging.faults | Sum (cumulative, monotonic) | {faults} | type | - |
| system.paging.operations | Sum (cumulative, monotonic) | {operations} | direction, type | - |
| system.paging.usage | Sum (cumulative, non-monotonic) | By | device, state | - |
| system.paging.utilization | Gauge | 1 | device, state | - |
| system.processes.count | Sum (cumulative, non-monotonic) | {processes} | status | - |
| system.processes.created | Sum (cumulative, monotonic) | {processes} | - | - |
| system.uptime | Gauge | s | - | - |

## Sources

- receiver/hostmetricsreceiver/receiver.go
- receiver/hostmetricsreceiver/metadata.yaml
- receiver/hostmetricsreceiver/internal/scraper/*/metadata.yaml
        • v0.160.0.md 10.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/hostmetricsreceiver
version: v0.160.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/hostmetricsreceiver
commit_sha: 982f20b8a8e8a2569fab3e27cf8b008e8a5080c1
last_verified: 2026-09-03
---

# Host Metrics Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|
| nfs.client.net.count | Sum (cumulative, monotonic) | {record} | network.transport | - |
| nfs.client.net.tcp.connection.accepted | Sum (cumulative, monotonic) | {connection} | - | - |
| nfs.client.operation.count | Sum (cumulative, monotonic) | {operation} | onc_rpc.version, nfs.operation.name | - |
| nfs.client.procedure.count | Sum (cumulative, monotonic) | {procedure} | onc_rpc.version, onc_rpc.procedure.name | - |
| nfs.client.rpc.authrefresh.count | Sum (cumulative, monotonic) | {authrefresh} | - | - |
| nfs.client.rpc.count | Sum (cumulative, monotonic) | {request} | - | - |
| nfs.client.rpc.retransmit.count | Sum (cumulative, monotonic) | {retransmit} | - | - |
| nfs.server.fh.stale.count | Sum (cumulative, monotonic) | {fh} | - | - |
| nfs.server.io | Sum (cumulative, monotonic) | By | network.io.direction | - |
| nfs.server.net.count | Sum (cumulative, monotonic) | {request} | network.transport | - |
| nfs.server.net.tcp.connection.accepted | Sum (cumulative, monotonic) | {connection} | - | - |
| nfs.server.operation.count | Sum (cumulative, monotonic) | {operation} | onc_rpc.version, nfs.operation.name | - |
| nfs.server.procedure.count | Sum (cumulative, monotonic) | {procedure} | onc_rpc.version, onc_rpc.procedure.name | - |
| nfs.server.repcache.requests | Sum (cumulative, monotonic) | {request} | nfs.server.repcache.status | - |
| nfs.server.rpc.count | Sum (cumulative, monotonic) | {request} | error.type | - |
| nfs.server.thread.count | Sum (cumulative, non-monotonic) | {thread} | - | - |
| process.context_switches | Sum (cumulative, monotonic) | {count} | context_switch_type | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.cpu.time | Sum (cumulative, monotonic) | s | state | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.cpu.utilization | Gauge | 1 | state | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.disk.io | Sum (cumulative, monotonic) | By | direction | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.disk.operations | Sum (cumulative, monotonic) | {operations} | direction | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.handles | Sum (cumulative, non-monotonic) | {count} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.usage | Sum (cumulative, non-monotonic) | By | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.utilization | Gauge | 1 | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.virtual | Sum (cumulative, non-monotonic) | By | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.open_file_descriptors | Sum (cumulative, non-monotonic) | {count} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.paging.faults | Sum (cumulative, monotonic) | {faults} | paging_fault_type | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.signals_pending | Sum (cumulative, non-monotonic) | {signals} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.threads | Sum (cumulative, non-monotonic) | {threads} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.uptime | Gauge | s | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.context_switches | Sum (cumulative, monotonic) | {context_switch} | process.context_switch.type | Stable-convention variant; process scraper and metric must be enabled, and emission requires `scraper.process.EmitV1SystemConventions` or the receiver-wide `receiver.hostmetrics.EmitV1SystemConventions`. |
| process.cpu.time | Sum (cumulative, monotonic) | s | cpu.mode | Stable-convention variant; process scraper and metric must be enabled, and emission requires a corresponding EmitV1 gate. |
| process.cpu.utilization | Gauge | 1 | cpu.mode | Stable-convention variant; process scraper and metric must be enabled, and emission requires a corresponding EmitV1 gate. |
| process.disk.io | Sum (cumulative, monotonic) | By | disk.io.direction | Stable-convention variant; process scraper and metric must be enabled, and emission requires a corresponding EmitV1 gate. |
| process.paging.faults | Sum (cumulative, monotonic) | {fault} | system.paging.fault.type | Stable-convention variant; process scraper and metric must be enabled, and emission requires a corresponding EmitV1 gate. |
| process.thread.count | Sum (cumulative, non-monotonic) | {thread} | - | Stable-convention metric; process scraper and metric must be enabled, and emission requires a corresponding EmitV1 gate. |
| process.unix.file_descriptor.count | Sum (cumulative, non-monotonic) | {file_descriptor} | - | Stable-convention metric; process scraper and metric must be enabled, Unix only, and emission requires a corresponding EmitV1 gate. |
| process.windows.handle.count | Sum (cumulative, non-monotonic) | {handle} | - | Stable-convention metric; process scraper and metric must be enabled, Windows only, and emission requires a corresponding EmitV1 gate. |
| system.cpu.frequency | Gauge | Hz | cpu | - |
| system.cpu.load_average.15m | Gauge | {thread} | - | - |
| system.cpu.load_average.1m | Gauge | {thread} | - | - |
| system.cpu.load_average.5m | Gauge | {thread} | - | - |
| system.cpu.logical.count | Sum (cumulative, non-monotonic) | {cpu} | - | - |
| system.cpu.physical.count | Sum (cumulative, non-monotonic) | {cpu} | - | - |
| system.cpu.time | Sum (cumulative, monotonic) | s | cpu, state | - |
| system.cpu.utilization | Gauge | 1 | cpu, state | - |
| system.disk.io | Sum (cumulative, monotonic) | By | device, direction | - |
| system.disk.io_time | Sum (cumulative, monotonic) | s | device | - |
| system.disk.merged | Sum (cumulative, monotonic) | {operations} | device, direction | - |
| system.disk.operation_time | Sum (cumulative, monotonic) | s | device, direction | - |
| system.disk.operations | Sum (cumulative, monotonic) | {operations} | device, direction | - |
| system.disk.pending_operations | Sum (cumulative, non-monotonic) | {operations} | device | - |
| system.disk.weighted_io_time | Sum (cumulative, monotonic) | s | device | - |
| system.filesystem.inodes.usage | Sum (cumulative, non-monotonic) | {inodes} | device, mode, mountpoint, type, state | - |
| system.filesystem.usage | Sum (cumulative, non-monotonic) | By | device, mode, mountpoint, type, state | - |
| system.filesystem.utilization | Gauge | 1 | device, mode, mountpoint, type | - |
| system.linux.memory.available | Sum (cumulative, non-monotonic) | By | - | - |
| system.linux.memory.dirty | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.limit | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.linux.hugepages.limit | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.page_size | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.linux.hugepages.reserved | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.surplus | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.usage | Sum (cumulative, non-monotonic) | {page} | system.memory.linux.hugepages.state | - |
| system.memory.linux.hugepages.utilization | Gauge | 1 | system.memory.linux.hugepages.state | - |
| system.memory.linux.shared | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.page_size | Gauge | By | - | - |
| system.memory.usage | Sum (cumulative, non-monotonic) | By | state | Scraper and metric must be enabled; Linux value selection is gated by `receiver.hostmetricsreceiver.UseLinuxMemAvailable`. |
| system.memory.utilization | Gauge | 1 | state | Scraper and metric must be enabled; Linux value selection is gated by `receiver.hostmetricsreceiver.UseLinuxMemAvailable`. |
| system.network.connections | Sum (cumulative, non-monotonic) | {connections} | protocol, state | - |
| system.network.conntrack.count | Sum (cumulative, non-monotonic) | {entries} | - | - |
| system.network.conntrack.max | Sum (cumulative, non-monotonic) | {entries} | - | - |
| system.network.dropped | Sum (cumulative, monotonic) | {packets} | device, direction | - |
| system.network.errors | Sum (cumulative, monotonic) | {errors} | device, direction | - |
| system.network.io | Sum (cumulative, monotonic) | By | device, direction | - |
| system.network.packets | Sum (cumulative, monotonic) | {packets} | device, direction | - |
| system.paging.faults | Sum (cumulative, monotonic) | {faults} | type | - |
| system.paging.operations | Sum (cumulative, monotonic) | {operations} | direction, type | - |
| system.paging.usage | Sum (cumulative, non-monotonic) | By | device, state | - |
| system.paging.utilization | Gauge | 1 | device, state | - |
| system.processes.count | Sum (cumulative, non-monotonic) | {processes} | status | - |
| system.processes.created | Sum (cumulative, monotonic) | {processes} | - | - |
| system.uptime | Gauge | s | - | - |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| entity.state | `entity.type=host`; `entity.report.interval` (when configured); scope `otel.entity.event_as_log=true` | Experimental host EntityState event, emitted at start and every `metadata_collection_interval` (default 5m); format is gated by `pkg.experimentalmetricmetadata.useEntityEventsSpecification` (legacy mode uses `otel.entity.event.type=entity_state` and `otel.entity.*`). |

## Sources

- receiver/hostmetricsreceiver/receiver.go
- receiver/hostmetricsreceiver/metadata.yaml
- receiver/hostmetricsreceiver/internal/scraper/*/metadata.yaml
- pkg/experimentalmetricmetadata/entity_events.go
        • v0.161.0.md 10.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/hostmetricsreceiver
version: v0.161.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/hostmetricsreceiver
commit_sha: 3f8455d8038a985398861171e5310bc9b4e988b2
last_verified: 2026-10-03
---

# Host Metrics Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| nfs.client.net.count | Sum (cumulative, monotonic) | {record} | network.transport | - |
| nfs.client.net.tcp.connection.accepted | Sum (cumulative, monotonic) | {connection} | - | - |
| nfs.client.operation.count | Sum (cumulative, monotonic) | {operation} | onc_rpc.version, nfs.operation.name | - |
| nfs.client.procedure.count | Sum (cumulative, monotonic) | {procedure} | onc_rpc.version, onc_rpc.procedure.name | - |
| nfs.client.rpc.authrefresh.count | Sum (cumulative, monotonic) | {authrefresh} | - | - |
| nfs.client.rpc.count | Sum (cumulative, monotonic) | {request} | - | - |
| nfs.client.rpc.retransmit.count | Sum (cumulative, monotonic) | {retransmit} | - | - |
| nfs.server.fh.stale.count | Sum (cumulative, monotonic) | {fh} | - | - |
| nfs.server.io | Sum (cumulative, monotonic) | By | network.io.direction | - |
| nfs.server.net.count | Sum (cumulative, monotonic) | {request} | network.transport | - |
| nfs.server.net.tcp.connection.accepted | Sum (cumulative, monotonic) | {connection} | - | - |
| nfs.server.operation.count | Sum (cumulative, monotonic) | {operation} | onc_rpc.version, nfs.operation.name | - |
| nfs.server.procedure.count | Sum (cumulative, monotonic) | {procedure} | onc_rpc.version, onc_rpc.procedure.name | - |
| nfs.server.repcache.requests | Sum (cumulative, monotonic) | {request} | nfs.server.repcache.status | - |
| nfs.server.rpc.count | Sum (cumulative, monotonic) | {request} | error.type | - |
| nfs.server.thread.count | Sum (cumulative, non-monotonic) | {thread} | - | - |
| process.context_switches | Sum (cumulative, monotonic) | {count} | context_switch_type | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.cpu.time | Sum (cumulative, monotonic) | s | state | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.cpu.utilization | Gauge | 1 | state | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.disk.io | Sum (cumulative, monotonic) | By | direction | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.disk.operations | Sum (cumulative, monotonic) | {operations} | direction | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.handles | Sum (cumulative, non-monotonic) | {count} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.usage | Sum (cumulative, non-monotonic) | By | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.utilization | Gauge | 1 | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.virtual | Sum (cumulative, non-monotonic) | By | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.open_file_descriptors | Sum (cumulative, non-monotonic) | {count} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.paging.faults | Sum (cumulative, monotonic) | {faults} | paging_fault_type | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.signals_pending | Sum (cumulative, non-monotonic) | {signals} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.threads | Sum (cumulative, non-monotonic) | {threads} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.uptime | Gauge | s | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.context_switches | Sum (cumulative, monotonic) | {context_switch} | process.context_switch.type | Stable-convention variant; process scraper and metric must be enabled, and emission requires `scraper.process.EmitV1SystemConventions` or the receiver-wide `receiver.hostmetrics.EmitV1SystemConventions`. |
| process.cpu.time | Sum (cumulative, monotonic) | s | cpu.mode | Stable-convention variant; process scraper and metric must be enabled, and emission requires a corresponding EmitV1 gate. |
| process.cpu.utilization | Gauge | 1 | cpu.mode | Stable-convention variant; process scraper and metric must be enabled, and emission requires a corresponding EmitV1 gate. |
| process.disk.io | Sum (cumulative, monotonic) | By | disk.io.direction | Stable-convention variant; process scraper and metric must be enabled, and emission requires a corresponding EmitV1 gate. |
| process.paging.faults | Sum (cumulative, monotonic) | {fault} | system.paging.fault.type | Stable-convention variant; process scraper and metric must be enabled, and emission requires a corresponding EmitV1 gate. |
| process.thread.count | Sum (cumulative, non-monotonic) | {thread} | - | Stable-convention metric; process scraper and metric must be enabled, and emission requires a corresponding EmitV1 gate. |
| process.unix.file_descriptor.count | Sum (cumulative, non-monotonic) | {file_descriptor} | - | Stable-convention metric; process scraper and metric must be enabled, Unix only, and emission requires a corresponding EmitV1 gate. |
| process.windows.handle.count | Sum (cumulative, non-monotonic) | {handle} | - | Stable-convention metric; process scraper and metric must be enabled, Windows only, and emission requires a corresponding EmitV1 gate. |
| system.cpu.frequency | Gauge | Hz | cpu | - |
| system.cpu.load_average.15m | Gauge | {thread} | - | - |
| system.cpu.load_average.1m | Gauge | {thread} | - | - |
| system.cpu.load_average.5m | Gauge | {thread} | - | - |
| system.cpu.logical.count | Sum (cumulative, non-monotonic) | {cpu} | - | - |
| system.cpu.physical.count | Sum (cumulative, non-monotonic) | {cpu} | - | - |
| system.cpu.time | Sum (cumulative, monotonic) | s | cpu, state | - |
| system.cpu.utilization | Gauge | 1 | cpu, state | - |
| system.disk.io | Sum (cumulative, monotonic) | By | device, direction | - |
| system.disk.io_time | Sum (cumulative, monotonic) | s | device | - |
| system.disk.merged | Sum (cumulative, monotonic) | {operations} | device, direction | - |
| system.disk.operation_time | Sum (cumulative, monotonic) | s | device, direction | - |
| system.disk.operations | Sum (cumulative, monotonic) | {operations} | device, direction | - |
| system.disk.pending_operations | Sum (cumulative, non-monotonic) | {operations} | device | - |
| system.disk.weighted_io_time | Sum (cumulative, monotonic) | s | device | - |
| system.filesystem.inodes.usage | Sum (cumulative, non-monotonic) | {inodes} | device, mode, mountpoint, type, state | - |
| system.filesystem.usage | Sum (cumulative, non-monotonic) | By | device, mode, mountpoint, type, state | - |
| system.filesystem.utilization | Gauge | 1 | device, mode, mountpoint, type | - |
| system.linux.memory.available | Sum (cumulative, non-monotonic) | By | - | - |
| system.linux.memory.dirty | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.limit | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.linux.hugepages.limit | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.page_size | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.linux.hugepages.reserved | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.surplus | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.usage | Sum (cumulative, non-monotonic) | {page} | system.memory.linux.hugepages.state | - |
| system.memory.linux.hugepages.utilization | Gauge | 1 | system.memory.linux.hugepages.state | - |
| system.memory.linux.shared | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.page_size | Gauge | By | - | - |
| system.memory.usage | Sum (cumulative, non-monotonic) | By | state | Scraper and metric must be enabled; Linux value selection is gated by `receiver.hostmetricsreceiver.UseLinuxMemAvailable`. |
| system.memory.utilization | Gauge | 1 | state | Scraper and metric must be enabled; Linux value selection is gated by `receiver.hostmetricsreceiver.UseLinuxMemAvailable`. |
| system.network.connections | Sum (cumulative, non-monotonic) | {connections} | protocol, state | - |
| system.network.conntrack.count | Sum (cumulative, non-monotonic) | {entries} | - | - |
| system.network.conntrack.max | Sum (cumulative, non-monotonic) | {entries} | - | - |
| system.network.dropped | Sum (cumulative, monotonic) | {packets} | device, direction | - |
| system.network.errors | Sum (cumulative, monotonic) | {errors} | device, direction | - |
| system.network.io | Sum (cumulative, monotonic) | By | device, direction | - |
| system.network.packets | Sum (cumulative, monotonic) | {packets} | device, direction | - |
| system.paging.faults | Sum (cumulative, monotonic) | {faults} | type | - |
| system.paging.operations | Sum (cumulative, monotonic) | {operations} | direction, type | - |
| system.paging.usage | Sum (cumulative, non-monotonic) | By | device, state | - |
| system.paging.utilization | Gauge | 1 | device, state | - |
| system.processes.count | Sum (cumulative, non-monotonic) | {processes} | status | - |
| system.processes.created | Sum (cumulative, monotonic) | {processes} | - | - |
| system.uptime | Gauge | s | - | - |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| entity.state | `entity.type=host`; `entity.report.interval` (when configured); scope `otel.entity.event_as_log=true` | Experimental host EntityState event, emitted at start and every `metadata_collection_interval` (default 5m); format is gated by `pkg.experimentalmetricmetadata.useEntityEventsSpecification` (legacy mode uses `otel.entity.event.type=entity_state` and `otel.entity.*`). |

## Sources

- receiver/hostmetricsreceiver/receiver.go
- receiver/hostmetricsreceiver/metadata.yaml
- receiver/hostmetricsreceiver/internal/scraper/*/metadata.yaml
- pkg/experimentalmetricmetadata/entity_events.go
        • v0.162.0.md 10.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/hostmetricsreceiver
version: v0.162.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/hostmetricsreceiver
commit_sha: ae8c507510f48f433ab47dd1c6b01a59d6c388b5
last_verified: 2026-10-03
---

# Host Metrics Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| nfs.client.net.count | Sum (cumulative, monotonic) | {record} | network.transport | - |
| nfs.client.net.tcp.connection.accepted | Sum (cumulative, monotonic) | {connection} | - | - |
| nfs.client.operation.count | Sum (cumulative, monotonic) | {operation} | onc_rpc.version, nfs.operation.name | - |
| nfs.client.procedure.count | Sum (cumulative, monotonic) | {procedure} | onc_rpc.version, onc_rpc.procedure.name | - |
| nfs.client.rpc.authrefresh.count | Sum (cumulative, monotonic) | {authrefresh} | - | - |
| nfs.client.rpc.count | Sum (cumulative, monotonic) | {request} | - | - |
| nfs.client.rpc.retransmit.count | Sum (cumulative, monotonic) | {retransmit} | - | - |
| nfs.server.fh.stale.count | Sum (cumulative, monotonic) | {fh} | - | - |
| nfs.server.io | Sum (cumulative, monotonic) | By | network.io.direction | - |
| nfs.server.net.count | Sum (cumulative, monotonic) | {request} | network.transport | - |
| nfs.server.net.tcp.connection.accepted | Sum (cumulative, monotonic) | {connection} | - | - |
| nfs.server.operation.count | Sum (cumulative, monotonic) | {operation} | onc_rpc.version, nfs.operation.name | - |
| nfs.server.procedure.count | Sum (cumulative, monotonic) | {procedure} | onc_rpc.version, onc_rpc.procedure.name | - |
| nfs.server.repcache.requests | Sum (cumulative, monotonic) | {request} | nfs.server.repcache.status | - |
| nfs.server.rpc.count | Sum (cumulative, monotonic) | {request} | error.type | - |
| nfs.server.thread.count | Sum (cumulative, non-monotonic) | {thread} | - | - |
| process.context_switches | Sum (cumulative, monotonic) | {count} | context_switch_type | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.cpu.time | Sum (cumulative, monotonic) | s | state | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.cpu.utilization | Gauge | 1 | state | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.disk.io | Sum (cumulative, monotonic) | By | direction | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.disk.operations | Sum (cumulative, monotonic) | {operations} | direction | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.handles | Sum (cumulative, non-monotonic) | {count} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.usage | Sum (cumulative, non-monotonic) | By | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.utilization | Gauge | 1 | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.virtual | Sum (cumulative, non-monotonic) | By | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.open_file_descriptors | Sum (cumulative, non-monotonic) | {count} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.paging.faults | Sum (cumulative, monotonic) | {faults} | paging_fault_type | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.signals_pending | Sum (cumulative, non-monotonic) | {signals} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.threads | Sum (cumulative, non-monotonic) | {threads} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.uptime | Gauge | s | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.context_switches | Sum (cumulative, monotonic) | {context_switch} | process.context_switch.type | Stable-convention variant; process scraper and metric must be enabled, and emission requires `scraper.process.EmitV1SystemConventions` or the receiver-wide `receiver.hostmetrics.EmitV1SystemConventions`. |
| process.cpu.time | Sum (cumulative, monotonic) | s | cpu.mode | Stable-convention variant; process scraper and metric must be enabled, and emission requires a corresponding EmitV1 gate. |
| process.cpu.utilization | Gauge | 1 | cpu.mode | Stable-convention variant; process scraper and metric must be enabled, and emission requires a corresponding EmitV1 gate. |
| process.disk.io | Sum (cumulative, monotonic) | By | disk.io.direction | Stable-convention variant; process scraper and metric must be enabled, and emission requires a corresponding EmitV1 gate. |
| process.paging.faults | Sum (cumulative, monotonic) | {fault} | system.paging.fault.type | Stable-convention variant; process scraper and metric must be enabled, and emission requires a corresponding EmitV1 gate. |
| process.thread.count | Sum (cumulative, non-monotonic) | {thread} | - | Stable-convention metric; process scraper and metric must be enabled, and emission requires a corresponding EmitV1 gate. |
| process.unix.file_descriptor.count | Sum (cumulative, non-monotonic) | {file_descriptor} | - | Stable-convention metric; process scraper and metric must be enabled, Unix only, and emission requires a corresponding EmitV1 gate. |
| process.windows.handle.count | Sum (cumulative, non-monotonic) | {handle} | - | Stable-convention metric; process scraper and metric must be enabled, Windows only, and emission requires a corresponding EmitV1 gate. |
| system.cpu.frequency | Gauge | Hz | cpu | - |
| system.cpu.load_average.15m | Gauge | {thread} | - | - |
| system.cpu.load_average.1m | Gauge | {thread} | - | - |
| system.cpu.load_average.5m | Gauge | {thread} | - | - |
| system.cpu.logical.count | Sum (cumulative, non-monotonic) | {cpu} | - | - |
| system.cpu.physical.count | Sum (cumulative, non-monotonic) | {cpu} | - | - |
| system.cpu.time | Sum (cumulative, monotonic) | s | cpu, state | - |
| system.cpu.utilization | Gauge | 1 | cpu, state | - |
| system.disk.io | Sum (cumulative, monotonic) | By | device, direction | - |
| system.disk.io_time | Sum (cumulative, monotonic) | s | device | - |
| system.disk.merged | Sum (cumulative, monotonic) | {operations} | device, direction | - |
| system.disk.operation_time | Sum (cumulative, monotonic) | s | device, direction | - |
| system.disk.operations | Sum (cumulative, monotonic) | {operations} | device, direction | - |
| system.disk.pending_operations | Sum (cumulative, non-monotonic) | {operations} | device | - |
| system.disk.weighted_io_time | Sum (cumulative, monotonic) | s | device | - |
| system.filesystem.inodes.usage | Sum (cumulative, non-monotonic) | {inodes} | device, mode, mountpoint, type, state | - |
| system.filesystem.usage | Sum (cumulative, non-monotonic) | By | device, mode, mountpoint, type, state | - |
| system.filesystem.utilization | Gauge | 1 | device, mode, mountpoint, type | - |
| system.linux.memory.available | Sum (cumulative, non-monotonic) | By | - | - |
| system.linux.memory.dirty | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.limit | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.linux.hugepages.limit | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.page_size | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.linux.hugepages.reserved | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.surplus | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.usage | Sum (cumulative, non-monotonic) | {page} | system.memory.linux.hugepages.state | - |
| system.memory.linux.hugepages.utilization | Gauge | 1 | system.memory.linux.hugepages.state | - |
| system.memory.linux.shared | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.page_size | Gauge | By | - | - |
| system.memory.usage | Sum (cumulative, non-monotonic) | By | state | Scraper and metric must be enabled; Linux value selection is gated by `receiver.hostmetricsreceiver.UseLinuxMemAvailable`. |
| system.memory.utilization | Gauge | 1 | state | Scraper and metric must be enabled; Linux value selection is gated by `receiver.hostmetricsreceiver.UseLinuxMemAvailable`. |
| system.network.connections | Sum (cumulative, non-monotonic) | {connections} | protocol, state | - |
| system.network.conntrack.count | Sum (cumulative, non-monotonic) | {entries} | - | - |
| system.network.conntrack.max | Sum (cumulative, non-monotonic) | {entries} | - | - |
| system.network.dropped | Sum (cumulative, monotonic) | {packets} | device, direction | - |
| system.network.errors | Sum (cumulative, monotonic) | {errors} | device, direction | - |
| system.network.io | Sum (cumulative, monotonic) | By | device, direction | - |
| system.network.packets | Sum (cumulative, monotonic) | {packets} | device, direction | - |
| system.paging.faults | Sum (cumulative, monotonic) | {faults} | type | - |
| system.paging.operations | Sum (cumulative, monotonic) | {operations} | direction, type | - |
| system.paging.usage | Sum (cumulative, non-monotonic) | By | device, state | - |
| system.paging.utilization | Gauge | 1 | device, state | - |
| system.processes.count | Sum (cumulative, non-monotonic) | {processes} | status | - |
| system.processes.created | Sum (cumulative, monotonic) | {processes} | - | - |
| system.uptime | Gauge | s | - | - |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| entity.state | `entity.type=host`; `entity.report.interval` (when configured); scope `otel.entity.event_as_log=true` | Experimental host EntityState event, emitted at start and every `metadata_collection_interval` (default 5m); format is gated by `pkg.experimentalmetricmetadata.useEntityEventsSpecification` (legacy mode uses `otel.entity.event.type=entity_state` and `otel.entity.*`). |

## Sources

- receiver/hostmetricsreceiver/receiver.go
- receiver/hostmetricsreceiver/metadata.yaml
- receiver/hostmetricsreceiver/internal/scraper/*/metadata.yaml
- pkg/experimentalmetricmetadata/entity_events.go
        • v0.163.0.md 10.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/hostmetricsreceiver
version: v0.163.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/hostmetricsreceiver
commit_sha: df849b5403c041d5e799e7846392a6f18b0b55ae
last_verified: 2026-10-14
---

# Host Metrics Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| nfs.client.net.count | Sum (cumulative, monotonic) | {record} | network.transport | - |
| nfs.client.net.tcp.connection.accepted | Sum (cumulative, monotonic) | {connection} | - | - |
| nfs.client.operation.count | Sum (cumulative, monotonic) | {operation} | onc_rpc.version, nfs.operation.name | - |
| nfs.client.procedure.count | Sum (cumulative, monotonic) | {procedure} | onc_rpc.version, onc_rpc.procedure.name | - |
| nfs.client.rpc.authrefresh.count | Sum (cumulative, monotonic) | {authrefresh} | - | - |
| nfs.client.rpc.count | Sum (cumulative, monotonic) | {request} | - | - |
| nfs.client.rpc.retransmit.count | Sum (cumulative, monotonic) | {retransmit} | - | - |
| nfs.server.fh.stale.count | Sum (cumulative, monotonic) | {fh} | - | - |
| nfs.server.io | Sum (cumulative, monotonic) | By | network.io.direction | - |
| nfs.server.net.count | Sum (cumulative, monotonic) | {request} | network.transport | - |
| nfs.server.net.tcp.connection.accepted | Sum (cumulative, monotonic) | {connection} | - | - |
| nfs.server.operation.count | Sum (cumulative, monotonic) | {operation} | onc_rpc.version, nfs.operation.name | - |
| nfs.server.procedure.count | Sum (cumulative, monotonic) | {procedure} | onc_rpc.version, onc_rpc.procedure.name | - |
| nfs.server.repcache.requests | Sum (cumulative, monotonic) | {request} | nfs.server.repcache.status | - |
| nfs.server.rpc.count | Sum (cumulative, monotonic) | {request} | error.type | - |
| nfs.server.thread.count | Sum (cumulative, non-monotonic) | {thread} | - | - |
| process.context_switches | Sum (cumulative, monotonic) | {count} | context_switch_type | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.cpu.time | Sum (cumulative, monotonic) | s | state | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.cpu.utilization | Gauge | 1 | state | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.disk.io | Sum (cumulative, monotonic) | By | direction | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.disk.operations | Sum (cumulative, monotonic) | {operations} | direction | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.handles | Sum (cumulative, non-monotonic) | {count} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.usage | Sum (cumulative, non-monotonic) | By | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.utilization | Gauge | 1 | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.memory.virtual | Sum (cumulative, non-monotonic) | By | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.open_file_descriptors | Sum (cumulative, non-monotonic) | {count} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.paging.faults | Sum (cumulative, monotonic) | {faults} | paging_fault_type | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.signals_pending | Sum (cumulative, non-monotonic) | {signals} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.threads | Sum (cumulative, non-monotonic) | {threads} | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.uptime | Gauge | s | - | Scraper and metric must be enabled; process boot-time handling is affected by `hostmetrics.process.bootTimeCache`. |
| process.context_switches | Sum (cumulative, monotonic) | {context_switch} | process.context_switch.type | Stable-convention variant; process scraper and metric must be enabled, and emission requires `scraper.process.EmitV1SystemConventions` or the receiver-wide `receiver.hostmetrics.EmitV1SystemConventions`. |
| process.cpu.time | Sum (cumulative, monotonic) | s | cpu.mode | Stable-convention variant; process scraper and metric must be enabled, and emission requires a corresponding EmitV1 gate. |
| process.cpu.utilization | Gauge | 1 | cpu.mode | Stable-convention variant; process scraper and metric must be enabled, and emission requires a corresponding EmitV1 gate. |
| process.disk.io | Sum (cumulative, monotonic) | By | disk.io.direction | Stable-convention variant; process scraper and metric must be enabled, and emission requires a corresponding EmitV1 gate. |
| process.paging.faults | Sum (cumulative, monotonic) | {fault} | system.paging.fault.type | Stable-convention variant; process scraper and metric must be enabled, and emission requires a corresponding EmitV1 gate. |
| process.thread.count | Sum (cumulative, non-monotonic) | {thread} | - | Stable-convention metric; process scraper and metric must be enabled, and emission requires a corresponding EmitV1 gate. |
| process.unix.file_descriptor.count | Sum (cumulative, non-monotonic) | {file_descriptor} | - | Stable-convention metric; process scraper and metric must be enabled, Unix only, and emission requires a corresponding EmitV1 gate. |
| process.windows.handle.count | Sum (cumulative, non-monotonic) | {handle} | - | Stable-convention metric; process scraper and metric must be enabled, Windows only, and emission requires a corresponding EmitV1 gate. |
| system.cpu.frequency | Gauge | Hz | cpu | - |
| system.cpu.load_average.15m | Gauge | {thread} | - | - |
| system.cpu.load_average.1m | Gauge | {thread} | - | - |
| system.cpu.load_average.5m | Gauge | {thread} | - | - |
| system.cpu.logical.count | Sum (cumulative, non-monotonic) | {cpu} | - | - |
| system.cpu.physical.count | Sum (cumulative, non-monotonic) | {cpu} | - | - |
| system.cpu.time | Sum (cumulative, monotonic) | s | cpu, state | - |
| system.cpu.utilization | Gauge | 1 | cpu, state | - |
| system.disk.io | Sum (cumulative, monotonic) | By | device, direction | - |
| system.disk.io_time | Sum (cumulative, monotonic) | s | device | - |
| system.disk.merged | Sum (cumulative, monotonic) | {operations} | device, direction | - |
| system.disk.operation_time | Sum (cumulative, monotonic) | s | device, direction | - |
| system.disk.operations | Sum (cumulative, monotonic) | {operations} | device, direction | - |
| system.disk.pending_operations | Sum (cumulative, non-monotonic) | {operations} | device | - |
| system.disk.weighted_io_time | Sum (cumulative, monotonic) | s | device | - |
| system.filesystem.inodes.usage | Sum (cumulative, non-monotonic) | {inodes} | device, mode, mountpoint, type, state | - |
| system.filesystem.usage | Sum (cumulative, non-monotonic) | By | device, mode, mountpoint, type, state | - |
| system.filesystem.utilization | Gauge | 1 | device, mode, mountpoint, type | - |
| system.linux.memory.available | Sum (cumulative, non-monotonic) | By | - | - |
| system.linux.memory.dirty | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.limit | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.linux.hugepages.limit | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.page_size | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.linux.hugepages.reserved | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.surplus | Sum (cumulative, non-monotonic) | {page} | - | - |
| system.memory.linux.hugepages.usage | Sum (cumulative, non-monotonic) | {page} | system.memory.linux.hugepages.state | - |
| system.memory.linux.hugepages.utilization | Gauge | 1 | system.memory.linux.hugepages.state | - |
| system.memory.linux.shared | Sum (cumulative, non-monotonic) | By | - | - |
| system.memory.page_size | Gauge | By | - | - |
| system.memory.usage | Sum (cumulative, non-monotonic) | By | state | Scraper and metric must be enabled; Linux value selection is gated by `receiver.hostmetricsreceiver.UseLinuxMemAvailable`. |
| system.memory.utilization | Gauge | 1 | state | Scraper and metric must be enabled; Linux value selection is gated by `receiver.hostmetricsreceiver.UseLinuxMemAvailable`. |
| system.network.connections | Sum (cumulative, non-monotonic) | {connections} | protocol, state | - |
| system.network.conntrack.count | Sum (cumulative, non-monotonic) | {entries} | - | - |
| system.network.conntrack.max | Sum (cumulative, non-monotonic) | {entries} | - | - |
| system.network.dropped | Sum (cumulative, monotonic) | {packets} | device, direction | - |
| system.network.errors | Sum (cumulative, monotonic) | {errors} | device, direction | - |
| system.network.io | Sum (cumulative, monotonic) | By | device, direction | - |
| system.network.packets | Sum (cumulative, monotonic) | {packets} | device, direction | - |
| system.paging.faults | Sum (cumulative, monotonic) | {faults} | type | - |
| system.paging.operations | Sum (cumulative, monotonic) | {operations} | direction, type | - |
| system.paging.usage | Sum (cumulative, non-monotonic) | By | device, state | - |
| system.paging.utilization | Gauge | 1 | device, state | - |
| system.processes.count | Sum (cumulative, non-monotonic) | {processes} | status | - |
| system.processes.created | Sum (cumulative, monotonic) | {processes} | - | - |
| system.uptime | Gauge | s | - | - |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| entity.state | `entity.type=host`; `entity.report.interval` (when configured); scope `otel.entity.event_as_log=true` | Experimental host EntityState event, emitted at start and every `metadata_collection_interval` (default 5m); format is gated by `pkg.experimentalmetricmetadata.useEntityEventsSpecification` (legacy mode uses `otel.entity.event.type=entity_state` and `otel.entity.*`). |

## Sources

- receiver/hostmetricsreceiver/receiver.go
- receiver/hostmetricsreceiver/metadata.yaml
- receiver/hostmetricsreceiver/internal/scraper/*/metadata.yaml
- pkg/experimentalmetricmetadata/entity_events.go
      • httpcheckreceiver
        • v0.153.0.md 4.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/httpcheckreceiver
version: v0.153.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/httpcheckreceiver
commit_sha: 42f949127580c0d00088b785cd0b35842dc0ddb8
last_verified: 2026-08-11
---

# HTTP Check Receiver

Component type `http_check` (deprecated alias `httpcheck`). Metrics stability: alpha. All metrics below are emitted once per configured target endpoint per collection interval, and each can be toggled with `metrics::<name>::enabled`.

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `httpcheck.duration` | Gauge (int) | `ms` | `http.url` | Enabled by default; stability `development`. Wall-clock time of `client.Do`, recorded on every scrape including failures. |
| `httpcheck.error` | Sum (cumulative, non-monotonic, int) | `{error}` | `http.url`, `error.message` | Enabled by default; stability `development`. Recorded with value `1` only when the request returns an error; `error.message` is the Go error string. |
| `httpcheck.status` | Sum (cumulative, non-monotonic, int) | `1` | `http.url`, `http.status_code`, `http.method`, `http.status_class` | Enabled by default; stability `development`. One data point per status class (`1xx`–`5xx`) per scrape: `1` for the matching class, `0` for the others. For the `0`-valued points the `http.status_code` attribute is stripped by `removeStatusCodeForZeroValues` after `Emit`. |
| `httpcheck.response.size` | Gauge (int) | `By` | `http.url` | Disabled by default (`metrics::httpcheck.response.size::enabled: true`); stability `development`. Recorded only when the response body is non-empty. |
| `httpcheck.dns.lookup.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. From `httptrace` `DNSStart`/`DNSDone`; recorded every scrape, `0` when the phase did not occur (e.g. connection reuse or cached DNS). |
| `httpcheck.client.connection.duration` | Gauge (int) | `ns` | `http.url`, `network.transport` | Disabled by default; stability `development`. From `httptrace` `ConnectStart`/`ConnectDone`; `network.transport` is always the literal `tcp`. `0` when no new connection was established. |
| `httpcheck.tls.handshake.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. From `httptrace` `TLSHandshakeStart`/`TLSHandshakeDone`; `0` for plaintext HTTP or reused connections. |
| `httpcheck.client.request.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. Request-write phase (request start to `WroteRequest`). |
| `httpcheck.response.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. Response-read phase (`GotFirstResponseByte` to end of `client.Do`). |
| `httpcheck.tls.cert_remaining` | Gauge (int) | `s` | `http.url`, `http.tls.issuer`, `http.tls.cn`, `http.tls.san` | Disabled by default; stability `development`. Recorded only when the metric is enabled, the response carries TLS state with at least one peer certificate, and issuer/CN/SANs are non-empty. Seconds until `NotAfter`; negative after expiry. `http.tls.san` is a slice of IPs, URIs, DNS names and email addresses. |
| `httpcheck.validation.passed` | Sum (cumulative, non-monotonic, int) | `{validation}` | `http.url`, `validation.type` | Disabled by default; stability `development`. Requires `targets::validations` to be configured and a non-empty response body. `validation.type` is one of `contains`, `not_contains`, `json_path`, `size`, `regex`. |
| `httpcheck.validation.failed` | Sum (cumulative, non-monotonic, int) | `{validation}` | `http.url`, `validation.type` | Disabled by default; stability `development`. Same gating and `validation.type` values as `httpcheck.validation.passed`. |

No resource attributes are defined by this component.

## Sources

- `receiver/httpcheckreceiver/metadata.yaml`
- `receiver/httpcheckreceiver/scraper.go`
- `receiver/httpcheckreceiver/config.go`
- `receiver/httpcheckreceiver/factory.go`
- `receiver/httpcheckreceiver/documentation.md`
- `receiver/httpcheckreceiver/internal/metadata/generated_metrics.go`
- `receiver/httpcheckreceiver/internal/metadata/generated_status.go`
        • v0.154.0.md 4.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/httpcheckreceiver
version: v0.154.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/httpcheckreceiver
commit_sha: 853eda0e12b3ba142552ecd2b63cec07062904f0
last_verified: 2026-08-11
---

# HTTP Check Receiver

Component type `http_check` (deprecated alias `httpcheck`). Metrics stability: alpha. All metrics below are emitted once per configured target endpoint per collection interval, and each can be toggled with `metrics::<name>::enabled`.

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `httpcheck.duration` | Gauge (int) | `ms` | `http.url` | Enabled by default; stability `development`. Wall-clock time of `client.Do`, recorded on every scrape including failures. |
| `httpcheck.error` | Sum (cumulative, non-monotonic, int) | `{error}` | `http.url`, `error.message` | Enabled by default; stability `development`. Recorded with value `1` only when the request returns an error; `error.message` is the Go error string. |
| `httpcheck.status` | Sum (cumulative, non-monotonic, int) | `1` | `http.url`, `http.status_code`, `http.method`, `http.status_class` | Enabled by default; stability `development`. One data point per status class (`1xx`–`5xx`) per scrape: `1` for the matching class, `0` for the others. For the `0`-valued points the `http.status_code` attribute is stripped by `removeStatusCodeForZeroValues` after `Emit`. |
| `httpcheck.response.size` | Gauge (int) | `By` | `http.url` | Disabled by default (`metrics::httpcheck.response.size::enabled: true`); stability `development`. Recorded only when the response body is non-empty. |
| `httpcheck.dns.lookup.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. From `httptrace` `DNSStart`/`DNSDone`; recorded every scrape, `0` when the phase did not occur (e.g. connection reuse or cached DNS). |
| `httpcheck.client.connection.duration` | Gauge (int) | `ns` | `http.url`, `network.transport` | Disabled by default; stability `development`. From `httptrace` `ConnectStart`/`ConnectDone`; `network.transport` is always the literal `tcp`. `0` when no new connection was established. |
| `httpcheck.tls.handshake.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. From `httptrace` `TLSHandshakeStart`/`TLSHandshakeDone`; `0` for plaintext HTTP or reused connections. |
| `httpcheck.client.request.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. Request-write phase (request start to `WroteRequest`). |
| `httpcheck.response.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. Response-read phase (`GotFirstResponseByte` to end of `client.Do`). |
| `httpcheck.tls.cert_remaining` | Gauge (int) | `s` | `http.url`, `http.tls.issuer`, `http.tls.cn`, `http.tls.san` | Disabled by default; stability `development`. Recorded only when the metric is enabled, the response carries TLS state with at least one peer certificate, and issuer/CN/SANs are non-empty. Seconds until `NotAfter`; negative after expiry. `http.tls.san` is a slice of IPs, URIs, DNS names and email addresses. |
| `httpcheck.validation.passed` | Sum (cumulative, non-monotonic, int) | `{validation}` | `http.url`, `validation.type` | Disabled by default; stability `development`. Requires `targets::validations` to be configured and a non-empty response body. `validation.type` is one of `contains`, `not_contains`, `json_path`, `size`, `regex`. |
| `httpcheck.validation.failed` | Sum (cumulative, non-monotonic, int) | `{validation}` | `http.url`, `validation.type` | Disabled by default; stability `development`. Same gating and `validation.type` values as `httpcheck.validation.passed`. |

No resource attributes are defined by this component.

## Sources

- `receiver/httpcheckreceiver/metadata.yaml`
- `receiver/httpcheckreceiver/scraper.go`
- `receiver/httpcheckreceiver/config.go`
- `receiver/httpcheckreceiver/factory.go`
- `receiver/httpcheckreceiver/documentation.md`
- `receiver/httpcheckreceiver/internal/metadata/generated_metrics.go`
- `receiver/httpcheckreceiver/internal/metadata/generated_status.go`
        • v0.155.0.md 4.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/httpcheckreceiver
version: v0.155.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/httpcheckreceiver
commit_sha: aaf5045a24c0a6f000225c97ad5449e69aeb5835
last_verified: 2026-08-11
---

# HTTP Check Receiver

Component type `http_check` (deprecated alias `httpcheck`). Metrics stability: alpha. All metrics below are emitted once per configured target endpoint per collection interval, and each can be toggled with `metrics::<name>::enabled`.

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `httpcheck.duration` | Gauge (int) | `ms` | `http.url` | Enabled by default; stability `development`. Wall-clock time of `client.Do`, recorded on every scrape including failures. |
| `httpcheck.error` | Sum (cumulative, non-monotonic, int) | `{error}` | `http.url`, `error.message` | Enabled by default; stability `development`. Recorded with value `1` only when the request returns an error; `error.message` is the Go error string. |
| `httpcheck.status` | Sum (cumulative, non-monotonic, int) | `1` | `http.url`, `http.status_code`, `http.method`, `http.status_class` | Enabled by default; stability `development`. One data point per status class (`1xx`–`5xx`) per scrape: `1` for the matching class, `0` for the others. For the `0`-valued points the `http.status_code` attribute is stripped by `removeStatusCodeForZeroValues` after `Emit`. |
| `httpcheck.response.size` | Gauge (int) | `By` | `http.url` | Disabled by default (`metrics::httpcheck.response.size::enabled: true`); stability `development`. Recorded only when the response body is non-empty. |
| `httpcheck.dns.lookup.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. From `httptrace` `DNSStart`/`DNSDone`; recorded every scrape, `0` when the phase did not occur (e.g. connection reuse or cached DNS). |
| `httpcheck.client.connection.duration` | Gauge (int) | `ns` | `http.url`, `network.transport` | Disabled by default; stability `development`. From `httptrace` `ConnectStart`/`ConnectDone`; `network.transport` is always the literal `tcp`. `0` when no new connection was established. |
| `httpcheck.tls.handshake.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. From `httptrace` `TLSHandshakeStart`/`TLSHandshakeDone`; `0` for plaintext HTTP or reused connections. |
| `httpcheck.client.request.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. Request-write phase (request start to `WroteRequest`). |
| `httpcheck.response.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. Response-read phase (`GotFirstResponseByte` to end of `client.Do`). |
| `httpcheck.tls.cert_remaining` | Gauge (int) | `s` | `http.url`, `http.tls.issuer`, `http.tls.cn`, `http.tls.san` | Disabled by default; stability `development`. Recorded only when the metric is enabled, the response carries TLS state with at least one peer certificate, and issuer/CN/SANs are non-empty. Seconds until `NotAfter`; negative after expiry. `http.tls.san` is a slice of IPs, URIs, DNS names and email addresses. |
| `httpcheck.validation.passed` | Sum (cumulative, non-monotonic, int) | `{validation}` | `http.url`, `validation.type` | Disabled by default; stability `development`. Requires `targets::validations` to be configured and a non-empty response body. `validation.type` is one of `contains`, `not_contains`, `json_path`, `size`, `regex`. |
| `httpcheck.validation.failed` | Sum (cumulative, non-monotonic, int) | `{validation}` | `http.url`, `validation.type` | Disabled by default; stability `development`. Same gating and `validation.type` values as `httpcheck.validation.passed`. |

No resource attributes are defined by this component.

## Sources

- `receiver/httpcheckreceiver/metadata.yaml`
- `receiver/httpcheckreceiver/scraper.go`
- `receiver/httpcheckreceiver/config.go`
- `receiver/httpcheckreceiver/factory.go`
- `receiver/httpcheckreceiver/documentation.md`
- `receiver/httpcheckreceiver/internal/metadata/generated_metrics.go`
- `receiver/httpcheckreceiver/internal/metadata/generated_status.go`
        • v0.156.0.md 4.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/httpcheckreceiver
version: v0.156.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/httpcheckreceiver
commit_sha: 41e24cd516dd69a5b4277465cdb2ff4ef0676f49
last_verified: 2026-08-11
---

# HTTP Check Receiver

Component type `http_check` (deprecated alias `httpcheck`). Metrics stability: alpha. All metrics below are emitted once per configured target endpoint per collection interval, and each can be toggled with `metrics::<name>::enabled`.

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `httpcheck.duration` | Gauge (int) | `ms` | `http.url` | Enabled by default; stability `development`. Wall-clock time of `client.Do`, recorded on every scrape including failures. |
| `httpcheck.error` | Sum (cumulative, non-monotonic, int) | `{error}` | `http.url`, `error.message` | Enabled by default; stability `development`. Recorded with value `1` only when the request returns an error; `error.message` is the Go error string. |
| `httpcheck.status` | Sum (cumulative, non-monotonic, int) | `1` | `http.url`, `http.status_code`, `http.method`, `http.status_class` | Enabled by default; stability `development`. One data point per status class (`1xx`–`5xx`) per scrape: `1` for the matching class, `0` for the others. For the `0`-valued points the `http.status_code` attribute is stripped by `removeStatusCodeForZeroValues` after `Emit`. |
| `httpcheck.response.size` | Gauge (int) | `By` | `http.url` | Disabled by default (`metrics::httpcheck.response.size::enabled: true`); stability `development`. Recorded only when the response body is non-empty. |
| `httpcheck.dns.lookup.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. From `httptrace` `DNSStart`/`DNSDone`; recorded every scrape, `0` when the phase did not occur (e.g. connection reuse or cached DNS). |
| `httpcheck.client.connection.duration` | Gauge (int) | `ns` | `http.url`, `network.transport` | Disabled by default; stability `development`. From `httptrace` `ConnectStart`/`ConnectDone`; `network.transport` is always the literal `tcp`. `0` when no new connection was established. |
| `httpcheck.tls.handshake.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. From `httptrace` `TLSHandshakeStart`/`TLSHandshakeDone`; `0` for plaintext HTTP or reused connections. |
| `httpcheck.client.request.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. Request-write phase (request start to `WroteRequest`). |
| `httpcheck.response.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. Response-read phase (`GotFirstResponseByte` to end of `client.Do`). |
| `httpcheck.tls.cert_remaining` | Gauge (int) | `s` | `http.url`, `http.tls.issuer`, `http.tls.cn`, `http.tls.san` | Disabled by default; stability `development`. Recorded only when the metric is enabled, the response carries TLS state with at least one peer certificate, and issuer/CN/SANs are non-empty. Seconds until `NotAfter`; negative after expiry. `http.tls.san` is a slice of IPs, URIs, DNS names and email addresses. |
| `httpcheck.validation.passed` | Sum (cumulative, non-monotonic, int) | `{validation}` | `http.url`, `validation.type` | Disabled by default; stability `development`. Requires `targets::validations` to be configured and a non-empty response body. `validation.type` is one of `contains`, `not_contains`, `json_path`, `size`, `regex`. |
| `httpcheck.validation.failed` | Sum (cumulative, non-monotonic, int) | `{validation}` | `http.url`, `validation.type` | Disabled by default; stability `development`. Same gating and `validation.type` values as `httpcheck.validation.passed`. |

No resource attributes are defined by this component.

## Sources

- `receiver/httpcheckreceiver/metadata.yaml`
- `receiver/httpcheckreceiver/scraper.go`
- `receiver/httpcheckreceiver/config.go`
- `receiver/httpcheckreceiver/factory.go`
- `receiver/httpcheckreceiver/documentation.md`
- `receiver/httpcheckreceiver/internal/metadata/generated_metrics.go`
- `receiver/httpcheckreceiver/internal/metadata/generated_status.go`
        • v0.157.0.md 4.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/httpcheckreceiver
version: v0.157.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/httpcheckreceiver
commit_sha: 89e43555904cd97c2d36605347c5d5237b1bdc8c
last_verified: 2026-08-11
---

# HTTP Check Receiver

Component type `http_check` (deprecated alias `httpcheck`). Metrics stability: alpha. All metrics below are emitted once per configured target endpoint per collection interval, and each can be toggled with `metrics::<name>::enabled`.

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `httpcheck.duration` | Gauge (int) | `ms` | `http.url` | Enabled by default; stability `development`. Wall-clock time of `client.Do`, recorded on every scrape including failures. |
| `httpcheck.error` | Sum (cumulative, non-monotonic, int) | `{error}` | `http.url`, `error.message` | Enabled by default; stability `development`. Recorded with value `1` only when the request returns an error; `error.message` is the Go error string. |
| `httpcheck.status` | Sum (cumulative, non-monotonic, int) | `1` | `http.url`, `http.status_code`, `http.method`, `http.status_class` | Enabled by default; stability `development`. One data point per status class (`1xx`–`5xx`) per scrape: `1` for the matching class, `0` for the others. For the `0`-valued points the `http.status_code` attribute is stripped by `removeStatusCodeForZeroValues` after `Emit`. |
| `httpcheck.response.size` | Gauge (int) | `By` | `http.url` | Disabled by default (`metrics::httpcheck.response.size::enabled: true`); stability `development`. Recorded only when the response body is non-empty. |
| `httpcheck.dns.lookup.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. From `httptrace` `DNSStart`/`DNSDone`; recorded every scrape, `0` when the phase did not occur (e.g. connection reuse or cached DNS). |
| `httpcheck.client.connection.duration` | Gauge (int) | `ns` | `http.url`, `network.transport` | Disabled by default; stability `development`. From `httptrace` `ConnectStart`/`ConnectDone`; `network.transport` is always the literal `tcp`. `0` when no new connection was established. |
| `httpcheck.tls.handshake.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. From `httptrace` `TLSHandshakeStart`/`TLSHandshakeDone`; `0` for plaintext HTTP or reused connections. |
| `httpcheck.client.request.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. Request-write phase (request start to `WroteRequest`). |
| `httpcheck.response.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. Response-read phase (`GotFirstResponseByte` to end of `client.Do`). |
| `httpcheck.tls.cert_remaining` | Gauge (int) | `s` | `http.url`, `http.tls.issuer`, `http.tls.cn`, `http.tls.san` | Disabled by default; stability `development`. Recorded only when the metric is enabled, the response carries TLS state with at least one peer certificate, and issuer/CN/SANs are non-empty. Seconds until `NotAfter`; negative after expiry. `http.tls.san` is a slice of IPs, URIs, DNS names and email addresses. |
| `httpcheck.validation.passed` | Sum (cumulative, non-monotonic, int) | `{validation}` | `http.url`, `validation.type` | Disabled by default; stability `development`. Requires `targets::validations` to be configured and a non-empty response body. `validation.type` is one of `contains`, `not_contains`, `json_path`, `size`, `regex`. |
| `httpcheck.validation.failed` | Sum (cumulative, non-monotonic, int) | `{validation}` | `http.url`, `validation.type` | Disabled by default; stability `development`. Same gating and `validation.type` values as `httpcheck.validation.passed`. |

No resource attributes are defined by this component.

## Sources

- `receiver/httpcheckreceiver/metadata.yaml`
- `receiver/httpcheckreceiver/scraper.go`
- `receiver/httpcheckreceiver/config.go`
- `receiver/httpcheckreceiver/factory.go`
- `receiver/httpcheckreceiver/documentation.md`
- `receiver/httpcheckreceiver/internal/metadata/generated_metrics.go`
- `receiver/httpcheckreceiver/internal/metadata/generated_status.go`
        • v0.158.0.md 4.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/httpcheckreceiver
version: v0.158.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/httpcheckreceiver
commit_sha: 821a9d9c2c1623c4a0ceba5d47b57c48879c3f84
last_verified: 2026-08-11
---

# HTTP Check Receiver

Component type `http_check` (deprecated alias `httpcheck`). Metrics stability: alpha. All metrics below are emitted once per configured target endpoint per collection interval, and each can be toggled with `metrics::<name>::enabled`.

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `httpcheck.duration` | Gauge (int) | `ms` | `http.url` | Enabled by default; stability `development`. Wall-clock time of `client.Do`, recorded on every scrape including failures. |
| `httpcheck.error` | Sum (cumulative, non-monotonic, int) | `{error}` | `http.url`, `error.message` | Enabled by default; stability `development`. Recorded with value `1` only when the request returns an error; `error.message` is the Go error string. |
| `httpcheck.status` | Sum (cumulative, non-monotonic, int) | `1` | `http.url`, `http.status_code`, `http.method`, `http.status_class` | Enabled by default; stability `development`. One data point per status class (`1xx`–`5xx`) per scrape: `1` for the matching class, `0` for the others. For the `0`-valued points the `http.status_code` attribute is stripped by `removeStatusCodeForZeroValues` after `Emit`. |
| `httpcheck.response.size` | Gauge (int) | `By` | `http.url` | Disabled by default (`metrics::httpcheck.response.size::enabled: true`); stability `development`. Recorded only when the response body is non-empty. |
| `httpcheck.dns.lookup.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. From `httptrace` `DNSStart`/`DNSDone`; recorded every scrape, `0` when the phase did not occur (e.g. connection reuse or cached DNS). |
| `httpcheck.client.connection.duration` | Gauge (int) | `ns` | `http.url`, `network.transport` | Disabled by default; stability `development`. From `httptrace` `ConnectStart`/`ConnectDone`; `network.transport` is always the literal `tcp`. `0` when no new connection was established. |
| `httpcheck.tls.handshake.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. From `httptrace` `TLSHandshakeStart`/`TLSHandshakeDone`; `0` for plaintext HTTP or reused connections. |
| `httpcheck.client.request.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. Request-write phase (request start to `WroteRequest`). |
| `httpcheck.response.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. Response-read phase (`GotFirstResponseByte` to end of `client.Do`). |
| `httpcheck.tls.cert_remaining` | Gauge (int) | `s` | `http.url`, `http.tls.issuer`, `http.tls.cn`, `http.tls.san` | Disabled by default; stability `development`. Recorded only when the metric is enabled, the response carries TLS state with at least one peer certificate, and issuer/CN/SANs are non-empty. Seconds until `NotAfter`; negative after expiry. `http.tls.san` is a slice of IPs, URIs, DNS names and email addresses. |
| `httpcheck.validation.passed` | Sum (cumulative, non-monotonic, int) | `{validation}` | `http.url`, `validation.type` | Disabled by default; stability `development`. Requires `targets::validations` to be configured and a non-empty response body. `validation.type` is one of `contains`, `not_contains`, `json_path`, `size`, `regex`. |
| `httpcheck.validation.failed` | Sum (cumulative, non-monotonic, int) | `{validation}` | `http.url`, `validation.type` | Disabled by default; stability `development`. Same gating and `validation.type` values as `httpcheck.validation.passed`. |

No resource attributes are defined by this component.

## Sources

- `receiver/httpcheckreceiver/metadata.yaml`
- `receiver/httpcheckreceiver/scraper.go`
- `receiver/httpcheckreceiver/config.go`
- `receiver/httpcheckreceiver/factory.go`
- `receiver/httpcheckreceiver/documentation.md`
- `receiver/httpcheckreceiver/internal/metadata/generated_metrics.go`
- `receiver/httpcheckreceiver/internal/metadata/generated_status.go`
        • v0.159.0.md 2.3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/httpcheckreceiver
version: v0.159.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/httpcheckreceiver
commit_sha: 1120cc0714bf4d14600105e5673c3b00fe87467a
last_verified: null
---

# httpcheckreceiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `httpcheck.client.connection.duration` | Gauge (int) | ns | `http.url`, `network.transport` | disabled by default (`metrics::httpcheck.client.connection.duration.enabled`) |
| `httpcheck.client.request.duration` | Gauge (int) | ns | `http.url` | disabled by default (`metrics::httpcheck.client.request.duration.enabled`) |
| `httpcheck.dns.lookup.duration` | Gauge (int) | ns | `http.url` | disabled by default (`metrics::httpcheck.dns.lookup.duration.enabled`) |
| `httpcheck.duration` | Gauge (int) | ms | `http.url` | - |
| `httpcheck.error` | Sum (int, cumulative, non-monotonic) | `{error}` | `http.url`, `error.message` | - |
| `httpcheck.response.duration` | Gauge (int) | ns | `http.url` | disabled by default (`metrics::httpcheck.response.duration.enabled`) |
| `httpcheck.response.size` | Gauge (int) | By | `http.url` | disabled by default (`metrics::httpcheck.response.size.enabled`); recorded for non-empty bodies |
| `httpcheck.status` | Sum (int, cumulative, non-monotonic) | 1 | `http.url`, `http.status_code`, `http.method`, `http.status_class` | - |
| `httpcheck.tls.cert_remaining` | Gauge (int) | s | `http.url`, `http.tls.issuer`, `http.tls.cn`, `http.tls.san` | disabled by default (`metrics::httpcheck.tls.cert_remaining.enabled`); HTTPS only |
| `httpcheck.tls.handshake.duration` | Gauge (int) | ns | `http.url` | disabled by default (`metrics::httpcheck.tls.handshake.duration.enabled`) |
| `httpcheck.validation.failed` | Sum (int, cumulative, non-monotonic) | `{validation}` | `http.url`, `validation.type` | disabled by default (`metrics::httpcheck.validation.failed.enabled`); requires configured validations and non-empty body |
| `httpcheck.validation.passed` | Sum (int, cumulative, non-monotonic) | `{validation}` | `http.url`, `validation.type` | disabled by default (`metrics::httpcheck.validation.passed.enabled`); requires configured validations and non-empty body |

## Sources

- `receiver/httpcheckreceiver/metadata.yaml`
- `receiver/httpcheckreceiver/scraper.go`
        • v0.160.0.md 4.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/httpcheckreceiver
version: v0.160.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/httpcheckreceiver
commit_sha: 982f20b8a8e8a2569fab3e27cf8b008e8a5080c1
last_verified: 2026-09-03
---

# HTTP Check Receiver

Component type `http_check` (deprecated alias `httpcheck`). Metrics stability: alpha. All metrics below are emitted once per configured target endpoint per collection interval, and each can be toggled with `metrics::<name>::enabled`.

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `httpcheck.duration` | Gauge (int) | `ms` | `http.url` | Enabled by default; stability `development`. Wall-clock time of `client.Do`, recorded on every scrape including failures. |
| `httpcheck.error` | Sum (cumulative, non-monotonic, int) | `{error}` | `http.url`, `error.message` | Enabled by default; stability `development`. Recorded with value `1` only when the request returns an error; `error.message` is the Go error string. |
| `httpcheck.status` | Sum (cumulative, non-monotonic, int) | `1` | `http.url`, `http.status_code`, `http.method`, `http.status_class` | Enabled by default; stability `development`. One data point per status class (`1xx`–`5xx`) per scrape: `1` for the matching class, `0` for the others. For the `0`-valued points the `http.status_code` attribute is stripped by `removeStatusCodeForZeroValues` after `Emit`. |
| `httpcheck.response.size` | Gauge (int) | `By` | `http.url` | Disabled by default (`metrics::httpcheck.response.size::enabled: true`); stability `development`. Recorded only when the response body is non-empty. |
| `httpcheck.dns.lookup.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. From `httptrace` `DNSStart`/`DNSDone`; recorded every scrape, `0` when the phase did not occur (e.g. connection reuse or cached DNS). |
| `httpcheck.client.connection.duration` | Gauge (int) | `ns` | `http.url`, `network.transport` | Disabled by default; stability `development`. From `httptrace` `ConnectStart`/`ConnectDone`; `network.transport` is always the literal `tcp`. `0` when no new connection was established. |
| `httpcheck.tls.handshake.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. From `httptrace` `TLSHandshakeStart`/`TLSHandshakeDone`; `0` for plaintext HTTP or reused connections. |
| `httpcheck.client.request.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. Request-write phase (request start to `WroteRequest`). |
| `httpcheck.response.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. Response-read phase (`GotFirstResponseByte` to end of `client.Do`). |
| `httpcheck.tls.cert_remaining` | Gauge (int) | `s` | `http.url`, `http.tls.issuer`, `http.tls.cn`, `http.tls.san` | Disabled by default; stability `development`. Recorded only when the metric is enabled, the response carries TLS state with at least one peer certificate, and issuer/CN/SANs are non-empty. Seconds until `NotAfter`; negative after expiry. `http.tls.san` is a slice of IPs, URIs, DNS names and email addresses. |
| `httpcheck.validation.passed` | Sum (cumulative, non-monotonic, int) | `{validation}` | `http.url`, `validation.type` | Disabled by default; stability `development`. Requires `targets::validations` to be configured and a non-empty response body. `validation.type` is one of `contains`, `not_contains`, `json_path`, `size`, `regex`. |
| `httpcheck.validation.failed` | Sum (cumulative, non-monotonic, int) | `{validation}` | `http.url`, `validation.type` | Disabled by default; stability `development`. Same gating and `validation.type` values as `httpcheck.validation.passed`. |

No resource attributes are defined by this component.

## Sources

- `receiver/httpcheckreceiver/metadata.yaml`
- `receiver/httpcheckreceiver/scraper.go`
- `receiver/httpcheckreceiver/config.go`
- `receiver/httpcheckreceiver/factory.go`
- `receiver/httpcheckreceiver/documentation.md`
- `receiver/httpcheckreceiver/internal/metadata/generated_metrics.go`
- `receiver/httpcheckreceiver/internal/metadata/generated_status.go`
        • v0.161.0.md 4.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/httpcheckreceiver
version: v0.161.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/httpcheckreceiver
commit_sha: 3f8455d8038a985398861171e5310bc9b4e988b2
last_verified: 2026-10-03
---

# HTTP Check Receiver

Component type `http_check` (deprecated alias `httpcheck`). Metrics stability: alpha. Metrics are scraped per configured target endpoint per collection interval, subject to the per-metric conditions in Notes; each can be toggled with `metrics::<name>::enabled`.

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `httpcheck.duration` | Gauge (int) | `ms` | `http.url` | Enabled by default; stability `development`. Wall-clock time of `client.Do`, recorded on every scrape including failures. |
| `httpcheck.error` | Sum (cumulative, non-monotonic, int) | `{error}` | `http.url`, `error.message` | Enabled by default; stability `development`. Recorded with value `1` only when the request returns an error; `error.message` is the Go error string. |
| `httpcheck.status` | Sum (cumulative, non-monotonic, int) | `1` | `http.url`, `http.status_code`, `http.method`, `http.status_class` | Enabled by default; stability `development`. One data point per status class (`1xx`–`5xx`) per scrape: `1` for the matching class, `0` for the others. For the `0`-valued points the `http.status_code` attribute is stripped by `removeStatusCodeForZeroValues` after `Emit`. |
| `httpcheck.response.size` | Gauge (int) | `By` | `http.url` | Disabled by default (`metrics::httpcheck.response.size::enabled: true`); stability `development`. Recorded only when the response body is non-empty. |
| `httpcheck.dns.lookup.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. From `httptrace` `DNSStart`/`DNSDone`; recorded every scrape, `0` when the phase did not occur (e.g. connection reuse or cached DNS). |
| `httpcheck.client.connection.duration` | Gauge (int) | `ns` | `http.url`, `network.transport` | Disabled by default; stability `development`. From `httptrace` `ConnectStart`/`ConnectDone`; `network.transport` is always the literal `tcp`. `0` when no new connection was established. |
| `httpcheck.tls.handshake.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. From `httptrace` `TLSHandshakeStart`/`TLSHandshakeDone`; `0` for plaintext HTTP or reused connections. |
| `httpcheck.client.request.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. Request-write phase (request start to `WroteRequest`). |
| `httpcheck.response.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. Response-read phase (`GotFirstResponseByte` to end of `client.Do`). |
| `httpcheck.tls.cert_remaining` | Gauge (int) | `s` | `http.url`, `http.tls.issuer`, `http.tls.cn`, `http.tls.san` | Disabled by default; stability `development`. Recorded only when the metric is enabled, the response carries TLS state with at least one peer certificate, and at least one of issuer, CN, or SANs is non-empty. Seconds until `NotAfter`; negative after expiry. `http.tls.san` is a slice of IPs, URIs, DNS names and email addresses. |
| `httpcheck.validation.passed` | Sum (cumulative, non-monotonic, int) | `{validation}` | `http.url`, `validation.type` | Disabled by default; stability `development`. Requires `targets::validations` to be configured and a non-empty response body. `validation.type` is one of `contains`, `not_contains`, `json_path`, `size`, `regex`. |
| `httpcheck.validation.failed` | Sum (cumulative, non-monotonic, int) | `{validation}` | `http.url`, `validation.type` | Disabled by default; stability `development`. Same gating and `validation.type` values as `httpcheck.validation.passed`. |

No resource attributes are defined by this component.

## Sources

- `receiver/httpcheckreceiver/metadata.yaml`
- `receiver/httpcheckreceiver/scraper.go`
- `receiver/httpcheckreceiver/config.go`
- `receiver/httpcheckreceiver/factory.go`
- `receiver/httpcheckreceiver/documentation.md`
- `receiver/httpcheckreceiver/internal/metadata/generated_metrics.go`
- `receiver/httpcheckreceiver/internal/metadata/generated_status.go`
        • v0.162.0.md 4.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/httpcheckreceiver
version: v0.162.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/httpcheckreceiver
commit_sha: ae8c507510f48f433ab47dd1c6b01a59d6c388b5
last_verified: 2026-10-03
---

# HTTP Check Receiver

Component type `http_check` (deprecated alias `httpcheck`). Metrics stability: alpha. Metrics below are recorded per configured target endpoint per collection interval, subject to the conditions in each row, and each can be toggled with `metrics::<name>::enabled`.

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `httpcheck.duration` | Gauge (int) | `ms` | `http.url` | Enabled by default; stability `development`. Wall-clock time of `client.Do`, recorded on every scrape including failures. |
| `httpcheck.error` | Sum (cumulative, non-monotonic, int) | `{error}` | `http.url`, `error.message` | Enabled by default; stability `development`. Recorded with value `1` only when the request returns an error; `error.message` is the Go error string. |
| `httpcheck.status` | Sum (cumulative, non-monotonic, int) | `1` | `http.url`, `http.status_code`, `http.method`, `http.status_class` | Enabled by default; stability `development`. One data point per status class (`1xx`–`5xx`) per scrape: `1` for the matching class, `0` for the others. For the `0`-valued points the `http.status_code` attribute is stripped by `removeStatusCodeForZeroValues` after `Emit`. |
| `httpcheck.response.size` | Gauge (int) | `By` | `http.url` | Disabled by default (`metrics::httpcheck.response.size::enabled: true`); stability `development`. Recorded only when the response body is non-empty. |
| `httpcheck.dns.lookup.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. From `httptrace` `DNSStart`/`DNSDone`; recorded every scrape, `0` when the phase did not occur (e.g. connection reuse or cached DNS). |
| `httpcheck.client.connection.duration` | Gauge (int) | `ns` | `http.url`, `network.transport` | Disabled by default; stability `development`. From `httptrace` `ConnectStart`/`ConnectDone`; `network.transport` is always the literal `tcp`. `0` when no new connection was established. |
| `httpcheck.tls.handshake.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. From `httptrace` `TLSHandshakeStart`/`TLSHandshakeDone`; `0` for plaintext HTTP or reused connections. |
| `httpcheck.client.request.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. Request-write phase (request start to `WroteRequest`). |
| `httpcheck.response.duration` | Gauge (int) | `ns` | `http.url` | Disabled by default; stability `development`. Response-read phase (`GotFirstResponseByte` to end of `client.Do`). |
| `httpcheck.tls.cert_remaining` | Gauge (int) | `s` | `http.url`, `http.tls.issuer`, `http.tls.cn`, `http.tls.san` | Disabled by default; stability `development`. Recorded only when the metric is enabled, the response carries TLS state with at least one peer certificate, and at least one of issuer, CN, or SANs is non-empty. Seconds until `NotAfter`; negative after expiry. `http.tls.san` is a slice of IPs, URIs, DNS names and email addresses. |
| `httpcheck.validation.passed` | Sum (cumulative, non-monotonic, int) | `{validation}` | `http.url`, `validation.type` | Disabled by default; stability `development`. Requires `targets::validations` to be configured and a non-empty response body. `validation.type` is one of `contains`, `not_contains`, `json_path`, `size`, `regex`. |
| `httpcheck.validation.failed` | Sum (cumulative, non-monotonic, int) | `{validation}` | `http.url`, `validation.type` | Disabled by default; stability `development`. Same gating and `validation.type` values as `httpcheck.validation.passed`. |

No resource attributes are defined by this component.

## Sources

- `receiver/httpcheckreceiver/metadata.yaml`
- `receiver/httpcheckreceiver/scraper.go`
- `receiver/httpcheckreceiver/config.go`
- `receiver/httpcheckreceiver/factory.go`
- `receiver/httpcheckreceiver/documentation.md`
- `receiver/httpcheckreceiver/internal/metadata/generated_metrics.go`
- `receiver/httpcheckreceiver/internal/metadata/generated_status.go`
        • v0.163.0.md 2.3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/httpcheckreceiver
version: v0.163.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/httpcheckreceiver
commit_sha: df849b5403c041d5e799e7846392a6f18b0b55ae
last_verified: null
---

# httpcheckreceiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `httpcheck.client.connection.duration` | Gauge (int) | ns | `http.url`, `network.transport` | disabled by default (`metrics::httpcheck.client.connection.duration.enabled`) |
| `httpcheck.client.request.duration` | Gauge (int) | ns | `http.url` | disabled by default (`metrics::httpcheck.client.request.duration.enabled`) |
| `httpcheck.dns.lookup.duration` | Gauge (int) | ns | `http.url` | disabled by default (`metrics::httpcheck.dns.lookup.duration.enabled`) |
| `httpcheck.duration` | Gauge (int) | ms | `http.url` | - |
| `httpcheck.error` | Sum (int, cumulative, non-monotonic) | `{error}` | `http.url`, `error.message` | - |
| `httpcheck.response.duration` | Gauge (int) | ns | `http.url` | disabled by default (`metrics::httpcheck.response.duration.enabled`) |
| `httpcheck.response.size` | Gauge (int) | By | `http.url` | disabled by default (`metrics::httpcheck.response.size.enabled`); recorded for non-empty bodies |
| `httpcheck.status` | Sum (int, cumulative, non-monotonic) | 1 | `http.url`, `http.status_code`, `http.method`, `http.status_class` | - |
| `httpcheck.tls.cert_remaining` | Gauge (int) | s | `http.url`, `http.tls.issuer`, `http.tls.cn`, `http.tls.san` | disabled by default (`metrics::httpcheck.tls.cert_remaining.enabled`); HTTPS only |
| `httpcheck.tls.handshake.duration` | Gauge (int) | ns | `http.url` | disabled by default (`metrics::httpcheck.tls.handshake.duration.enabled`) |
| `httpcheck.validation.failed` | Sum (int, cumulative, non-monotonic) | `{validation}` | `http.url`, `validation.type` | disabled by default (`metrics::httpcheck.validation.failed.enabled`); requires configured validations and non-empty body |
| `httpcheck.validation.passed` | Sum (int, cumulative, non-monotonic) | `{validation}` | `http.url`, `validation.type` | disabled by default (`metrics::httpcheck.validation.passed.enabled`); requires configured validations and non-empty body |

## Sources

- `receiver/httpcheckreceiver/metadata.yaml`
- `receiver/httpcheckreceiver/scraper.go`
      • icmpcheckreceiver
        • v0.153.0.md 2.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/icmpcheckreceiver
version: v0.153.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/icmpcheckreceiver
commit_sha: 42f949127580c0d00088b785cd0b35842dc0ddb8
last_verified: 2026-08-11
---

# icmpcheckreceiver

## Metrics

All metrics are emitted once per configured `targets[]` entry per scrape interval, on a separate resource carrying the target's resource attributes. All are `enabled: true` by default and can be disabled via `metrics::<name>::enabled: false`. Component metrics stability is `development`.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `ping.loss.ratio` | Gauge (Double) | `%` | Resource: `net.peer.ip`, `net.peer.name` | The percentage of lost packets. Taken from pro-bing `Statistics.PacketLoss`. |
| `ping.rtt.avg` | Gauge (Int) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Average round-trip time. Recorded as `stats.avgRtt.Milliseconds()` — truncated to whole milliseconds (changed to Double in v0.158.0). |
| `ping.rtt.max` | Gauge (Int) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Maximum round-trip time. Recorded as `stats.maxRtt.Milliseconds()` — truncated to whole milliseconds (changed to Double in v0.158.0). |
| `ping.rtt.min` | Gauge (Int) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Minimum round-trip time. Recorded as `stats.minRtt.Milliseconds()` — truncated to whole milliseconds (changed to Double in v0.158.0). |
| `ping.rtt.stddev` | Gauge (Int) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Standard deviation of round-trip time. Recorded as `stats.stdDevRtt.Milliseconds()` — truncated to whole milliseconds (changed to Double in v0.158.0). |

### Resource attributes

| Attribute | Type | Enabled by default | Notes |
|---|---|---|---|
| `net.peer.ip` | string | yes | IP address of the pinged host, from `pinger.IPString()`. Empty when the ping failed. |
| `net.peer.name` | string | yes | Hostname of the pinged host, the configured `targets[].host`. |

No metrics are emitted for a target whose ping returned an error; the scrape logs the failure instead.

## Logs

The receiver emits no OTLP log records into its pipeline. It writes the following to the Collector's internal (zap) logger.

| Log/event name | Attributes | Notes |
|---|---|---|
| `failed to ping host` (ERROR) | `host` (target hostname), `error` | Emitted per target when `pinger.Run()` or pinger construction fails; that target contributes no metrics for the scrape. |

## Sources

- `receiver/icmpcheckreceiver/metadata.yaml`
- `receiver/icmpcheckreceiver/documentation.md`
- `receiver/icmpcheckreceiver/scraper.go`
- `receiver/icmpcheckreceiver/pinger.go`
- `receiver/icmpcheckreceiver/internal/metadata/generated_metrics.go`
- `receiver/icmpcheckreceiver/internal/metadata/generated_resource.go`
- `receiver/icmpcheckreceiver/internal/metadata/generated_status.go`
        • v0.154.0.md 2.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/icmpcheckreceiver
version: v0.154.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/icmpcheckreceiver
commit_sha: 853eda0e12b3ba142552ecd2b63cec07062904f0
last_verified: 2026-08-11
---

# icmpcheckreceiver

## Metrics

All metrics are emitted once per configured `targets[]` entry per scrape interval, on a separate resource carrying the target's resource attributes. All are `enabled: true` by default and can be disabled via `metrics::<name>::enabled: false`. Component metrics stability is `development`.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `ping.loss.ratio` | Gauge (Double) | `%` | Resource: `net.peer.ip`, `net.peer.name` | The percentage of lost packets. Taken from pro-bing `Statistics.PacketLoss`. |
| `ping.rtt.avg` | Gauge (Int) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Average round-trip time. Recorded as `stats.avgRtt.Milliseconds()` — truncated to whole milliseconds (changed to Double in v0.158.0). |
| `ping.rtt.max` | Gauge (Int) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Maximum round-trip time. Recorded as `stats.maxRtt.Milliseconds()` — truncated to whole milliseconds (changed to Double in v0.158.0). |
| `ping.rtt.min` | Gauge (Int) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Minimum round-trip time. Recorded as `stats.minRtt.Milliseconds()` — truncated to whole milliseconds (changed to Double in v0.158.0). |
| `ping.rtt.stddev` | Gauge (Int) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Standard deviation of round-trip time. Recorded as `stats.stdDevRtt.Milliseconds()` — truncated to whole milliseconds (changed to Double in v0.158.0). |

### Resource attributes

| Attribute | Type | Enabled by default | Notes |
|---|---|---|---|
| `net.peer.ip` | string | yes | IP address of the pinged host, from `pinger.IPString()`. Empty when the ping failed. |
| `net.peer.name` | string | yes | Hostname of the pinged host, the configured `targets[].host`. |

No metrics are emitted for a target whose ping returned an error; the scrape logs the failure instead.

## Logs

The receiver emits no OTLP log records into its pipeline. It writes the following to the Collector's internal (zap) logger.

| Log/event name | Attributes | Notes |
|---|---|---|
| `failed to ping host` (ERROR) | `host` (target hostname), `error` | Emitted per target when `pinger.Run()` or pinger construction fails; that target contributes no metrics for the scrape. |

## Sources

- `receiver/icmpcheckreceiver/metadata.yaml`
- `receiver/icmpcheckreceiver/documentation.md`
- `receiver/icmpcheckreceiver/scraper.go`
- `receiver/icmpcheckreceiver/pinger.go`
- `receiver/icmpcheckreceiver/internal/metadata/generated_metrics.go`
- `receiver/icmpcheckreceiver/internal/metadata/generated_resource.go`
- `receiver/icmpcheckreceiver/internal/metadata/generated_status.go`
        • v0.155.0.md 2.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/icmpcheckreceiver
version: v0.155.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/icmpcheckreceiver
commit_sha: aaf5045a24c0a6f000225c97ad5449e69aeb5835
last_verified: 2026-08-11
---

# icmpcheckreceiver

## Metrics

All metrics are emitted once per configured `targets[]` entry per scrape interval, on a separate resource carrying the target's resource attributes. All are `enabled: true` by default and can be disabled via `metrics::<name>::enabled: false`. Component metrics stability is `development`.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `ping.loss.ratio` | Gauge (Double) | `%` | Resource: `net.peer.ip`, `net.peer.name` | The percentage of lost packets. Taken from pro-bing `Statistics.PacketLoss`. |
| `ping.rtt.avg` | Gauge (Int) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Average round-trip time. Recorded as `stats.avgRtt.Milliseconds()` — truncated to whole milliseconds (changed to Double in v0.158.0). |
| `ping.rtt.max` | Gauge (Int) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Maximum round-trip time. Recorded as `stats.maxRtt.Milliseconds()` — truncated to whole milliseconds (changed to Double in v0.158.0). |
| `ping.rtt.min` | Gauge (Int) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Minimum round-trip time. Recorded as `stats.minRtt.Milliseconds()` — truncated to whole milliseconds (changed to Double in v0.158.0). |
| `ping.rtt.stddev` | Gauge (Int) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Standard deviation of round-trip time. Recorded as `stats.stdDevRtt.Milliseconds()` — truncated to whole milliseconds (changed to Double in v0.158.0). |

### Resource attributes

| Attribute | Type | Enabled by default | Notes |
|---|---|---|---|
| `net.peer.ip` | string | yes | IP address of the pinged host, from `pinger.IPString()`. Empty when the ping failed. |
| `net.peer.name` | string | yes | Hostname of the pinged host, the configured `targets[].host`. |

No metrics are emitted for a target whose ping returned an error; the scrape logs the failure instead.

## Logs

The receiver emits no OTLP log records into its pipeline. It writes the following to the Collector's internal (zap) logger.

| Log/event name | Attributes | Notes |
|---|---|---|
| `failed to ping host` (ERROR) | `host` (target hostname), `error` | Emitted per target when `pinger.Run()` or pinger construction fails; that target contributes no metrics for the scrape. |

## Sources

- `receiver/icmpcheckreceiver/metadata.yaml`
- `receiver/icmpcheckreceiver/documentation.md`
- `receiver/icmpcheckreceiver/scraper.go`
- `receiver/icmpcheckreceiver/pinger.go`
- `receiver/icmpcheckreceiver/internal/metadata/generated_metrics.go`
- `receiver/icmpcheckreceiver/internal/metadata/generated_resource.go`
- `receiver/icmpcheckreceiver/internal/metadata/generated_status.go`
        • v0.156.0.md 2.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/icmpcheckreceiver
version: v0.156.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/icmpcheckreceiver
commit_sha: 41e24cd516dd69a5b4277465cdb2ff4ef0676f49
last_verified: 2026-08-11
---

# icmpcheckreceiver

## Metrics

All metrics are emitted once per configured `targets[]` entry per scrape interval, on a separate resource carrying the target's resource attributes. All are `enabled: true` by default and can be disabled via `metrics::<name>::enabled: false`. Component metrics stability is `development`.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `ping.loss.ratio` | Gauge (Double) | `%` | Resource: `net.peer.ip`, `net.peer.name` | The percentage of lost packets. Taken from pro-bing `Statistics.PacketLoss`. |
| `ping.rtt.avg` | Gauge (Int) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Average round-trip time. Recorded as `stats.avgRtt.Milliseconds()` — truncated to whole milliseconds (changed to Double in v0.158.0). |
| `ping.rtt.max` | Gauge (Int) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Maximum round-trip time. Recorded as `stats.maxRtt.Milliseconds()` — truncated to whole milliseconds (changed to Double in v0.158.0). |
| `ping.rtt.min` | Gauge (Int) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Minimum round-trip time. Recorded as `stats.minRtt.Milliseconds()` — truncated to whole milliseconds (changed to Double in v0.158.0). |
| `ping.rtt.stddev` | Gauge (Int) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Standard deviation of round-trip time. Recorded as `stats.stdDevRtt.Milliseconds()` — truncated to whole milliseconds (changed to Double in v0.158.0). |

### Resource attributes

| Attribute | Type | Enabled by default | Notes |
|---|---|---|---|
| `net.peer.ip` | string | yes | IP address of the pinged host, from `pinger.IPString()`. Empty when the ping failed. |
| `net.peer.name` | string | yes | Hostname of the pinged host, the configured `targets[].host`. |

No metrics are emitted for a target whose ping returned an error; the scrape logs the failure instead.

## Logs

The receiver emits no OTLP log records into its pipeline. It writes the following to the Collector's internal (zap) logger.

| Log/event name | Attributes | Notes |
|---|---|---|
| `failed to ping host` (ERROR) | `host` (target hostname), `error` | Emitted per target when `pinger.Run()` or pinger construction fails; that target contributes no metrics for the scrape. |

## Sources

- `receiver/icmpcheckreceiver/metadata.yaml`
- `receiver/icmpcheckreceiver/documentation.md`
- `receiver/icmpcheckreceiver/scraper.go`
- `receiver/icmpcheckreceiver/pinger.go`
- `receiver/icmpcheckreceiver/internal/metadata/generated_metrics.go`
- `receiver/icmpcheckreceiver/internal/metadata/generated_resource.go`
- `receiver/icmpcheckreceiver/internal/metadata/generated_status.go`
        • v0.157.0.md 2.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/icmpcheckreceiver
version: v0.157.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/icmpcheckreceiver
commit_sha: 89e43555904cd97c2d36605347c5d5237b1bdc8c
last_verified: 2026-08-11
---

# icmpcheckreceiver

## Metrics

All metrics are emitted once per configured `targets[]` entry per scrape interval, on a separate resource carrying the target's resource attributes. All are `enabled: true` by default and can be disabled via `metrics::<name>::enabled: false`. Component metrics stability is `development`.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `ping.loss.ratio` | Gauge (Double) | `%` | Resource: `net.peer.ip`, `net.peer.name` | The percentage of lost packets. Taken from pro-bing `Statistics.PacketLoss`. |
| `ping.rtt.avg` | Gauge (Int) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Average round-trip time. Recorded as `stats.avgRtt.Milliseconds()` — truncated to whole milliseconds (changed to Double in v0.158.0). |
| `ping.rtt.max` | Gauge (Int) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Maximum round-trip time. Recorded as `stats.maxRtt.Milliseconds()` — truncated to whole milliseconds (changed to Double in v0.158.0). |
| `ping.rtt.min` | Gauge (Int) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Minimum round-trip time. Recorded as `stats.minRtt.Milliseconds()` — truncated to whole milliseconds (changed to Double in v0.158.0). |
| `ping.rtt.stddev` | Gauge (Int) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Standard deviation of round-trip time. Recorded as `stats.stdDevRtt.Milliseconds()` — truncated to whole milliseconds (changed to Double in v0.158.0). |

### Resource attributes

| Attribute | Type | Enabled by default | Notes |
|---|---|---|---|
| `net.peer.ip` | string | yes | IP address of the pinged host, from `pinger.IPString()`. Empty when the ping failed. |
| `net.peer.name` | string | yes | Hostname of the pinged host, the configured `targets[].host`. |

No metrics are emitted for a target whose ping returned an error; the scrape logs the failure instead.

## Logs

The receiver emits no OTLP log records into its pipeline. It writes the following to the Collector's internal (zap) logger.

| Log/event name | Attributes | Notes |
|---|---|---|
| `failed to ping host` (ERROR) | `host` (target hostname), `error` | Emitted per target when `pinger.Run()` or pinger construction fails; that target contributes no metrics for the scrape. |

## Sources

- `receiver/icmpcheckreceiver/metadata.yaml`
- `receiver/icmpcheckreceiver/documentation.md`
- `receiver/icmpcheckreceiver/scraper.go`
- `receiver/icmpcheckreceiver/pinger.go`
- `receiver/icmpcheckreceiver/internal/metadata/generated_metrics.go`
- `receiver/icmpcheckreceiver/internal/metadata/generated_resource.go`
- `receiver/icmpcheckreceiver/internal/metadata/generated_status.go`
        • v0.158.0.md 2.7 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/icmpcheckreceiver
version: v0.158.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/icmpcheckreceiver
commit_sha: 821a9d9c2c1623c4a0ceba5d47b57c48879c3f84
last_verified: 2026-08-11
---

# icmpcheckreceiver

## Metrics

All metrics are emitted once per configured `targets[]` entry per scrape interval, on a separate resource carrying the target's resource attributes. All are `enabled: true` by default and can be disabled via `metrics::<name>::enabled: false`. Component metrics stability is `development`.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `ping.loss.ratio` | Gauge (Double) | `%` | Resource: `net.peer.ip`, `net.peer.name` | The percentage of lost packets. Taken from pro-bing `Statistics.PacketLoss`. |
| `ping.rtt.avg` | Gauge (Double) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Average round-trip time. Recorded as `stats.avgRtt.Seconds()*1000` (sub-millisecond precision). |
| `ping.rtt.max` | Gauge (Double) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Maximum round-trip time. Recorded as `stats.maxRtt.Seconds()*1000` (sub-millisecond precision). |
| `ping.rtt.min` | Gauge (Double) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Minimum round-trip time. Recorded as `stats.minRtt.Seconds()*1000` (sub-millisecond precision). |
| `ping.rtt.stddev` | Gauge (Double) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Standard deviation of round-trip time. Recorded as `stats.stdDevRtt.Seconds()*1000` (sub-millisecond precision). |

### Resource attributes

| Attribute | Type | Enabled by default | Notes |
|---|---|---|---|
| `net.peer.ip` | string | yes | IP address of the pinged host, from `pinger.IPString()`. Empty when the ping failed. |
| `net.peer.name` | string | yes | Hostname of the pinged host, the configured `targets[].host`. |

No metrics are emitted for a target whose ping returned an error; the scrape logs the failure instead.

## Logs

The receiver emits no OTLP log records into its pipeline. It writes the following to the Collector's internal (zap) logger.

| Log/event name | Attributes | Notes |
|---|---|---|
| `failed to ping host` (ERROR) | `host` (target hostname), `error` | Emitted per target when `pinger.Run()` or pinger construction fails; that target contributes no metrics for the scrape. |

## Sources

- `receiver/icmpcheckreceiver/metadata.yaml`
- `receiver/icmpcheckreceiver/documentation.md`
- `receiver/icmpcheckreceiver/scraper.go`
- `receiver/icmpcheckreceiver/pinger.go`
- `receiver/icmpcheckreceiver/internal/metadata/generated_metrics.go`
- `receiver/icmpcheckreceiver/internal/metadata/generated_resource.go`
- `receiver/icmpcheckreceiver/internal/metadata/generated_status.go`
        • v0.159.0.md 880 B 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/icmpcheckreceiver
version: v0.159.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/icmpcheckreceiver
commit_sha: 1120cc0714bf4d14600105e5673c3b00fe87467a
last_verified: 2026-10-14
---

# ICMP Check Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| ping.loss.ratio | Gauge | % | net.peer.ip, net.peer.name | - |
| ping.rtt.avg | Gauge | ms | net.peer.ip, net.peer.name | - |
| ping.rtt.max | Gauge | ms | net.peer.ip, net.peer.name | - |
| ping.rtt.min | Gauge | ms | net.peer.ip, net.peer.name | - |
| ping.rtt.stddev | Gauge | ms | net.peer.ip, net.peer.name | - |

## Sources

- receiver/icmpcheckreceiver/metadata.yaml
- receiver/icmpcheckreceiver/scraper.go
- receiver/icmpcheckreceiver/internal/metadata/generated_status.go
        • v0.160.0.md 2.7 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/icmpcheckreceiver
version: v0.160.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/icmpcheckreceiver
commit_sha: 982f20b8a8e8a2569fab3e27cf8b008e8a5080c1
last_verified: 2026-09-03
---

# icmpcheckreceiver

## Metrics

All metrics are emitted once per configured `targets[]` entry per scrape interval, on a separate resource carrying the target's resource attributes. All are `enabled: true` by default and can be disabled via `metrics::<name>::enabled: false`. Component metrics stability is `development`.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `ping.loss.ratio` | Gauge (Double) | `%` | Resource: `net.peer.ip`, `net.peer.name` | The percentage of lost packets. Taken from pro-bing `Statistics.PacketLoss`. |
| `ping.rtt.avg` | Gauge (Double) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Average round-trip time. Recorded as `stats.avgRtt.Seconds()*1000` (sub-millisecond precision). |
| `ping.rtt.max` | Gauge (Double) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Maximum round-trip time. Recorded as `stats.maxRtt.Seconds()*1000` (sub-millisecond precision). |
| `ping.rtt.min` | Gauge (Double) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Minimum round-trip time. Recorded as `stats.minRtt.Seconds()*1000` (sub-millisecond precision). |
| `ping.rtt.stddev` | Gauge (Double) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Standard deviation of round-trip time. Recorded as `stats.stdDevRtt.Seconds()*1000` (sub-millisecond precision). |

### Resource attributes

| Attribute | Type | Enabled by default | Notes |
|---|---|---|---|
| `net.peer.ip` | string | yes | IP address of the pinged host, from `pinger.IPString()`. Empty when the ping failed. |
| `net.peer.name` | string | yes | Hostname of the pinged host, the configured `targets[].host`. |

No metrics are emitted for a target whose ping returned an error; the scrape logs the failure instead.

## Logs

The receiver emits no OTLP log records into its pipeline. It writes the following to the Collector's internal (zap) logger.

| Log/event name | Attributes | Notes |
|---|---|---|
| `failed to ping host` (ERROR) | `host` (target hostname), `error` | Emitted per target when `pinger.Run()` or pinger construction fails; that target contributes no metrics for the scrape. |

## Sources

- `receiver/icmpcheckreceiver/metadata.yaml`
- `receiver/icmpcheckreceiver/documentation.md`
- `receiver/icmpcheckreceiver/scraper.go`
- `receiver/icmpcheckreceiver/pinger.go`
- `receiver/icmpcheckreceiver/internal/metadata/generated_metrics.go`
- `receiver/icmpcheckreceiver/internal/metadata/generated_resource.go`
- `receiver/icmpcheckreceiver/internal/metadata/generated_status.go`
        • v0.161.0.md 2.7 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/icmpcheckreceiver
version: v0.161.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/icmpcheckreceiver
commit_sha: 3f8455d8038a985398861171e5310bc9b4e988b2
last_verified: 2026-10-03
---

# icmpcheckreceiver

## Metrics

All metrics are emitted once per configured `targets[]` entry per scrape interval, on a separate resource carrying the target's resource attributes. All are `enabled: true` by default and can be disabled via `metrics::<name>::enabled: false`. Component metrics stability is `development`.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `ping.loss.ratio` | Gauge (Double) | `%` | Resource: `net.peer.ip`, `net.peer.name` | The percentage of lost packets. Taken from pro-bing `Statistics.PacketLoss`. |
| `ping.rtt.avg` | Gauge (Double) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Average round-trip time. Recorded as `stats.avgRtt.Seconds()*1000` (sub-millisecond precision). |
| `ping.rtt.max` | Gauge (Double) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Maximum round-trip time. Recorded as `stats.maxRtt.Seconds()*1000` (sub-millisecond precision). |
| `ping.rtt.min` | Gauge (Double) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Minimum round-trip time. Recorded as `stats.minRtt.Seconds()*1000` (sub-millisecond precision). |
| `ping.rtt.stddev` | Gauge (Double) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Standard deviation of round-trip time. Recorded as `stats.stdDevRtt.Seconds()*1000` (sub-millisecond precision). |

### Resource attributes

| Attribute | Type | Enabled by default | Notes |
|---|---|---|---|
| `net.peer.ip` | string | yes | IP address of the pinged host, from `pinger.IPString()`. Empty when the ping failed. |
| `net.peer.name` | string | yes | Hostname of the pinged host, the configured `targets[].host`. |

No metrics are emitted for a target whose ping returned an error; the scrape logs the failure instead.

## Logs

The receiver emits no OTLP log records into its pipeline. It writes the following to the Collector's internal (zap) logger.

| Log/event name | Attributes | Notes |
|---|---|---|
| `failed to ping host` (ERROR) | `host` (target hostname), `error` | Emitted per target when `pinger.Run()` or pinger construction fails; that target contributes no metrics for the scrape. |

## Sources

- `receiver/icmpcheckreceiver/metadata.yaml`
- `receiver/icmpcheckreceiver/documentation.md`
- `receiver/icmpcheckreceiver/scraper.go`
- `receiver/icmpcheckreceiver/pinger.go`
- `receiver/icmpcheckreceiver/internal/metadata/generated_metrics.go`
- `receiver/icmpcheckreceiver/internal/metadata/generated_resource.go`
- `receiver/icmpcheckreceiver/internal/metadata/generated_status.go`
        • v0.162.0.md 2.7 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/icmpcheckreceiver
version: v0.162.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/icmpcheckreceiver
commit_sha: ae8c507510f48f433ab47dd1c6b01a59d6c388b5
last_verified: 2026-10-03
---

# icmpcheckreceiver

## Metrics

All metrics are emitted once per configured `targets[]` entry per scrape interval, on a separate resource carrying the target's resource attributes. All are `enabled: true` by default and can be disabled via `metrics::<name>::enabled: false`. Component metrics stability is `development`.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `ping.loss.ratio` | Gauge (Double) | `%` | Resource: `net.peer.ip`, `net.peer.name` | The percentage of lost packets. Taken from pro-bing `Statistics.PacketLoss`. |
| `ping.rtt.avg` | Gauge (Double) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Average round-trip time. Recorded as `stats.avgRtt.Seconds()*1000` (sub-millisecond precision). |
| `ping.rtt.max` | Gauge (Double) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Maximum round-trip time. Recorded as `stats.maxRtt.Seconds()*1000` (sub-millisecond precision). |
| `ping.rtt.min` | Gauge (Double) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Minimum round-trip time. Recorded as `stats.minRtt.Seconds()*1000` (sub-millisecond precision). |
| `ping.rtt.stddev` | Gauge (Double) | `ms` | Resource: `net.peer.ip`, `net.peer.name` | Standard deviation of round-trip time. Recorded as `stats.stdDevRtt.Seconds()*1000` (sub-millisecond precision). |

### Resource attributes

| Attribute | Type | Enabled by default | Notes |
|---|---|---|---|
| `net.peer.ip` | string | yes | IP address of the pinged host, from `pinger.IPString()`. Empty when the ping failed. |
| `net.peer.name` | string | yes | Hostname of the pinged host, the configured `targets[].host`. |

No metrics are emitted for a target whose ping returned an error; the scrape logs the failure instead.

## Logs

The receiver emits no OTLP log records into its pipeline. It writes the following to the Collector's internal (zap) logger.

| Log/event name | Attributes | Notes |
|---|---|---|
| `failed to ping host` (ERROR) | `host` (target hostname), `error` | Emitted per target when `pinger.Run()` or pinger construction fails; that target contributes no metrics for the scrape. |

## Sources

- `receiver/icmpcheckreceiver/metadata.yaml`
- `receiver/icmpcheckreceiver/documentation.md`
- `receiver/icmpcheckreceiver/scraper.go`
- `receiver/icmpcheckreceiver/pinger.go`
- `receiver/icmpcheckreceiver/internal/metadata/generated_metrics.go`
- `receiver/icmpcheckreceiver/internal/metadata/generated_resource.go`
- `receiver/icmpcheckreceiver/internal/metadata/generated_status.go`
        • v0.163.0.md 880 B 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/icmpcheckreceiver
version: v0.163.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/icmpcheckreceiver
commit_sha: df849b5403c041d5e799e7846392a6f18b0b55ae
last_verified: 2026-10-14
---

# ICMP Check Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| ping.loss.ratio | Gauge | % | net.peer.ip, net.peer.name | - |
| ping.rtt.avg | Gauge | ms | net.peer.ip, net.peer.name | - |
| ping.rtt.max | Gauge | ms | net.peer.ip, net.peer.name | - |
| ping.rtt.min | Gauge | ms | net.peer.ip, net.peer.name | - |
| ping.rtt.stddev | Gauge | ms | net.peer.ip, net.peer.name | - |

## Sources

- receiver/icmpcheckreceiver/metadata.yaml
- receiver/icmpcheckreceiver/scraper.go
- receiver/icmpcheckreceiver/internal/metadata/generated_status.go
      • k8sclusterreceiver
        • v0.153.0.md 6.4 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/k8sclusterreceiver
version: v0.153.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/k8sclusterreceiver
commit_sha: 42f949127580c0d00088b785cd0b35842dc0ddb8
last_verified: 2026-08-11
---

# Kubernetes Cluster Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `k8s.container.cpu_limit` | Gauge (double) | `{cpu}` | - | - |
| `k8s.container.cpu_request` | Gauge (double) | `{cpu}` | - | - |
| `k8s.container.ephemeralstorage_limit` | Gauge (int) | `By` | - | - |
| `k8s.container.ephemeralstorage_request` | Gauge (int) | `By` | - | - |
| `k8s.container.memory_limit` | Gauge (int) | `By` | - | - |
| `k8s.container.memory_request` | Gauge (int) | `By` | - | - |
| `k8s.container.ready` | Gauge (int) | `""` | - | - |
| `k8s.container.restarts` | Gauge (int) | `{restart}` | - | - |
| `k8s.container.status.reason` | Sum (non-monotonic, cumulative; int) | `{container}` | `k8s.container.status.reason` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.container.status.state` | Sum (non-monotonic, cumulative; int) | `{container}` | `k8s.container.status.state` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.container.storage_limit` | Gauge (int) | `By` | - | - |
| `k8s.container.storage_request` | Gauge (int) | `By` | - | - |
| `k8s.cronjob.active_jobs` | Gauge (int) | `{job}` | - | - |
| `k8s.daemonset.current_scheduled_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.daemonset.desired_scheduled_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.daemonset.misscheduled_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.daemonset.ready_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.deployment.available` | Gauge (int) | `{pod}` | - | - |
| `k8s.deployment.desired` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.current_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.desired_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.max_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.min_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.active_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.desired_successful_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.failed_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.max_parallel_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.successful_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.namespace.phase` | Gauge (int) | `""` | - | - |
| `k8s.node.condition` | Gauge (int) | `{condition}` | `condition` | Disabled by default; controlled by `node_conditions_to_report` (Ready is enabled by default in the generated per-condition configuration). |
| `k8s.persistentvolume.status.phase` | Sum (non-monotonic, cumulative; int) | `{persistentvolume}` | `k8s.persistentvolume.status.phase` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolume.storage.capacity` | Sum (non-monotonic, cumulative; int) | `By` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolumeclaim.status.phase` | Sum (non-monotonic, cumulative; int) | `{persistentvolumeclaim}` | `k8s.persistentvolumeclaim.status.phase` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolumeclaim.storage.capacity` | Sum (non-monotonic, cumulative; int) | `By` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolumeclaim.storage.request` | Sum (non-monotonic, cumulative; int) | `By` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.pod.phase` | Gauge (int) | `""` | - | - |
| `k8s.pod.status_reason` | Gauge (int) | `""` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.replicaset.available` | Gauge (int) | `{pod}` | - | - |
| `k8s.replicaset.desired` | Gauge (int) | `{pod}` | - | - |
| `k8s.replication_controller.available` | Gauge (int) | `{pod}` | - | - |
| `k8s.replication_controller.desired` | Gauge (int) | `{pod}` | - | - |
| `k8s.resource_quota.hard_limit` | Gauge (int) | `{resource}` | `resource` | Emitted only for resources specified in the quota. |
| `k8s.resource_quota.used` | Gauge (int) | `{resource}` | `resource` | Emitted only for resources specified in the quota. |
| `k8s.service.endpoint.count` | Gauge (int) | `{endpoint}` | `k8s.service.endpoint.address_type`, `k8s.service.endpoint.condition`, `k8s.service.endpoint.zone` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.service.load_balancer.ingress.count` | Gauge (int) | `{ingress}` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.statefulset.current_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.statefulset.desired_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.statefulset.ready_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.statefulset.updated_pods` | Gauge (int) | `{pod}` | - | - |
| `openshift.appliedclusterquota.limit` | Gauge (int) | `{resource}` | `k8s.namespace.name`, `resource` | Emitted for OpenShift distribution. |
| `openshift.appliedclusterquota.used` | Gauge (int) | `{resource}` | `k8s.namespace.name`, `resource` | Emitted for OpenShift distribution. |
| `openshift.clusterquota.limit` | Gauge (int) | `{resource}` | `resource` | Emitted for OpenShift distribution. |
| `openshift.clusterquota.used` | Gauge (int) | `{resource}` | `resource` | Emitted for OpenShift distribution. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `entity_state` | `otel.entity.id`, `otel.entity.type`, `otel.entity.attributes`, optional `otel.entity.interval`, `otel.entity.event_as_log` scope marker | Emitted when a watched Kubernetes/OpenShift resource is added or its metadata is reported; requires a logs consumer. |
| `entity_delete` | `otel.entity.id`, `otel.entity.type`, `otel.entity.event.type`, `otel.entity.event_as_log` scope marker | Emitted when a watched resource is deleted; requires a logs consumer. |

## Sources

- `receiver/k8sclusterreceiver/metadata.yaml`
- `receiver/k8sclusterreceiver/receiver.go`
- `receiver/k8sclusterreceiver/watcher.go`
- `receiver/k8sclusterreceiver/internal/metadata/generated_metrics.go`
- `receiver/k8sclusterreceiver/internal/metadata/metadata.go`
- `receiver/k8sclusterreceiver/internal/metadata/entities.go`
- `receiver/k8sclusterreceiver/testdata/e2e/entities-test/expected-ns.yaml`
- `receiver/k8sclusterreceiver/testdata/e2e/entities-test/expected-pvc.yaml`
        • v0.154.0.md 6.4 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/k8sclusterreceiver
version: v0.154.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/k8sclusterreceiver
commit_sha: 853eda0e12b3ba142552ecd2b63cec07062904f0
last_verified: 2026-08-11
---

# Kubernetes Cluster Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `k8s.container.cpu_limit` | Gauge (double) | `{cpu}` | - | - |
| `k8s.container.cpu_request` | Gauge (double) | `{cpu}` | - | - |
| `k8s.container.ephemeralstorage_limit` | Gauge (int) | `By` | - | - |
| `k8s.container.ephemeralstorage_request` | Gauge (int) | `By` | - | - |
| `k8s.container.memory_limit` | Gauge (int) | `By` | - | - |
| `k8s.container.memory_request` | Gauge (int) | `By` | - | - |
| `k8s.container.ready` | Gauge (int) | `""` | - | - |
| `k8s.container.restarts` | Gauge (int) | `{restart}` | - | - |
| `k8s.container.status.reason` | Sum (non-monotonic, cumulative; int) | `{container}` | `k8s.container.status.reason` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.container.status.state` | Sum (non-monotonic, cumulative; int) | `{container}` | `k8s.container.status.state` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.container.storage_limit` | Gauge (int) | `By` | - | - |
| `k8s.container.storage_request` | Gauge (int) | `By` | - | - |
| `k8s.cronjob.active_jobs` | Gauge (int) | `{job}` | - | - |
| `k8s.daemonset.current_scheduled_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.daemonset.desired_scheduled_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.daemonset.misscheduled_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.daemonset.ready_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.deployment.available` | Gauge (int) | `{pod}` | - | - |
| `k8s.deployment.desired` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.current_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.desired_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.max_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.min_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.active_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.desired_successful_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.failed_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.max_parallel_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.successful_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.namespace.phase` | Gauge (int) | `""` | - | - |
| `k8s.node.condition` | Gauge (int) | `{condition}` | `condition` | Disabled by default; controlled by `node_conditions_to_report` (Ready is enabled by default in the generated per-condition configuration). |
| `k8s.persistentvolume.status.phase` | Sum (non-monotonic, cumulative; int) | `{persistentvolume}` | `k8s.persistentvolume.status.phase` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolume.storage.capacity` | Sum (non-monotonic, cumulative; int) | `By` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolumeclaim.status.phase` | Sum (non-monotonic, cumulative; int) | `{persistentvolumeclaim}` | `k8s.persistentvolumeclaim.status.phase` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolumeclaim.storage.capacity` | Sum (non-monotonic, cumulative; int) | `By` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolumeclaim.storage.request` | Sum (non-monotonic, cumulative; int) | `By` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.pod.phase` | Gauge (int) | `""` | - | - |
| `k8s.pod.status_reason` | Gauge (int) | `""` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.replicaset.available` | Gauge (int) | `{pod}` | - | - |
| `k8s.replicaset.desired` | Gauge (int) | `{pod}` | - | - |
| `k8s.replication_controller.available` | Gauge (int) | `{pod}` | - | - |
| `k8s.replication_controller.desired` | Gauge (int) | `{pod}` | - | - |
| `k8s.resource_quota.hard_limit` | Gauge (int) | `{resource}` | `resource` | Emitted only for resources specified in the quota. |
| `k8s.resource_quota.used` | Gauge (int) | `{resource}` | `resource` | Emitted only for resources specified in the quota. |
| `k8s.service.endpoint.count` | Gauge (int) | `{endpoint}` | `k8s.service.endpoint.address_type`, `k8s.service.endpoint.condition`, `k8s.service.endpoint.zone` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.service.load_balancer.ingress.count` | Gauge (int) | `{ingress}` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.statefulset.current_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.statefulset.desired_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.statefulset.ready_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.statefulset.updated_pods` | Gauge (int) | `{pod}` | - | - |
| `openshift.appliedclusterquota.limit` | Gauge (int) | `{resource}` | `k8s.namespace.name`, `resource` | Emitted for OpenShift distribution. |
| `openshift.appliedclusterquota.used` | Gauge (int) | `{resource}` | `k8s.namespace.name`, `resource` | Emitted for OpenShift distribution. |
| `openshift.clusterquota.limit` | Gauge (int) | `{resource}` | `resource` | Emitted for OpenShift distribution. |
| `openshift.clusterquota.used` | Gauge (int) | `{resource}` | `resource` | Emitted for OpenShift distribution. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `entity_state` | `otel.entity.id`, `otel.entity.type`, `otel.entity.attributes`, optional `otel.entity.interval`, `otel.entity.event_as_log` scope marker | Emitted when a watched Kubernetes/OpenShift resource is added or its metadata is reported; requires a logs consumer. |
| `entity_delete` | `otel.entity.id`, `otel.entity.type`, `otel.entity.event.type`, `otel.entity.event_as_log` scope marker | Emitted when a watched resource is deleted; requires a logs consumer. |

## Sources

- `receiver/k8sclusterreceiver/metadata.yaml`
- `receiver/k8sclusterreceiver/receiver.go`
- `receiver/k8sclusterreceiver/watcher.go`
- `receiver/k8sclusterreceiver/internal/metadata/generated_metrics.go`
- `receiver/k8sclusterreceiver/internal/metadata/metadata.go`
- `receiver/k8sclusterreceiver/internal/metadata/entities.go`
- `receiver/k8sclusterreceiver/testdata/e2e/entities-test/expected-ns.yaml`
- `receiver/k8sclusterreceiver/testdata/e2e/entities-test/expected-pvc.yaml`
        • v0.155.0.md 6.4 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/k8sclusterreceiver
version: v0.155.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/k8sclusterreceiver
commit_sha: aaf5045a24c0a6f000225c97ad5449e69aeb5835
last_verified: 2026-08-11
---

# Kubernetes Cluster Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `k8s.container.cpu_limit` | Gauge (double) | `{cpu}` | - | - |
| `k8s.container.cpu_request` | Gauge (double) | `{cpu}` | - | - |
| `k8s.container.ephemeralstorage_limit` | Gauge (int) | `By` | - | - |
| `k8s.container.ephemeralstorage_request` | Gauge (int) | `By` | - | - |
| `k8s.container.memory_limit` | Gauge (int) | `By` | - | - |
| `k8s.container.memory_request` | Gauge (int) | `By` | - | - |
| `k8s.container.ready` | Gauge (int) | `""` | - | - |
| `k8s.container.restarts` | Gauge (int) | `{restart}` | - | - |
| `k8s.container.status.reason` | Sum (non-monotonic, cumulative; int) | `{container}` | `k8s.container.status.reason` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.container.status.state` | Sum (non-monotonic, cumulative; int) | `{container}` | `k8s.container.status.state` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.container.storage_limit` | Gauge (int) | `By` | - | - |
| `k8s.container.storage_request` | Gauge (int) | `By` | - | - |
| `k8s.cronjob.active_jobs` | Gauge (int) | `{job}` | - | - |
| `k8s.daemonset.current_scheduled_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.daemonset.desired_scheduled_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.daemonset.misscheduled_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.daemonset.ready_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.deployment.available` | Gauge (int) | `{pod}` | - | - |
| `k8s.deployment.desired` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.current_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.desired_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.max_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.min_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.active_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.desired_successful_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.failed_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.max_parallel_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.successful_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.namespace.phase` | Gauge (int) | `""` | - | - |
| `k8s.node.condition` | Gauge (int) | `{condition}` | `condition` | Disabled by default; controlled by `node_conditions_to_report` (Ready is enabled by default in the generated per-condition configuration). |
| `k8s.persistentvolume.status.phase` | Sum (non-monotonic, cumulative; int) | `{persistentvolume}` | `k8s.persistentvolume.status.phase` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolume.storage.capacity` | Sum (non-monotonic, cumulative; int) | `By` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolumeclaim.status.phase` | Sum (non-monotonic, cumulative; int) | `{persistentvolumeclaim}` | `k8s.persistentvolumeclaim.status.phase` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolumeclaim.storage.capacity` | Sum (non-monotonic, cumulative; int) | `By` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolumeclaim.storage.request` | Sum (non-monotonic, cumulative; int) | `By` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.pod.phase` | Gauge (int) | `""` | - | - |
| `k8s.pod.status_reason` | Gauge (int) | `""` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.replicaset.available` | Gauge (int) | `{pod}` | - | - |
| `k8s.replicaset.desired` | Gauge (int) | `{pod}` | - | - |
| `k8s.replication_controller.available` | Gauge (int) | `{pod}` | - | - |
| `k8s.replication_controller.desired` | Gauge (int) | `{pod}` | - | - |
| `k8s.resource_quota.hard_limit` | Gauge (int) | `{resource}` | `resource` | Emitted only for resources specified in the quota. |
| `k8s.resource_quota.used` | Gauge (int) | `{resource}` | `resource` | Emitted only for resources specified in the quota. |
| `k8s.service.endpoint.count` | Gauge (int) | `{endpoint}` | `k8s.service.endpoint.address_type`, `k8s.service.endpoint.condition`, `k8s.service.endpoint.zone` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.service.load_balancer.ingress.count` | Gauge (int) | `{ingress}` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.statefulset.current_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.statefulset.desired_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.statefulset.ready_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.statefulset.updated_pods` | Gauge (int) | `{pod}` | - | - |
| `openshift.appliedclusterquota.limit` | Gauge (int) | `{resource}` | `k8s.namespace.name`, `resource` | Emitted for OpenShift distribution. |
| `openshift.appliedclusterquota.used` | Gauge (int) | `{resource}` | `k8s.namespace.name`, `resource` | Emitted for OpenShift distribution. |
| `openshift.clusterquota.limit` | Gauge (int) | `{resource}` | `resource` | Emitted for OpenShift distribution. |
| `openshift.clusterquota.used` | Gauge (int) | `{resource}` | `resource` | Emitted for OpenShift distribution. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `entity_state` | `otel.entity.id`, `otel.entity.type`, `otel.entity.attributes`, optional `otel.entity.interval`, `otel.entity.event_as_log` scope marker | Emitted when a watched Kubernetes/OpenShift resource is added or its metadata is reported; requires a logs consumer. |
| `entity_delete` | `otel.entity.id`, `otel.entity.type`, `otel.entity.event.type`, `otel.entity.event_as_log` scope marker | Emitted when a watched resource is deleted; requires a logs consumer. |

## Sources

- `receiver/k8sclusterreceiver/metadata.yaml`
- `receiver/k8sclusterreceiver/receiver.go`
- `receiver/k8sclusterreceiver/watcher.go`
- `receiver/k8sclusterreceiver/internal/metadata/generated_metrics.go`
- `receiver/k8sclusterreceiver/internal/metadata/metadata.go`
- `receiver/k8sclusterreceiver/internal/metadata/entities.go`
- `receiver/k8sclusterreceiver/testdata/e2e/entities-test/expected-ns.yaml`
- `receiver/k8sclusterreceiver/testdata/e2e/entities-test/expected-pvc.yaml`
        • v0.156.0.md 6.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/k8sclusterreceiver
version: v0.156.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/k8sclusterreceiver
commit_sha: 41e24cd516dd69a5b4277465cdb2ff4ef0676f49
last_verified: 2026-09-09
---

# Kubernetes Cluster Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `k8s.container.cpu_limit` | Gauge (double) | `{cpu}` | - | - |
| `k8s.container.cpu_request` | Gauge (double) | `{cpu}` | - | - |
| `k8s.container.ephemeralstorage_limit` | Gauge (int) | `By` | - | - |
| `k8s.container.ephemeralstorage_request` | Gauge (int) | `By` | - | - |
| `k8s.container.memory_limit` | Gauge (int) | `By` | - | - |
| `k8s.container.memory_request` | Gauge (int) | `By` | - | - |
| `k8s.container.ready` | Gauge (int) | `""` | - | - |
| `k8s.container.restarts` | Gauge (int) | `{restart}` | - | - |
| `k8s.container.status.reason` | Sum (non-monotonic, cumulative; int) | `{container}` | `k8s.container.status.reason` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.container.status.state` | Sum (non-monotonic, cumulative; int) | `{container}` | `k8s.container.status.state` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.container.storage_limit` | Gauge (int) | `By` | - | - |
| `k8s.container.storage_request` | Gauge (int) | `By` | - | - |
| `k8s.cronjob.active_jobs` | Gauge (int) | `{job}` | - | - |
| `k8s.daemonset.current_scheduled_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.daemonset.desired_scheduled_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.daemonset.misscheduled_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.daemonset.ready_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.deployment.available` | Gauge (int) | `{pod}` | - | - |
| `k8s.deployment.desired` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.current_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.desired_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.max_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.min_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.active_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.desired_successful_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.failed_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.max_parallel_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.successful_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.namespace.phase` | Gauge (int) | `""` | - | - |
| `k8s.node.allocatable_<type>` | Gauge (double for `cpu`, int otherwise) | varies: `{cpu}`, `By`, `{pod}`, `{<resource>}` | - | Metric name, value, and unit are built per listed type; emitted only for types in `allocatable_types_to_report` (empty by default). |
| `k8s.node.condition` | Gauge (int) | `{condition}` | `condition` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.node.condition_<type>` | Gauge (int) | `""` | - | One metric per condition type (e.g. `k8s.node.condition_ready`); emitted only for types in `node_conditions_to_report` (defaults to `Ready`). |
| `k8s.persistentvolume.status.phase` | Sum (non-monotonic, cumulative; int) | `{persistentvolume}` | `k8s.persistentvolume.status.phase` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolume.storage.capacity` | Sum (non-monotonic, cumulative; int) | `By` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolumeclaim.status.phase` | Sum (non-monotonic, cumulative; int) | `{persistentvolumeclaim}` | `k8s.persistentvolumeclaim.status.phase` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolumeclaim.storage.capacity` | Sum (non-monotonic, cumulative; int) | `By` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolumeclaim.storage.request` | Sum (non-monotonic, cumulative; int) | `By` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.pod.phase` | Gauge (int) | `""` | - | - |
| `k8s.pod.status_reason` | Gauge (int) | `""` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.replicaset.available` | Gauge (int) | `{pod}` | - | - |
| `k8s.replicaset.desired` | Gauge (int) | `{pod}` | - | - |
| `k8s.replication_controller.available` | Gauge (int) | `{pod}` | - | - |
| `k8s.replication_controller.desired` | Gauge (int) | `{pod}` | - | - |
| `k8s.resource_quota.hard_limit` | Gauge (int) | `{resource}` | `resource` | Emitted only for resources specified in the quota. |
| `k8s.resource_quota.used` | Gauge (int) | `{resource}` | `resource` | Emitted only for resources specified in the quota. |
| `k8s.service.endpoint.count` | Gauge (int) | `{endpoint}` | `k8s.service.endpoint.address_type`, `k8s.service.endpoint.condition`, `k8s.service.endpoint.zone` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.service.load_balancer.ingress.count` | Gauge (int) | `{ingress}` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.statefulset.current_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.statefulset.desired_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.statefulset.ready_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.statefulset.updated_pods` | Gauge (int) | `{pod}` | - | - |
| `openshift.appliedclusterquota.limit` | Gauge (int) | `{resource}` | `k8s.namespace.name`, `resource` | Emitted for OpenShift distribution. |
| `openshift.appliedclusterquota.used` | Gauge (int) | `{resource}` | `k8s.namespace.name`, `resource` | Emitted for OpenShift distribution. |
| `openshift.clusterquota.limit` | Gauge (int) | `{resource}` | `resource` | Emitted for OpenShift distribution. |
| `openshift.clusterquota.used` | Gauge (int) | `{resource}` | `resource` | Emitted for OpenShift distribution. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `entity_state` | `otel.entity.id`, `otel.entity.type`, `otel.entity.attributes`, optional `otel.entity.interval`, `otel.entity.event.type`; `otel.entity.event_as_log` scope marker | Emitted when a watched Kubernetes/OpenShift resource is added or its metadata is reported; requires a logs consumer. |
| `entity_delete` | `otel.entity.id`, `otel.entity.type`, `otel.entity.event.type`; `otel.entity.event_as_log` scope marker | Emitted when a watched resource is deleted; requires a logs consumer. |

## Sources

- `receiver/k8sclusterreceiver/metadata.yaml`
- `receiver/k8sclusterreceiver/receiver.go`
- `receiver/k8sclusterreceiver/watcher.go`
- `receiver/k8sclusterreceiver/internal/metadata/generated_metrics.go`
- `receiver/k8sclusterreceiver/internal/metadata/metadata.go`
- `receiver/k8sclusterreceiver/internal/metadata/entities.go`
- `receiver/k8sclusterreceiver/internal/node/nodes.go`
- `receiver/k8sclusterreceiver/internal/statefulset/statefulsets.go`
- `receiver/k8sclusterreceiver/testdata/e2e/entities-test/expected-ns.yaml`
- `pkg/experimentalmetricmetadata/entity_events.go`
        • v0.157.0.md 6.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/k8sclusterreceiver
version: v0.157.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/k8sclusterreceiver
commit_sha: 89e43555904cd97c2d36605347c5d5237b1bdc8c
last_verified: 2026-08-06
---

# Kubernetes Cluster Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `k8s.container.cpu_limit` | Gauge (double) | `{cpu}` | - | - |
| `k8s.container.cpu_request` | Gauge (double) | `{cpu}` | - | - |
| `k8s.container.ephemeralstorage_limit` | Gauge (int) | `By` | - | - |
| `k8s.container.ephemeralstorage_request` | Gauge (int) | `By` | - | - |
| `k8s.container.memory_limit` | Gauge (int) | `By` | - | - |
| `k8s.container.memory_request` | Gauge (int) | `By` | - | - |
| `k8s.container.ready` | Gauge (int) | `""` | - | - |
| `k8s.container.restarts` | Gauge (int) | `{restart}` | - | - |
| `k8s.container.status.reason` | Sum (non-monotonic, cumulative; int) | `{container}` | `k8s.container.status.reason` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.container.status.state` | Sum (non-monotonic, cumulative; int) | `{container}` | `k8s.container.status.state` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.container.storage_limit` | Gauge (int) | `By` | - | - |
| `k8s.container.storage_request` | Gauge (int) | `By` | - | - |
| `k8s.cronjob.active_jobs` | Gauge (int) | `{job}` | - | - |
| `k8s.daemonset.current_scheduled_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.daemonset.desired_scheduled_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.daemonset.misscheduled_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.daemonset.ready_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.deployment.available` | Gauge (int) | `{pod}` | - | - |
| `k8s.deployment.desired` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.current_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.desired_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.max_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.min_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.active_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.desired_successful_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.failed_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.max_parallel_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.successful_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.namespace.phase` | Gauge (int) | `""` | - | - |
| `k8s.node.condition` | Gauge (int) | `{condition}` | `condition` | Disabled by default; controlled by `node_conditions_to_report` (Ready is enabled by default in the generated per-condition configuration). |
| `k8s.persistentvolume.status.phase` | Sum (non-monotonic, cumulative; int) | `{persistentvolume}` | `k8s.persistentvolume.status.phase` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolume.storage.capacity` | Sum (non-monotonic, cumulative; int) | `By` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolumeclaim.status.phase` | Sum (non-monotonic, cumulative; int) | `{persistentvolumeclaim}` | `k8s.persistentvolumeclaim.status.phase` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolumeclaim.storage.capacity` | Sum (non-monotonic, cumulative; int) | `By` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolumeclaim.storage.request` | Sum (non-monotonic, cumulative; int) | `By` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.pod.phase` | Gauge (int) | `""` | - | - |
| `k8s.pod.status_reason` | Gauge (int) | `""` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.replicaset.available` | Gauge (int) | `{pod}` | - | - |
| `k8s.replicaset.desired` | Gauge (int) | `{pod}` | - | - |
| `k8s.replication_controller.available` | Gauge (int) | `{pod}` | - | - |
| `k8s.replication_controller.desired` | Gauge (int) | `{pod}` | - | - |
| `k8s.resource_quota.hard_limit` | Gauge (int) | `{resource}` | `resource` | Emitted only for resources specified in the quota. |
| `k8s.resource_quota.used` | Gauge (int) | `{resource}` | `resource` | Emitted only for resources specified in the quota. |
| `k8s.service.endpoint.count` | Gauge (int) | `{endpoint}` | `k8s.service.endpoint.address_type`, `k8s.service.endpoint.condition`, `k8s.service.endpoint.zone` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.service.load_balancer.ingress.count` | Gauge (int) | `{ingress}` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.statefulset.current_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.statefulset.desired_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.statefulset.ready_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.statefulset.updated_pods` | Gauge (int) | `{pod}` | - | - |
| `openshift.appliedclusterquota.limit` | Gauge (int) | `{resource}` | `k8s.namespace.name`, `resource` | Emitted for OpenShift distribution. |
| `openshift.appliedclusterquota.used` | Gauge (int) | `{resource}` | `k8s.namespace.name`, `resource` | Emitted for OpenShift distribution. |
| `openshift.clusterquota.limit` | Gauge (int) | `{resource}` | `resource` | Emitted for OpenShift distribution. |
| `openshift.clusterquota.used` | Gauge (int) | `{resource}` | `resource` | Emitted for OpenShift distribution. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `entity_state` / `entity.state` | Entity ID (resource UID), entity type, entity metadata/description attributes; legacy form uses `otel.entity.id`, `otel.entity.type`, `otel.entity.attributes`, and optional `otel.entity.interval`, while specification form uses `entity.id`, `entity.type`, `entity.description`, and optional `entity.report.interval` | Emitted when a watched Kubernetes/OpenShift resource is added or its metadata is reported; requires a logs consumer. The specification form is gated by `pkg.experimentalmetricmetadata.useEntityEventsSpecification`. |
| `entity_delete` / `entity.delete` | Entity ID (resource UID), entity type; legacy form uses `otel.entity.id`, `otel.entity.type`, and `otel.entity.event.type`, while specification form uses `entity.id` and `entity.type` | Emitted when a watched resource is deleted; requires a logs consumer. The specification form is gated by `pkg.experimentalmetricmetadata.useEntityEventsSpecification`. |

## Sources

- `receiver/k8sclusterreceiver/metadata.yaml`
- `receiver/k8sclusterreceiver/receiver.go`
- `receiver/k8sclusterreceiver/watcher.go`
- `receiver/k8sclusterreceiver/internal/metadata/generated_metrics.go`
- `receiver/k8sclusterreceiver/internal/metadata/metadata.go`
- `receiver/k8sclusterreceiver/internal/metadata/entities.go`
- `receiver/k8sclusterreceiver/testdata/e2e/entities-test/expected-ns.yaml`
- `receiver/k8sclusterreceiver/testdata/e2e/entities-test/expected-ns-entity-events-spec.yaml`
        • v0.158.0.md 6.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/k8sclusterreceiver
version: v0.158.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/k8sclusterreceiver
commit_sha: 821a9d9c2c1623c4a0ceba5d47b57c48879c3f84
last_verified: 2026-08-06
---

# Kubernetes Cluster Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `k8s.container.cpu_limit` | Gauge (double) | `{cpu}` | - | - |
| `k8s.container.cpu_request` | Gauge (double) | `{cpu}` | - | - |
| `k8s.container.ephemeralstorage_limit` | Gauge (int) | `By` | - | - |
| `k8s.container.ephemeralstorage_request` | Gauge (int) | `By` | - | - |
| `k8s.container.memory_limit` | Gauge (int) | `By` | - | - |
| `k8s.container.memory_request` | Gauge (int) | `By` | - | - |
| `k8s.container.ready` | Gauge (int) | `""` | - | - |
| `k8s.container.restarts` | Gauge (int) | `{restart}` | - | - |
| `k8s.container.status.reason` | Sum (non-monotonic, cumulative; int) | `{container}` | `k8s.container.status.reason` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.container.status.state` | Sum (non-monotonic, cumulative; int) | `{container}` | `k8s.container.status.state` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.container.storage_limit` | Gauge (int) | `By` | - | - |
| `k8s.container.storage_request` | Gauge (int) | `By` | - | - |
| `k8s.cronjob.active_jobs` | Gauge (int) | `{job}` | - | - |
| `k8s.daemonset.current_scheduled_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.daemonset.desired_scheduled_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.daemonset.misscheduled_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.daemonset.ready_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.deployment.available` | Gauge (int) | `{pod}` | - | - |
| `k8s.deployment.desired` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.current_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.desired_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.max_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.min_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.active_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.desired_successful_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.failed_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.max_parallel_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.successful_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.namespace.phase` | Gauge (int) | `""` | - | - |
| `k8s.node.condition` | Gauge (int) | `{condition}` | `condition` | Disabled by default; controlled by `node_conditions_to_report` (Ready is enabled by default in the generated per-condition configuration). |
| `k8s.persistentvolume.status.phase` | Sum (non-monotonic, cumulative; int) | `{persistentvolume}` | `k8s.persistentvolume.status.phase` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolume.storage.capacity` | Sum (non-monotonic, cumulative; int) | `By` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolumeclaim.status.phase` | Sum (non-monotonic, cumulative; int) | `{persistentvolumeclaim}` | `k8s.persistentvolumeclaim.status.phase` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolumeclaim.storage.capacity` | Sum (non-monotonic, cumulative; int) | `By` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolumeclaim.storage.request` | Sum (non-monotonic, cumulative; int) | `By` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.pod.phase` | Gauge (int) | `""` | - | - |
| `k8s.pod.status_reason` | Gauge (int) | `""` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.replicaset.available` | Gauge (int) | `{pod}` | - | - |
| `k8s.replicaset.desired` | Gauge (int) | `{pod}` | - | - |
| `k8s.replication_controller.available` | Gauge (int) | `{pod}` | - | - |
| `k8s.replication_controller.desired` | Gauge (int) | `{pod}` | - | - |
| `k8s.resource_quota.hard_limit` | Gauge (int) | `{resource}` | `resource` | Emitted only for resources specified in the quota. |
| `k8s.resource_quota.used` | Gauge (int) | `{resource}` | `resource` | Emitted only for resources specified in the quota. |
| `k8s.service.endpoint.count` | Gauge (int) | `{endpoint}` | `k8s.service.endpoint.address_type`, `k8s.service.endpoint.condition`, `k8s.service.endpoint.zone` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.service.load_balancer.ingress.count` | Gauge (int) | `{ingress}` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.statefulset.current_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.statefulset.desired_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.statefulset.ready_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.statefulset.updated_pods` | Gauge (int) | `{pod}` | - | - |
| `openshift.appliedclusterquota.limit` | Gauge (int) | `{resource}` | `k8s.namespace.name`, `resource` | Emitted for OpenShift distribution. |
| `openshift.appliedclusterquota.used` | Gauge (int) | `{resource}` | `k8s.namespace.name`, `resource` | Emitted for OpenShift distribution. |
| `openshift.clusterquota.limit` | Gauge (int) | `{resource}` | `resource` | Emitted for OpenShift distribution. |
| `openshift.clusterquota.used` | Gauge (int) | `{resource}` | `resource` | Emitted for OpenShift distribution. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `entity_state` / `entity.state` | Entity ID (resource UID), entity type, entity metadata/description attributes; legacy form uses `otel.entity.id`, `otel.entity.type`, `otel.entity.attributes`, and optional `otel.entity.interval`, while specification form uses `entity.id`, `entity.type`, `entity.description`, and optional `entity.report.interval` | Emitted when a watched Kubernetes/OpenShift resource is added or its metadata is reported; requires a logs consumer. The specification form is gated by `pkg.experimentalmetricmetadata.useEntityEventsSpecification`. |
| `entity_delete` / `entity.delete` | Entity ID (resource UID), entity type; legacy form uses `otel.entity.id`, `otel.entity.type`, and `otel.entity.event.type`, while specification form uses `entity.id` and `entity.type` | Emitted when a watched resource is deleted; requires a logs consumer. The specification form is gated by `pkg.experimentalmetricmetadata.useEntityEventsSpecification`. |

## Sources

- `receiver/k8sclusterreceiver/metadata.yaml`
- `receiver/k8sclusterreceiver/receiver.go`
- `receiver/k8sclusterreceiver/watcher.go`
- `receiver/k8sclusterreceiver/internal/metadata/generated_metrics.go`
- `receiver/k8sclusterreceiver/internal/metadata/metadata.go`
- `receiver/k8sclusterreceiver/internal/metadata/entities.go`
- `receiver/k8sclusterreceiver/testdata/e2e/entities-test/expected-ns.yaml`
- `receiver/k8sclusterreceiver/testdata/e2e/entities-test/expected-ns-entity-events-spec.yaml`
        • v0.160.0.md 6.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/k8sclusterreceiver
version: v0.160.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/k8sclusterreceiver
commit_sha: 982f20b8a8e8a2569fab3e27cf8b008e8a5080c1
last_verified: 2026-09-03
---

# Kubernetes Cluster Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `k8s.container.cpu_limit` | Gauge (double) | `{cpu}` | - | - |
| `k8s.container.cpu_request` | Gauge (double) | `{cpu}` | - | - |
| `k8s.container.ephemeralstorage_limit` | Gauge (int) | `By` | - | - |
| `k8s.container.ephemeralstorage_request` | Gauge (int) | `By` | - | - |
| `k8s.container.memory_limit` | Gauge (int) | `By` | - | - |
| `k8s.container.memory_request` | Gauge (int) | `By` | - | - |
| `k8s.container.ready` | Gauge (int) | `""` | - | - |
| `k8s.container.restarts` | Gauge (int) | `{restart}` | - | - |
| `k8s.container.status.reason` | Sum (non-monotonic, cumulative; int) | `{container}` | `k8s.container.status.reason` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.container.status.state` | Sum (non-monotonic, cumulative; int) | `{container}` | `k8s.container.status.state` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.container.storage_limit` | Gauge (int) | `By` | - | - |
| `k8s.container.storage_request` | Gauge (int) | `By` | - | - |
| `k8s.cronjob.active_jobs` | Gauge (int) | `{job}` | - | - |
| `k8s.daemonset.current_scheduled_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.daemonset.desired_scheduled_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.daemonset.misscheduled_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.daemonset.ready_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.deployment.available` | Gauge (int) | `{pod}` | - | - |
| `k8s.deployment.desired` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.current_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.desired_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.max_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.min_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.active_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.desired_successful_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.failed_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.max_parallel_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.successful_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.namespace.phase` | Gauge (int) | `""` | - | - |
| `k8s.node.condition` | Gauge (int) | `{condition}` | `condition` | Disabled by default; controlled by `node_conditions_to_report` (Ready is enabled by default in the generated per-condition configuration). |
| `k8s.persistentvolume.status.phase` | Sum (non-monotonic, cumulative; int) | `{persistentvolume}` | `k8s.persistentvolume.status.phase` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolume.storage.capacity` | Sum (non-monotonic, cumulative; int) | `By` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolumeclaim.status.phase` | Sum (non-monotonic, cumulative; int) | `{persistentvolumeclaim}` | `k8s.persistentvolumeclaim.status.phase` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolumeclaim.storage.capacity` | Sum (non-monotonic, cumulative; int) | `By` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolumeclaim.storage.request` | Sum (non-monotonic, cumulative; int) | `By` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.pod.phase` | Gauge (int) | `""` | - | - |
| `k8s.pod.status_reason` | Gauge (int) | `""` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.replicaset.available` | Gauge (int) | `{pod}` | - | - |
| `k8s.replicaset.desired` | Gauge (int) | `{pod}` | - | - |
| `k8s.replication_controller.available` | Gauge (int) | `{pod}` | - | - |
| `k8s.replication_controller.desired` | Gauge (int) | `{pod}` | - | - |
| `k8s.resource_quota.hard_limit` | Gauge (int) | `{resource}` | `resource` | Emitted only for resources specified in the quota. |
| `k8s.resource_quota.used` | Gauge (int) | `{resource}` | `resource` | Emitted only for resources specified in the quota. |
| `k8s.service.endpoint.count` | Gauge (int) | `{endpoint}` | `k8s.service.endpoint.address_type`, `k8s.service.endpoint.condition`, `k8s.service.endpoint.zone` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.service.load_balancer.ingress.count` | Gauge (int) | `{ingress}` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.statefulset.current_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.statefulset.desired_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.statefulset.ready_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.statefulset.updated_pods` | Gauge (int) | `{pod}` | - | - |
| `openshift.appliedclusterquota.limit` | Gauge (int) | `{resource}` | `k8s.namespace.name`, `resource` | Emitted for OpenShift distribution. |
| `openshift.appliedclusterquota.used` | Gauge (int) | `{resource}` | `k8s.namespace.name`, `resource` | Emitted for OpenShift distribution. |
| `openshift.clusterquota.limit` | Gauge (int) | `{resource}` | `resource` | Emitted for OpenShift distribution. |
| `openshift.clusterquota.used` | Gauge (int) | `{resource}` | `resource` | Emitted for OpenShift distribution. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `entity_state` / `entity.state` | Entity ID (resource UID), entity type, entity metadata/description attributes; legacy form uses `otel.entity.id`, `otel.entity.type`, `otel.entity.attributes`, and optional `otel.entity.interval`, while specification form uses `entity.id`, `entity.type`, `entity.description`, and optional `entity.report.interval` | Emitted when a watched Kubernetes/OpenShift resource is added or its metadata is reported; requires a logs consumer. The specification form is gated by `pkg.experimentalmetricmetadata.useEntityEventsSpecification`. |
| `entity_delete` / `entity.delete` | Entity ID (resource UID), entity type; legacy form uses `otel.entity.id`, `otel.entity.type`, and `otel.entity.event.type`, while specification form uses `entity.id` and `entity.type` | Emitted when a watched resource is deleted; requires a logs consumer. The specification form is gated by `pkg.experimentalmetricmetadata.useEntityEventsSpecification`. |

## Sources

- `receiver/k8sclusterreceiver/metadata.yaml`
- `receiver/k8sclusterreceiver/receiver.go`
- `receiver/k8sclusterreceiver/watcher.go`
- `receiver/k8sclusterreceiver/internal/metadata/generated_metrics.go`
- `receiver/k8sclusterreceiver/internal/metadata/metadata.go`
- `receiver/k8sclusterreceiver/internal/metadata/entities.go`
- `receiver/k8sclusterreceiver/testdata/e2e/entities-test/expected-ns.yaml`
- `receiver/k8sclusterreceiver/testdata/e2e/entities-test/expected-ns-entity-events-spec.yaml`
        • v0.161.0.md 7.1 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/k8sclusterreceiver
version: v0.161.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/k8sclusterreceiver
commit_sha: 3f8455d8038a985398861171e5310bc9b4e988b2
last_verified: 2026-10-03
---

# Kubernetes Cluster Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `k8s.container.cpu_limit` | Gauge (double) | `{cpu}` | - | - |
| `k8s.container.cpu_request` | Gauge (double) | `{cpu}` | - | - |
| `k8s.container.ephemeralstorage_limit` | Gauge (int) | `By` | - | - |
| `k8s.container.ephemeralstorage_request` | Gauge (int) | `By` | - | - |
| `k8s.container.memory_limit` | Gauge (int) | `By` | - | - |
| `k8s.container.memory_request` | Gauge (int) | `By` | - | - |
| `k8s.container.ready` | Gauge (int) | `""` | - | - |
| `k8s.container.restarts` | Gauge (int) | `{restart}` | - | - |
| `k8s.container.status.reason` | Sum (non-monotonic, cumulative; int) | `{container}` | `k8s.container.status.reason` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.container.status.state` | Sum (non-monotonic, cumulative; int) | `{container}` | `k8s.container.status.state` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.container.storage_limit` | Gauge (int) | `By` | - | - |
| `k8s.container.storage_request` | Gauge (int) | `By` | - | - |
| `k8s.cronjob.active_jobs` | Gauge (int) | `{job}` | - | - |
| `k8s.daemonset.current_scheduled_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.daemonset.desired_scheduled_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.daemonset.misscheduled_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.daemonset.ready_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.deployment.available` | Gauge (int) | `{pod}` | - | - |
| `k8s.deployment.desired` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.current_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.desired_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.max_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.min_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.active_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.desired_successful_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.failed_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.max_parallel_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.successful_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.namespace.phase` | Gauge (int) | `""` | - | - |
| `k8s.node.condition` | Gauge (int) | `{condition}` | `condition` | Disabled by default; controlled by `node_conditions_to_report` (Ready is enabled by default in the generated per-condition configuration). |
| `k8s.persistentvolume.status.phase` | Sum (non-monotonic, cumulative; int) | `{persistentvolume}` | `k8s.persistentvolume.status.phase` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolume.storage.capacity` | Sum (non-monotonic, cumulative; int) | `By` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolumeclaim.status.phase` | Sum (non-monotonic, cumulative; int) | `{persistentvolumeclaim}` | `k8s.persistentvolumeclaim.status.phase` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolumeclaim.storage.capacity` | Sum (non-monotonic, cumulative; int) | `By` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolumeclaim.storage.request` | Sum (non-monotonic, cumulative; int) | `By` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.pod.phase` | Gauge (int) | `""` | - | - |
| `k8s.pod.status_reason` | Gauge (int) | `""` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.replicaset.available` | Gauge (int) | `{pod}` | - | - |
| `k8s.replicaset.desired` | Gauge (int) | `{pod}` | - | - |
| `k8s.replication_controller.available` | Gauge (int) | `{pod}` | - | - |
| `k8s.replication_controller.desired` | Gauge (int) | `{pod}` | - | - |
| `k8s.resource_quota.hard_limit` | Gauge (int) | `{resource}` | `resource` | Emitted only for resources specified in the quota. |
| `k8s.resource_quota.used` | Gauge (int) | `{resource}` | `resource` | Emitted only for resources specified in the quota. |
| `k8s.service.endpoint.count` | Gauge (int) | `{endpoint}` | `k8s.service.endpoint.address_type`, `k8s.service.endpoint.condition`, `k8s.service.endpoint.zone` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.service.load_balancer.ingress.count` | Gauge (int) | `{ingress}` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.statefulset.current_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.statefulset.desired_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.statefulset.pod.available` | Sum (non-monotonic, cumulative; int) | `{pod}` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.statefulset.ready_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.statefulset.updated_pods` | Gauge (int) | `{pod}` | - | - |
| `openshift.appliedclusterquota.limit` | Gauge (int) | `{resource}` | `k8s.namespace.name`, `resource` | Emitted for OpenShift distribution. |
| `openshift.appliedclusterquota.used` | Gauge (int) | `{resource}` | `k8s.namespace.name`, `resource` | Emitted for OpenShift distribution. |
| `openshift.clusterquota.limit` | Gauge (int) | `{resource}` | `resource` | Emitted for OpenShift distribution. |
| `openshift.clusterquota.used` | Gauge (int) | `{resource}` | `resource` | Emitted for OpenShift distribution. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `entity_state` / `entity.state` | Entity ID (resource UID), entity type, entity metadata/description attributes; legacy form uses `otel.entity.id`, `otel.entity.type`, `otel.entity.attributes`, and optional `otel.entity.interval`, while specification form uses `entity.id`, `entity.type`, `entity.description`, and optional `entity.report.interval` | Emitted when a watched Kubernetes/OpenShift resource is added or its metadata is reported; requires a logs consumer. The specification form is gated by `pkg.experimentalmetricmetadata.useEntityEventsSpecification`. |
| `entity_delete` / `entity.delete` | Entity ID (resource UID), entity type; legacy form uses `otel.entity.id`, `otel.entity.type`, and `otel.entity.event.type`, while specification form uses `entity.id` and `entity.type` | Emitted when a watched resource is deleted; requires a logs consumer. The specification form is gated by `pkg.experimentalmetricmetadata.useEntityEventsSpecification`. |

## Sources

- `receiver/k8sclusterreceiver/metadata.yaml`
- `receiver/k8sclusterreceiver/receiver.go`
- `receiver/k8sclusterreceiver/watcher.go`
- `receiver/k8sclusterreceiver/internal/metadata/generated_metrics.go`
- `receiver/k8sclusterreceiver/internal/metadata/metadata.go`
- `receiver/k8sclusterreceiver/internal/metadata/entities.go`
- `receiver/k8sclusterreceiver/internal/statefulset/statefulsets.go`
- `receiver/k8sclusterreceiver/testdata/e2e/entities-test/expected-ns.yaml`
- `receiver/k8sclusterreceiver/testdata/e2e/entities-test/expected-ns-entity-events-spec.yaml`
        • v0.162.0.md 7.1 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/k8sclusterreceiver
version: v0.162.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/k8sclusterreceiver
commit_sha: ae8c507510f48f433ab47dd1c6b01a59d6c388b5
last_verified: 2026-10-03
---

# Kubernetes Cluster Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `k8s.container.cpu_limit` | Gauge (double) | `{cpu}` | - | - |
| `k8s.container.cpu_request` | Gauge (double) | `{cpu}` | - | - |
| `k8s.container.ephemeralstorage_limit` | Gauge (int) | `By` | - | - |
| `k8s.container.ephemeralstorage_request` | Gauge (int) | `By` | - | - |
| `k8s.container.memory_limit` | Gauge (int) | `By` | - | - |
| `k8s.container.memory_request` | Gauge (int) | `By` | - | - |
| `k8s.container.ready` | Gauge (int) | `""` | - | - |
| `k8s.container.restarts` | Gauge (int) | `{restart}` | - | - |
| `k8s.container.status.reason` | Sum (non-monotonic, cumulative; int) | `{container}` | `k8s.container.status.reason` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.container.status.state` | Sum (non-monotonic, cumulative; int) | `{container}` | `k8s.container.status.state` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.container.storage_limit` | Gauge (int) | `By` | - | - |
| `k8s.container.storage_request` | Gauge (int) | `By` | - | - |
| `k8s.cronjob.active_jobs` | Gauge (int) | `{job}` | - | - |
| `k8s.daemonset.current_scheduled_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.daemonset.desired_scheduled_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.daemonset.misscheduled_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.daemonset.ready_nodes` | Gauge (int) | `{node}` | - | - |
| `k8s.deployment.available` | Gauge (int) | `{pod}` | - | - |
| `k8s.deployment.desired` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.current_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.desired_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.max_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.hpa.min_replicas` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.active_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.desired_successful_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.failed_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.max_parallel_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.job.successful_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.namespace.phase` | Gauge (int) | `""` | - | - |
| `k8s.node.condition` | Gauge (int) | `{condition}` | `condition` | Disabled by default; controlled by `node_conditions_to_report` (Ready is enabled by default in the generated per-condition configuration). |
| `k8s.persistentvolume.status.phase` | Sum (non-monotonic, cumulative; int) | `{persistentvolume}` | `k8s.persistentvolume.status.phase` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolume.storage.capacity` | Sum (non-monotonic, cumulative; int) | `By` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolumeclaim.status.phase` | Sum (non-monotonic, cumulative; int) | `{persistentvolumeclaim}` | `k8s.persistentvolumeclaim.status.phase` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolumeclaim.storage.capacity` | Sum (non-monotonic, cumulative; int) | `By` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.persistentvolumeclaim.storage.request` | Sum (non-monotonic, cumulative; int) | `By` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.pod.phase` | Gauge (int) | `""` | - | - |
| `k8s.pod.status_reason` | Gauge (int) | `""` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.replicaset.available` | Gauge (int) | `{pod}` | - | - |
| `k8s.replicaset.desired` | Gauge (int) | `{pod}` | - | - |
| `k8s.replication_controller.available` | Gauge (int) | `{pod}` | - | - |
| `k8s.replication_controller.desired` | Gauge (int) | `{pod}` | - | - |
| `k8s.resource_quota.hard_limit` | Gauge (int) | `{resource}` | `resource` | Emitted only for resources specified in the quota. |
| `k8s.resource_quota.used` | Gauge (int) | `{resource}` | `resource` | Emitted only for resources specified in the quota. |
| `k8s.service.endpoint.count` | Gauge (int) | `{endpoint}` | `k8s.service.endpoint.address_type`, `k8s.service.endpoint.condition`, `k8s.service.endpoint.zone` | Disabled by default; enable in the metrics builder configuration. |
| `k8s.service.load_balancer.ingress.count` | Gauge (int) | `{ingress}` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.statefulset.current_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.statefulset.desired_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.statefulset.pod.available` | Sum (non-monotonic, cumulative; int) | `{pod}` | - | Disabled by default; enable in the metrics builder configuration. |
| `k8s.statefulset.ready_pods` | Gauge (int) | `{pod}` | - | - |
| `k8s.statefulset.updated_pods` | Gauge (int) | `{pod}` | - | - |
| `openshift.appliedclusterquota.limit` | Gauge (int) | `{resource}` | `k8s.namespace.name`, `resource` | Emitted for OpenShift distribution. |
| `openshift.appliedclusterquota.used` | Gauge (int) | `{resource}` | `k8s.namespace.name`, `resource` | Emitted for OpenShift distribution. |
| `openshift.clusterquota.limit` | Gauge (int) | `{resource}` | `resource` | Emitted for OpenShift distribution. |
| `openshift.clusterquota.used` | Gauge (int) | `{resource}` | `resource` | Emitted for OpenShift distribution. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `entity_state` / `entity.state` | Entity ID (resource UID), entity type, entity metadata/description attributes; legacy form uses `otel.entity.id`, `otel.entity.type`, `otel.entity.attributes`, and optional `otel.entity.interval`, while specification form uses `entity.id`, `entity.type`, `entity.description`, and optional `entity.report.interval` | Emitted when a watched Kubernetes/OpenShift resource is added or its metadata is reported; requires a logs consumer. The specification form is gated by `pkg.experimentalmetricmetadata.useEntityEventsSpecification`. |
| `entity_delete` / `entity.delete` | Entity ID (resource UID), entity type; legacy form uses `otel.entity.id`, `otel.entity.type`, and `otel.entity.event.type`, while specification form uses `entity.id` and `entity.type` | Emitted when a watched resource is deleted; requires a logs consumer. The specification form is gated by `pkg.experimentalmetricmetadata.useEntityEventsSpecification`. |

## Sources

- `receiver/k8sclusterreceiver/metadata.yaml`
- `receiver/k8sclusterreceiver/receiver.go`
- `receiver/k8sclusterreceiver/watcher.go`
- `receiver/k8sclusterreceiver/internal/metadata/generated_metrics.go`
- `receiver/k8sclusterreceiver/internal/metadata/metadata.go`
- `receiver/k8sclusterreceiver/internal/metadata/entities.go`
- `receiver/k8sclusterreceiver/internal/statefulset/statefulsets.go`
- `receiver/k8sclusterreceiver/testdata/e2e/entities-test/expected-ns.yaml`
- `receiver/k8sclusterreceiver/testdata/e2e/entities-test/expected-ns-entity-events-spec.yaml`
        • v0.163.0.md 5.3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/k8sclusterreceiver
version: v0.163.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/k8sclusterreceiver
commit_sha: df849b5403c041d5e799e7846392a6f18b0b55ae
last_verified: null
---

# Kubernetes Cluster Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `k8s.container.cpu_limit` | gauge | `{cpu}` | entity attributes | - |
| `k8s.container.cpu_request` | gauge | `{cpu}` | entity attributes | - |
| `k8s.container.ephemeralstorage_limit` | gauge | `By` | entity attributes | - |
| `k8s.container.ephemeralstorage_request` | gauge | `By` | entity attributes | - |
| `k8s.container.memory_limit` | gauge | `By` | entity attributes | - |
| `k8s.container.memory_request` | gauge | `By` | entity attributes | - |
| `k8s.container.ready` | gauge | `` | entity attributes | - |
| `k8s.container.restarts` | gauge | `{restart}` | entity attributes | - |
| `k8s.container.status.reason` | sum | `{container}` | k8s.container.status.reason | disabled by default |
| `k8s.container.status.state` | sum | `{container}` | k8s.container.status.state | disabled by default |
| `k8s.container.storage_limit` | gauge | `By` | entity attributes | - |
| `k8s.container.storage_request` | gauge | `By` | entity attributes | - |
| `k8s.cronjob.active_jobs` | gauge | `{job}` | entity attributes | - |
| `k8s.daemonset.current_scheduled_nodes` | gauge | `{node}` | entity attributes | - |
| `k8s.daemonset.desired_scheduled_nodes` | gauge | `{node}` | entity attributes | - |
| `k8s.daemonset.misscheduled_nodes` | gauge | `{node}` | entity attributes | - |
| `k8s.daemonset.ready_nodes` | gauge | `{node}` | entity attributes | - |
| `k8s.deployment.available` | gauge | `{pod}` | entity attributes | - |
| `k8s.deployment.desired` | gauge | `{pod}` | entity attributes | - |
| `k8s.hpa.current_replicas` | gauge | `{pod}` | entity attributes | - |
| `k8s.hpa.desired_replicas` | gauge | `{pod}` | entity attributes | - |
| `k8s.hpa.max_replicas` | gauge | `{pod}` | entity attributes | - |
| `k8s.hpa.min_replicas` | gauge | `{pod}` | entity attributes | - |
| `k8s.job.active_pods` | gauge | `{pod}` | entity attributes | - |
| `k8s.job.desired_successful_pods` | gauge | `{pod}` | entity attributes | - |
| `k8s.job.failed_pods` | gauge | `{pod}` | entity attributes | - |
| `k8s.job.max_parallel_pods` | gauge | `{pod}` | entity attributes | - |
| `k8s.job.successful_pods` | gauge | `{pod}` | entity attributes | - |
| `k8s.namespace.phase` | gauge | `` | entity attributes | - |
| `k8s.node.condition` | gauge | `{condition}` | condition | disabled by default |
| `k8s.persistentvolume.status.phase` | sum | `{persistentvolume}` | k8s.persistentvolume.status.phase | disabled by default |
| `k8s.persistentvolume.storage.capacity` | sum | `By` | entity attributes | disabled by default |
| `k8s.persistentvolumeclaim.status.phase` | sum | `{persistentvolumeclaim}` | k8s.persistentvolumeclaim.status.phase | disabled by default |
| `k8s.persistentvolumeclaim.storage.capacity` | sum | `By` | entity attributes | disabled by default |
| `k8s.persistentvolumeclaim.storage.request` | sum | `By` | entity attributes | disabled by default |
| `k8s.pod.phase` | gauge | `` | entity attributes | - |
| `k8s.pod.status_reason` | gauge | `` | entity attributes | disabled by default |
| `k8s.replicaset.available` | gauge | `{pod}` | entity attributes | - |
| `k8s.replicaset.desired` | gauge | `{pod}` | entity attributes | - |
| `k8s.replication_controller.available` | gauge | `{pod}` | entity attributes | - |
| `k8s.replication_controller.desired` | gauge | `{pod}` | entity attributes | - |
| `k8s.resource_quota.hard_limit` | gauge | `{resource}` | resource | - |
| `k8s.resource_quota.used` | gauge | `{resource}` | resource | - |
| `k8s.service.endpoint.count` | gauge | `{endpoint}` | k8s.service.endpoint.address_type, k8s.service.endpoint.condition, k8s.service.endpoint.zone | disabled by default |
| `k8s.service.load_balancer.ingress.count` | gauge | `{ingress}` | entity attributes | disabled by default |
| `k8s.statefulset.current_pods` | gauge | `{pod}` | entity attributes | - |
| `k8s.statefulset.desired_pods` | gauge | `{pod}` | entity attributes | - |
| `k8s.statefulset.pod.available` | sum | `{pod}` | entity attributes | disabled by default |
| `k8s.statefulset.ready_pods` | gauge | `{pod}` | entity attributes | - |
| `k8s.statefulset.updated_pods` | gauge | `{pod}` | entity attributes | - |
| `openshift.appliedclusterquota.limit` | gauge | `{resource}` | k8s.namespace.name, resource | - |
| `openshift.appliedclusterquota.used` | gauge | `{resource}` | k8s.namespace.name, resource | - |
| `openshift.clusterquota.limit` | gauge | `{resource}` | resource | - |
| `openshift.clusterquota.used` | gauge | `{resource}` | resource | - |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| Kubernetes entity events | Entity resource attributes and metadata delta (added, updated, removed properties) | Development stability; emitted when entity events are enabled in receiver configuration |

## Sources

- `receiver/k8sclusterreceiver/metadata.yaml`
- `receiver/k8sclusterreceiver/internal/metadata/generated_metrics.go`
- `receiver/k8sclusterreceiver/internal/metadata/generated_logs.go`
- `receiver/k8sclusterreceiver/internal/metadata/entities.go`
      • k8seventsreceiver
        • v0.153.0.md 1.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/k8seventsreceiver
version: v0.153.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/k8seventsreceiver
commit_sha: 42f949127580c0d00088b785cd0b35842dc0ddb8
last_verified: 2026-08-11
---

# Kubernetes Events Receiver

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `k8s.event` | `k8s.event.reason`, `k8s.event.action`, `k8s.event.start_time`, `k8s.event.name`, `k8s.event.uid`, `k8s.namespace.name`, `k8s.event.reporting_controller`, `k8s.event.reporting_instance`, `k8s.event.count` (when nonzero); resource attributes `k8s.node.name`, `k8s.object.kind`, `k8s.object.name`, `k8s.object.uid`, `k8s.object.fieldpath`, `k8s.object.api_version`, `k8s.object.resource_version` | `k8s.event.count` is omitted when the Kubernetes event count is zero. Severity is mapped from the event type when it is `Normal`, `Warning`, `Error`, or `Critical`. |

## Sources

- `receiver/k8seventsreceiver/k8s_event_to_logdata.go`
- `receiver/k8seventsreceiver/receiver.go`
- `receiver/k8seventsreceiver/metadata.yaml`
- `receiver/k8seventsreceiver/internal/metadata/generated_logs.go`
        • v0.154.0.md 1.5 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/k8seventsreceiver
version: v0.154.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/k8seventsreceiver
commit_sha: 853eda0e12b3ba142552ecd2b63cec07062904f0
last_verified: 2026-08-11
---

# Kubernetes Events Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_k8s_events_modified_filtered` | Counter | `{events}` | - | Always 0 when `dedup_interval` is not set; increments for MODIFIED watch events filtered by `dedup_interval`. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `k8s.event` | `k8s.event.reason`, `k8s.event.action`, `k8s.event.start_time`, `k8s.event.name`, `k8s.event.uid`, `k8s.namespace.name`, `k8s.event.reporting_controller`, `k8s.event.reporting_instance`, `k8s.event.count` (when nonzero); resource attributes `k8s.node.name`, `k8s.object.kind`, `k8s.object.name`, `k8s.object.uid`, `k8s.object.fieldpath`, `k8s.object.api_version`, `k8s.object.resource_version` | `k8s.event.count` is omitted when the Kubernetes event count is zero. Severity is mapped from the event type when it is `Normal`, `Warning`, `Error`, or `Critical`. |

## Sources

- `receiver/k8seventsreceiver/k8s_event_to_logdata.go`
- `receiver/k8seventsreceiver/receiver.go`
- `receiver/k8seventsreceiver/metadata.yaml`
- `receiver/k8seventsreceiver/internal/metadata/generated_telemetry.go`
- `receiver/k8seventsreceiver/internal/metadata/generated_logs.go`
        • v0.155.0.md 1.5 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/k8seventsreceiver
version: v0.155.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/k8seventsreceiver
commit_sha: aaf5045a24c0a6f000225c97ad5449e69aeb5835
last_verified: 2026-08-11
---

# Kubernetes Events Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_k8s_events_modified_filtered` | Counter | `{events}` | - | Always 0 when `dedup_interval` is not set; increments for MODIFIED watch events filtered by `dedup_interval`. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `k8s.event` | `k8s.event.reason`, `k8s.event.action`, `k8s.event.start_time`, `k8s.event.name`, `k8s.event.uid`, `k8s.namespace.name`, `k8s.event.reporting_controller`, `k8s.event.reporting_instance`, `k8s.event.count` (when nonzero); resource attributes `k8s.node.name`, `k8s.object.kind`, `k8s.object.name`, `k8s.object.uid`, `k8s.object.fieldpath`, `k8s.object.api_version`, `k8s.object.resource_version` | `k8s.event.count` is omitted when the Kubernetes event count is zero. Severity is mapped from the event type when it is `Normal`, `Warning`, `Error`, or `Critical`. |

## Sources

- `receiver/k8seventsreceiver/k8s_event_to_logdata.go`
- `receiver/k8seventsreceiver/receiver.go`
- `receiver/k8seventsreceiver/metadata.yaml`
- `receiver/k8seventsreceiver/internal/metadata/generated_telemetry.go`
- `receiver/k8seventsreceiver/internal/metadata/generated_logs.go`
        • v0.156.0.md 1.5 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/k8seventsreceiver
version: v0.156.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/k8seventsreceiver
commit_sha: 41e24cd516dd69a5b4277465cdb2ff4ef0676f49
last_verified: 2026-08-11
---

# Kubernetes Events Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_k8s_events_modified_filtered` | Counter | `{events}` | - | Always 0 when `dedup_interval` is not set; increments for MODIFIED watch events filtered by `dedup_interval`. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `k8s.event` | `k8s.event.reason`, `k8s.event.action`, `k8s.event.start_time`, `k8s.event.name`, `k8s.event.uid`, `k8s.namespace.name`, `k8s.event.reporting_controller`, `k8s.event.reporting_instance`, `k8s.event.count` (when nonzero); resource attributes `k8s.node.name`, `k8s.object.kind`, `k8s.object.name`, `k8s.object.uid`, `k8s.object.fieldpath`, `k8s.object.api_version`, `k8s.object.resource_version` | `k8s.event.count` is omitted when the Kubernetes event count is zero. Severity is mapped from the event type when it is `Normal`, `Warning`, `Error`, or `Critical`. |

## Sources

- `receiver/k8seventsreceiver/k8s_event_to_logdata.go`
- `receiver/k8seventsreceiver/receiver.go`
- `receiver/k8seventsreceiver/metadata.yaml`
- `receiver/k8seventsreceiver/internal/metadata/generated_telemetry.go`
- `receiver/k8seventsreceiver/internal/metadata/generated_logs.go`
        • v0.157.0.md 1.5 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/k8seventsreceiver
version: v0.157.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/k8seventsreceiver
commit_sha: 89e43555904cd97c2d36605347c5d5237b1bdc8c
last_verified: 2026-08-11
---

# Kubernetes Events Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_k8s_events_modified_filtered` | Counter | `{events}` | - | Always 0 when `dedup_interval` is not set; increments for MODIFIED watch events filtered by `dedup_interval`. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `k8s.event` | `k8s.event.reason`, `k8s.event.action`, `k8s.event.start_time`, `k8s.event.name`, `k8s.event.uid`, `k8s.namespace.name`, `k8s.event.reporting_controller`, `k8s.event.reporting_instance`, `k8s.event.count` (when nonzero); resource attributes `k8s.node.name`, `k8s.object.kind`, `k8s.object.name`, `k8s.object.uid`, `k8s.object.fieldpath`, `k8s.object.api_version`, `k8s.object.resource_version` | `k8s.event.count` is omitted when the Kubernetes event count is zero. Severity is mapped from the event type when it is `Normal`, `Warning`, `Error`, or `Critical`. |

## Sources

- `receiver/k8seventsreceiver/k8s_event_to_logdata.go`
- `receiver/k8seventsreceiver/receiver.go`
- `receiver/k8seventsreceiver/metadata.yaml`
- `receiver/k8seventsreceiver/internal/metadata/generated_telemetry.go`
- `receiver/k8seventsreceiver/internal/metadata/generated_logs.go`
        • v0.158.0.md 1.5 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/k8seventsreceiver
version: v0.158.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/k8seventsreceiver
commit_sha: 821a9d9c2c1623c4a0ceba5d47b57c48879c3f84
last_verified: 2026-08-11
---

# Kubernetes Events Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_k8s_events_modified_filtered` | Counter | `{events}` | - | Always 0 when `dedup_interval` is not set; increments for MODIFIED watch events filtered by `dedup_interval`. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `k8s.event` | `k8s.event.reason`, `k8s.event.action`, `k8s.event.start_time`, `k8s.event.name`, `k8s.event.uid`, `k8s.namespace.name`, `k8s.event.reporting_controller`, `k8s.event.reporting_instance`, `k8s.event.count` (when nonzero); resource attributes `k8s.node.name`, `k8s.object.kind`, `k8s.object.name`, `k8s.object.uid`, `k8s.object.fieldpath`, `k8s.object.api_version`, `k8s.object.resource_version` | `k8s.event.count` is omitted when the Kubernetes event count is zero. Severity is mapped from the event type when it is `Normal`, `Warning`, `Error`, or `Critical`. |

## Sources

- `receiver/k8seventsreceiver/k8s_event_to_logdata.go`
- `receiver/k8seventsreceiver/receiver.go`
- `receiver/k8seventsreceiver/metadata.yaml`
- `receiver/k8seventsreceiver/internal/metadata/generated_telemetry.go`
- `receiver/k8seventsreceiver/internal/metadata/generated_logs.go`
        • v0.159.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/k8seventsreceiver
version: v0.159.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/k8seventsreceiver
commit_sha: 1120cc0714bf4d14600105e5673c3b00fe87467a
last_verified: 2026-08-24
---

# Kubernetes Events Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_k8s_events_modified_filtered` | Counter | `{events}` | - | Counts MODIFIED watch events filtered by `dedup_interval`; always 0 when `dedup_interval` is not set. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `k8s.event` | `k8s.event.reason`, `k8s.event.action`, `k8s.event.start_time`, `k8s.event.name`, `k8s.event.uid`, `k8s.namespace.name`, `k8s.event.reporting_controller`, `k8s.event.reporting_instance`, `k8s.event.count` (when nonzero); resource attributes `k8s.node.name`, `k8s.object.kind`, `k8s.object.name`, `k8s.object.uid`, `k8s.object.fieldpath`, `k8s.object.api_version`, `k8s.object.resource_version` | Emits accepted ADDED events and MODIFIED events allowed by `dedup_interval`; DELETED events and events older than receiver startup are excluded. `k8s.event.count` is omitted when zero. Severity is mapped from event type `Normal`, `Warning`, `Error`, or `Critical`. |

## Sources

- `receiver/k8seventsreceiver/k8s_event_to_logdata.go`
- `receiver/k8seventsreceiver/receiver.go`
- `receiver/k8seventsreceiver/metadata.yaml`
- `receiver/k8seventsreceiver/documentation.md`
- `receiver/k8seventsreceiver/internal/metadata/generated_telemetry.go`
- `receiver/k8seventsreceiver/internal/metadata/generated_status.go`
        • v0.160.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/k8seventsreceiver
version: v0.160.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/k8seventsreceiver
commit_sha: 982f20b8a8e8a2569fab3e27cf8b008e8a5080c1
last_verified: 2026-09-03
---

# Kubernetes Events Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_k8s_events_modified_filtered` | Counter | `{events}` | - | Counts MODIFIED watch events filtered by `dedup_interval`; always 0 when `dedup_interval` is not set. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `k8s.event` | `k8s.event.reason`, `k8s.event.action`, `k8s.event.start_time`, `k8s.event.name`, `k8s.event.uid`, `k8s.namespace.name`, `k8s.event.reporting_controller`, `k8s.event.reporting_instance`, `k8s.event.count` (when nonzero); resource attributes `k8s.node.name`, `k8s.object.kind`, `k8s.object.name`, `k8s.object.uid`, `k8s.object.fieldpath`, `k8s.object.api_version`, `k8s.object.resource_version` | Emits accepted ADDED events and MODIFIED events allowed by `dedup_interval`; DELETED events and events older than receiver startup are excluded. `k8s.event.count` is omitted when zero. Severity is mapped from event type `Normal`, `Warning`, `Error`, or `Critical`. |

## Sources

- `receiver/k8seventsreceiver/k8s_event_to_logdata.go`
- `receiver/k8seventsreceiver/receiver.go`
- `receiver/k8seventsreceiver/metadata.yaml`
- `receiver/k8seventsreceiver/documentation.md`
- `receiver/k8seventsreceiver/internal/metadata/generated_telemetry.go`
- `receiver/k8seventsreceiver/internal/metadata/generated_status.go`
        • v0.161.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/k8seventsreceiver
version: v0.161.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/k8seventsreceiver
commit_sha: 3f8455d8038a985398861171e5310bc9b4e988b2
last_verified: 2026-10-03
---

# Kubernetes Events Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_k8s_events_modified_filtered` | Counter | `{events}` | - | Counts MODIFIED watch events filtered by `dedup_interval`; always 0 when `dedup_interval` is not set. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `k8s.event` | `k8s.event.reason`, `k8s.event.action`, `k8s.event.start_time`, `k8s.event.name`, `k8s.event.uid`, `k8s.namespace.name`, `k8s.event.reporting_controller`, `k8s.event.reporting_instance`, `k8s.event.count` (when nonzero); resource attributes `k8s.node.name`, `k8s.object.kind`, `k8s.object.name`, `k8s.object.uid`, `k8s.object.fieldpath`, `k8s.object.api_version`, `k8s.object.resource_version` | Emits accepted ADDED events and MODIFIED events allowed by `dedup_interval`; DELETED events and events older than receiver startup are excluded. `k8s.event.count` is omitted when zero. Severity is mapped from event type `Normal`, `Warning`, `Error`, or `Critical`. |

## Sources

- `receiver/k8seventsreceiver/k8s_event_to_logdata.go`
- `receiver/k8seventsreceiver/receiver.go`
- `receiver/k8seventsreceiver/metadata.yaml`
- `receiver/k8seventsreceiver/documentation.md`
- `receiver/k8seventsreceiver/internal/metadata/generated_telemetry.go`
- `receiver/k8seventsreceiver/internal/metadata/generated_status.go`
        • v0.162.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/k8seventsreceiver
version: v0.162.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/k8seventsreceiver
commit_sha: ae8c507510f48f433ab47dd1c6b01a59d6c388b5
last_verified: 2026-10-03
---

# Kubernetes Events Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_k8s_events_modified_filtered` | Counter | `{event}` | - | Counts MODIFIED watch events filtered by `dedup_interval`; always 0 when `dedup_interval` is not set. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `k8s.event` | `k8s.event.reason`, `k8s.event.action`, `k8s.event.start_time`, `k8s.event.name`, `k8s.event.uid`, `k8s.namespace.name`, `k8s.event.reporting_controller`, `k8s.event.reporting_instance`, `k8s.event.count` (when nonzero); resource attributes `k8s.node.name`, `k8s.object.kind`, `k8s.object.name`, `k8s.object.uid`, `k8s.object.fieldpath`, `k8s.object.api_version`, `k8s.object.resource_version` | Emits accepted ADDED events and MODIFIED events allowed by `dedup_interval`; DELETED events and events older than receiver startup are excluded. `k8s.event.count` is omitted when zero. Severity is mapped from event type `Normal`, `Warning`, `Error`, or `Critical`. |

## Sources

- `receiver/k8seventsreceiver/k8s_event_to_logdata.go`
- `receiver/k8seventsreceiver/receiver.go`
- `receiver/k8seventsreceiver/metadata.yaml`
- `receiver/k8seventsreceiver/documentation.md`
- `receiver/k8seventsreceiver/internal/metadata/generated_telemetry.go`
- `receiver/k8seventsreceiver/internal/metadata/generated_status.go`
      • kafkareceiver
        • v0.153.0.md 3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/kafkareceiver
version: v0.153.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/kafkareceiver
commit_sha: 42f949127580c0d00088b785cd0b35842dc0ddb8
last_verified: 2026-08-11
---

# Kafka Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_kafka_broker_closed` | Counter | `1` | `node_id` | Only produced by the franz-go consumer. |
| `otelcol_kafka_broker_connects` | Counter | `1` | `node_id`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_broker_throttling_duration` | Histogram | `ms` | `node_id` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_broker_throttling_latency` | Histogram | `s` | `node_id` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_bytes` | Counter | `By` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_bytes_uncompressed` | Counter | `By` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_current_offset` | Gauge | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_latency` | Histogram | `ms` | `node_id`, `topic`, `partition`, `outcome` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_messages` | Counter | `1` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_offset_lag` | Gauge | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_partition_close` | Counter | `1` | - | - |
| `otelcol_kafka_receiver_partition_start` | Counter | `1` | - | - |
| `otelcol_kafka_receiver_read_latency` | Histogram | `s` | `node_id`, `topic`, `partition`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_records` | Counter | `1` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_records_delay` | Histogram | `s` | `topic`, `partition` | Only produced by the franz-go consumer when `telemetry.metrics.kafka_receiver_records_delay.enabled` is true. |
| `otelcol_kafka_receiver_unmarshal_failed_log_records` | Counter | `1` | `topic`, `partition` | On log-record unmarshaling failures. |
| `otelcol_kafka_receiver_unmarshal_failed_metric_points` | Counter | `1` | `topic`, `partition` | On metric-point unmarshaling failures. |
| `otelcol_kafka_receiver_unmarshal_failed_profiles` | Counter | `1` | `topic`, `partition` | On profile unmarshaling failures. |
| `otelcol_kafka_receiver_unmarshal_failed_spans` | Counter | `1` | `topic`, `partition` | On span unmarshaling failures. |

## Sources

- `receiver/kafkareceiver/metadata.yaml`
- `receiver/kafkareceiver/kafka_receiver.go`
- `receiver/kafkareceiver/consumer_franz.go`
- `receiver/kafkareceiver/internal/metadata/generated_telemetry.go`
        • v0.154.0.md 3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/kafkareceiver
version: v0.154.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/kafkareceiver
commit_sha: 853eda0e12b3ba142552ecd2b63cec07062904f0
last_verified: 2026-08-11
---

# Kafka Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_kafka_broker_closed` | Counter | `1` | `node_id` | Only produced by the franz-go consumer. |
| `otelcol_kafka_broker_connects` | Counter | `1` | `node_id`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_broker_throttling_duration` | Histogram | `ms` | `node_id` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_broker_throttling_latency` | Histogram | `s` | `node_id` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_bytes` | Counter | `By` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_bytes_uncompressed` | Counter | `By` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_current_offset` | Gauge | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_latency` | Histogram | `ms` | `node_id`, `topic`, `partition`, `outcome` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_messages` | Counter | `1` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_offset_lag` | Gauge | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_partition_close` | Counter | `1` | - | - |
| `otelcol_kafka_receiver_partition_start` | Counter | `1` | - | - |
| `otelcol_kafka_receiver_read_latency` | Histogram | `s` | `node_id`, `topic`, `partition`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_records` | Counter | `1` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_records_delay` | Histogram | `s` | `topic`, `partition` | Only produced by the franz-go consumer when `telemetry.metrics.kafka_receiver_records_delay.enabled` is true. |
| `otelcol_kafka_receiver_unmarshal_failed_log_records` | Counter | `1` | `topic`, `partition` | On log-record unmarshaling failures. |
| `otelcol_kafka_receiver_unmarshal_failed_metric_points` | Counter | `1` | `topic`, `partition` | On metric-point unmarshaling failures. |
| `otelcol_kafka_receiver_unmarshal_failed_profiles` | Counter | `1` | `topic`, `partition` | On profile unmarshaling failures. |
| `otelcol_kafka_receiver_unmarshal_failed_spans` | Counter | `1` | `topic`, `partition` | On span unmarshaling failures. |

## Sources

- `receiver/kafkareceiver/metadata.yaml`
- `receiver/kafkareceiver/kafka_receiver.go`
- `receiver/kafkareceiver/consumer_franz.go`
- `receiver/kafkareceiver/internal/metadata/generated_telemetry.go`
        • v0.155.0.md 3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/kafkareceiver
version: v0.155.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/kafkareceiver
commit_sha: aaf5045a24c0a6f000225c97ad5449e69aeb5835
last_verified: 2026-08-11
---

# Kafka Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_kafka_broker_closed` | Counter | `1` | `node_id` | Only produced by the franz-go consumer. |
| `otelcol_kafka_broker_connects` | Counter | `1` | `node_id`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_broker_throttling_duration` | Histogram | `ms` | `node_id` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_broker_throttling_latency` | Histogram | `s` | `node_id` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_bytes` | Counter | `By` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_bytes_uncompressed` | Counter | `By` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_current_offset` | Gauge | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_latency` | Histogram | `ms` | `node_id`, `topic`, `partition`, `outcome` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_messages` | Counter | `1` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_offset_lag` | Gauge | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_partition_close` | Counter | `1` | - | - |
| `otelcol_kafka_receiver_partition_start` | Counter | `1` | - | - |
| `otelcol_kafka_receiver_read_latency` | Histogram | `s` | `node_id`, `topic`, `partition`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_records` | Counter | `1` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_records_delay` | Histogram | `s` | `topic`, `partition` | Only produced by the franz-go consumer when `telemetry.metrics.kafka_receiver_records_delay.enabled` is true. |
| `otelcol_kafka_receiver_unmarshal_failed_log_records` | Counter | `1` | `topic`, `partition` | On log-record unmarshaling failures. |
| `otelcol_kafka_receiver_unmarshal_failed_metric_points` | Counter | `1` | `topic`, `partition` | On metric-point unmarshaling failures. |
| `otelcol_kafka_receiver_unmarshal_failed_profiles` | Counter | `1` | `topic`, `partition` | On profile unmarshaling failures. |
| `otelcol_kafka_receiver_unmarshal_failed_spans` | Counter | `1` | `topic`, `partition` | On span unmarshaling failures. |

## Sources

- `receiver/kafkareceiver/metadata.yaml`
- `receiver/kafkareceiver/kafka_receiver.go`
- `receiver/kafkareceiver/consumer_franz.go`
- `receiver/kafkareceiver/internal/metadata/generated_telemetry.go`
        • v0.156.0.md 2.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/kafkareceiver
version: v0.156.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/kafkareceiver
commit_sha: 41e24cd516dd69a5b4277465cdb2ff4ef0676f49
last_verified: 2026-08-06
---

# Kafka Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_kafka_broker_closed` | Counter | `1` | `node_id` | Only produced by the franz-go consumer. |
| `otelcol_kafka_broker_connects` | Counter | `1` | `node_id`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_broker_throttling_duration` | Histogram | `ms` | `node_id` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_broker_throttling_latency` | Histogram | `s` | `node_id` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_bytes` | Counter | `By` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_bytes_uncompressed` | Counter | `By` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_current_offset` | Gauge | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_latency` | Histogram | `ms` | `node_id`, `outcome` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_messages` | Counter | `1` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_offset_lag` | Gauge | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_partition_close` | Counter | `1` | - | - |
| `otelcol_kafka_receiver_partition_start` | Counter | `1` | - | - |
| `otelcol_kafka_receiver_read_latency` | Histogram | `s` | `node_id`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_records` | Counter | `1` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_records_delay` | Histogram | `s` | `topic`, `partition` | Only produced by the franz-go consumer when `telemetry.metrics.kafka_receiver_records_delay.enabled` is true. |
| `otelcol_kafka_receiver_unmarshal_failed_log_records` | Counter | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_unmarshal_failed_metric_points` | Counter | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_unmarshal_failed_profiles` | Counter | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_unmarshal_failed_spans` | Counter | `1` | `topic`, `partition` | - |

## Sources

- `receiver/kafkareceiver/metadata.yaml`
- `receiver/kafkareceiver/consumer_franz.go`
- `receiver/kafkareceiver/kafka_receiver.go`
- `receiver/kafkareceiver/config.go`
- `receiver/kafkareceiver/internal/metadata/generated_telemetry.go`
        • v0.157.0.md 2.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/kafkareceiver
version: v0.157.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/kafkareceiver
commit_sha: 89e43555904cd97c2d36605347c5d5237b1bdc8c
last_verified: 2026-08-06
---

# Kafka Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_kafka_broker_closed` | Counter | `1` | `node_id` | Only produced by the franz-go consumer. |
| `otelcol_kafka_broker_connects` | Counter | `1` | `node_id`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_broker_throttling_duration` | Histogram | `ms` | `node_id` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_broker_throttling_latency` | Histogram | `s` | `node_id` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_bytes` | Counter | `By` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_bytes_uncompressed` | Counter | `By` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_current_offset` | Gauge | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_latency` | Histogram | `ms` | `node_id`, `outcome` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_messages` | Counter | `1` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_offset_lag` | Gauge | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_partition_close` | Counter | `1` | - | - |
| `otelcol_kafka_receiver_partition_start` | Counter | `1` | - | - |
| `otelcol_kafka_receiver_read_latency` | Histogram | `s` | `node_id`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_records` | Counter | `1` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_records_delay` | Histogram | `s` | `topic`, `partition` | Only produced by the franz-go consumer when `telemetry.metrics.kafka_receiver_records_delay.enabled` is true. |
| `otelcol_kafka_receiver_unmarshal_failed_log_records` | Counter | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_unmarshal_failed_metric_points` | Counter | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_unmarshal_failed_profiles` | Counter | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_unmarshal_failed_spans` | Counter | `1` | `topic`, `partition` | - |

## Sources

- `receiver/kafkareceiver/metadata.yaml`
- `receiver/kafkareceiver/consumer_franz.go`
- `receiver/kafkareceiver/kafka_receiver.go`
- `receiver/kafkareceiver/config.go`
- `receiver/kafkareceiver/internal/metadata/generated_telemetry.go`
        • v0.158.0.md 2.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/kafkareceiver
version: v0.158.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/kafkareceiver
commit_sha: 821a9d9c2c1623c4a0ceba5d47b57c48879c3f84
last_verified: 2026-08-06
---

# Kafka Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_kafka_broker_closed` | Counter | `1` | `node_id` | Only produced by the franz-go consumer. |
| `otelcol_kafka_broker_connects` | Counter | `1` | `node_id`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_broker_throttling_duration` | Histogram | `ms` | `node_id` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_broker_throttling_latency` | Histogram | `s` | `node_id` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_bytes` | Counter | `By` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_bytes_uncompressed` | Counter | `By` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_current_offset` | Gauge | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_latency` | Histogram | `ms` | `node_id`, `outcome` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_messages` | Counter | `1` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_offset_lag` | Gauge | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_partition_close` | Counter | `1` | - | - |
| `otelcol_kafka_receiver_partition_start` | Counter | `1` | - | - |
| `otelcol_kafka_receiver_read_latency` | Histogram | `s` | `node_id`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_records` | Counter | `1` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_records_delay` | Histogram | `s` | `topic`, `partition` | Only produced by the franz-go consumer when `telemetry.metrics.kafka_receiver_records_delay.enabled` is true. |
| `otelcol_kafka_receiver_unmarshal_failed_log_records` | Counter | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_unmarshal_failed_metric_points` | Counter | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_unmarshal_failed_profiles` | Counter | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_unmarshal_failed_spans` | Counter | `1` | `topic`, `partition` | - |

## Sources

- `receiver/kafkareceiver/metadata.yaml`
- `receiver/kafkareceiver/consumer_franz.go`
- `receiver/kafkareceiver/kafka_receiver.go`
- `receiver/kafkareceiver/config.go`
- `receiver/kafkareceiver/internal/metadata/generated_telemetry.go`
        • v0.159.0.md 2.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/kafkareceiver
version: v0.159.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/kafkareceiver
commit_sha: 1120cc0714bf4d14600105e5673c3b00fe87467a
last_verified: 2026-10-14
---

# Kafka Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_kafka_broker_closed` | Counter | `1` | `node_id` | Only produced by the franz-go consumer. |
| `otelcol_kafka_broker_connects` | Counter | `1` | `node_id`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_broker_throttling_duration` | Histogram | `ms` | `node_id` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_broker_throttling_latency` | Histogram | `s` | `node_id` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_bytes` | Counter | `By` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_bytes_uncompressed` | Counter | `By` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_current_offset` | Gauge | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_latency` | Histogram | `ms` | `node_id`, `outcome` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_messages` | Counter | `1` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_offset_lag` | Gauge | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_partition_close` | Counter | `1` | - | - |
| `otelcol_kafka_receiver_partition_start` | Counter | `1` | - | - |
| `otelcol_kafka_receiver_read_latency` | Histogram | `s` | `node_id`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_records` | Counter | `1` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_records_delay` | Histogram | `s` | `topic`, `partition` | Only produced by the franz-go consumer when `telemetry.metrics.kafka_receiver_records_delay.enabled` is true. |
| `otelcol_kafka_receiver_unmarshal_failed_log_records` | Counter | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_unmarshal_failed_metric_points` | Counter | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_unmarshal_failed_profiles` | Counter | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_unmarshal_failed_spans` | Counter | `1` | `topic`, `partition` | - |

## Sources

- `receiver/kafkareceiver/metadata.yaml`
- `receiver/kafkareceiver/consumer_franz.go`
- `receiver/kafkareceiver/kafka_receiver.go`
- `receiver/kafkareceiver/config.go`
- `receiver/kafkareceiver/internal/metadata/generated_telemetry.go`
        • v0.160.0.md 2.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/kafkareceiver
version: v0.160.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/kafkareceiver
commit_sha: 982f20b8a8e8a2569fab3e27cf8b008e8a5080c1
last_verified: 2026-09-03
---

# Kafka Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_kafka_broker_closed` | Counter | `1` | `node_id` | Only produced by the franz-go consumer. |
| `otelcol_kafka_broker_connects` | Counter | `1` | `node_id`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_broker_throttling_duration` | Histogram | `ms` | `node_id` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_broker_throttling_latency` | Histogram | `s` | `node_id` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_bytes` | Counter | `By` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_bytes_uncompressed` | Counter | `By` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_current_offset` | Gauge | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_latency` | Histogram | `ms` | `node_id`, `outcome` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_messages` | Counter | `1` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_offset_lag` | Gauge | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_partition_close` | Counter | `1` | - | - |
| `otelcol_kafka_receiver_partition_start` | Counter | `1` | - | - |
| `otelcol_kafka_receiver_read_latency` | Histogram | `s` | `node_id`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_records` | Counter | `1` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_records_delay` | Histogram | `s` | `topic`, `partition` | Only produced by the franz-go consumer when `telemetry.metrics.kafka_receiver_records_delay.enabled` is true. |
| `otelcol_kafka_receiver_unmarshal_failed_log_records` | Counter | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_unmarshal_failed_metric_points` | Counter | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_unmarshal_failed_profiles` | Counter | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_unmarshal_failed_spans` | Counter | `1` | `topic`, `partition` | - |

## Sources

- `receiver/kafkareceiver/metadata.yaml`
- `receiver/kafkareceiver/consumer_franz.go`
- `receiver/kafkareceiver/kafka_receiver.go`
- `receiver/kafkareceiver/config.go`
- `receiver/kafkareceiver/internal/metadata/generated_telemetry.go`
        • v0.161.0.md 2.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/kafkareceiver
version: v0.161.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/kafkareceiver
commit_sha: 3f8455d8038a985398861171e5310bc9b4e988b2
last_verified: 2026-10-03
---

# Kafka Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_kafka_broker_closed` | Counter | `1` | `node_id` | Only produced by the franz-go consumer. |
| `otelcol_kafka_broker_connects` | Counter | `1` | `node_id`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_broker_throttling_duration` | Histogram | `ms` | `node_id` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_broker_throttling_latency` | Histogram | `s` | `node_id` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_bytes` | Counter | `By` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_bytes_uncompressed` | Counter | `By` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_current_offset` | Gauge | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_latency` | Histogram | `ms` | `node_id`, `outcome` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_messages` | Counter | `1` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_offset_lag` | Gauge | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_partition_close` | Counter | `1` | - | - |
| `otelcol_kafka_receiver_partition_start` | Counter | `1` | - | - |
| `otelcol_kafka_receiver_read_latency` | Histogram | `s` | `node_id`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_records` | Counter | `1` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_records_delay` | Histogram | `s` | `topic`, `partition` | Only produced by the franz-go consumer when `telemetry.metrics.kafka_receiver_records_delay.enabled` is true. |
| `otelcol_kafka_receiver_unmarshal_failed_log_records` | Counter | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_unmarshal_failed_metric_points` | Counter | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_unmarshal_failed_profiles` | Counter | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_unmarshal_failed_spans` | Counter | `1` | `topic`, `partition` | - |

## Sources

- `receiver/kafkareceiver/metadata.yaml`
- `receiver/kafkareceiver/consumer_franz.go`
- `receiver/kafkareceiver/kafka_receiver.go`
- `receiver/kafkareceiver/config.go`
- `receiver/kafkareceiver/internal/metadata/generated_telemetry.go`
        • v0.162.0.md 3.4 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/kafkareceiver
version: v0.162.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/kafkareceiver
commit_sha: ae8c507510f48f433ab47dd1c6b01a59d6c388b5
last_verified: 2026-10-03
---

# Kafka Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_kafka_broker_closed` | Counter | `1` | `node_id` | Only produced by the franz-go consumer. |
| `otelcol_kafka_broker_connects` | Counter | `1` | `node_id`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_broker_throttling_duration` | Histogram | `ms` | `node_id` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_broker_throttling_latency` | Histogram | `s` | `node_id` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_bytes` | Counter | `By` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_bytes_uncompressed` | Counter | `By` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_current_offset` | Gauge | `1` | `topic`, `partition` | Asynchronous (observed each collection cycle). Reported only for currently assigned partitions after at least one processed record; stops when a partition is lost, revoked, or terminally paused, and keeps the last observed offset during temporary backpressure or rewind pauses. |
| `otelcol_kafka_receiver_latency` | Histogram | `ms` | `node_id`, `outcome` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_messages` | Counter | `1` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_offset_lag` | Gauge | `1` | `topic`, `partition` | Asynchronous (observed each collection cycle). Reported only for currently assigned partitions after at least one processed record; stops when a partition is lost, revoked, or terminally paused, and keeps the last observed lag during temporary backpressure or rewind pauses. |
| `otelcol_kafka_receiver_partition_close` | Counter | `1` | - | - |
| `otelcol_kafka_receiver_partition_start` | Counter | `1` | - | - |
| `otelcol_kafka_receiver_read_latency` | Histogram | `s` | `node_id`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_records` | Counter | `1` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_records_delay` | Histogram | `s` | `topic`, `partition` | Only produced by the franz-go consumer when `telemetry.metrics.kafka_receiver_records_delay.enabled` is true. |
| `otelcol_kafka_receiver_unmarshal_failed_log_records` | Counter | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_unmarshal_failed_metric_points` | Counter | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_unmarshal_failed_profiles` | Counter | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_unmarshal_failed_spans` | Counter | `1` | `topic`, `partition` | - |

## Sources

- `receiver/kafkareceiver/metadata.yaml`
- `receiver/kafkareceiver/consumer_franz.go`
- `receiver/kafkareceiver/kafka_receiver.go`
- `receiver/kafkareceiver/config.go`
- `receiver/kafkareceiver/internal/metadata/generated_telemetry.go`
- `receiver/kafkareceiver/partition_worker.go`
        • v0.163.0.md 2.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/kafkareceiver
version: v0.163.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/kafkareceiver
commit_sha: df849b5403c041d5e799e7846392a6f18b0b55ae
last_verified: 2026-10-14
---

# Kafka Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `otelcol_kafka_broker_closed` | Counter | `1` | `node_id` | Only produced by the franz-go consumer. |
| `otelcol_kafka_broker_connects` | Counter | `1` | `node_id`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_broker_throttling_duration` | Histogram | `ms` | `node_id` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_broker_throttling_latency` | Histogram | `s` | `node_id` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_bytes` | Counter | `By` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_bytes_uncompressed` | Counter | `By` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_current_offset` | Gauge | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_latency` | Histogram | `ms` | `node_id`, `outcome` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_messages` | Counter | `1` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Deprecated; only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_offset_lag` | Gauge | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_partition_close` | Counter | `1` | - | - |
| `otelcol_kafka_receiver_partition_start` | Counter | `1` | - | - |
| `otelcol_kafka_receiver_read_latency` | Histogram | `s` | `node_id`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_records` | Counter | `1` | `node_id`, `topic`, `partition`, `compression_codec`, `outcome` | Only produced by the franz-go consumer. |
| `otelcol_kafka_receiver_records_delay` | Histogram | `s` | `topic`, `partition` | Only produced by the franz-go consumer when `telemetry.metrics.kafka_receiver_records_delay.enabled` is true. |
| `otelcol_kafka_receiver_unmarshal_failed_log_records` | Counter | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_unmarshal_failed_metric_points` | Counter | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_unmarshal_failed_profiles` | Counter | `1` | `topic`, `partition` | - |
| `otelcol_kafka_receiver_unmarshal_failed_spans` | Counter | `1` | `topic`, `partition` | - |

## Sources

- `receiver/kafkareceiver/metadata.yaml`
- `receiver/kafkareceiver/consumer_franz.go`
- `receiver/kafkareceiver/kafka_receiver.go`
- `receiver/kafkareceiver/config.go`
- `receiver/kafkareceiver/internal/metadata/generated_telemetry.go`
      • kubeletstatsreceiver
        • v0.153.0.md 7.4 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/kubeletstatsreceiver
version: v0.153.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/kubeletstatsreceiver
commit_sha: 42f949127580c0d00088b785cd0b35842dc0ddb8
last_verified: 2026-08-11
---

# Kubelet Stats Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `container.cpu.time` | Sum | `s` | - | - |
| `container.cpu.usage` | Gauge | `{cpu}` | - | - |
| `container.filesystem.available` | Gauge | `By` | - | - |
| `container.filesystem.capacity` | Gauge | `By` | - | - |
| `container.filesystem.usage` | Gauge | `By` | - | - |
| `container.memory.available` | Gauge | `By` | - | - |
| `container.memory.major_page_faults` | Gauge | `1` | - | - |
| `container.memory.page_faults` | Gauge | `1` | - | - |
| `container.memory.rss` | Gauge | `By` | - | - |
| `container.memory.usage` | Gauge | `By` | - | - |
| `container.memory.working_set` | Gauge | `By` | - | - |
| `k8s.node.cpu.time` | Sum | `s` | - | - |
| `k8s.node.cpu.usage` | Gauge | `{cpu}` | - | - |
| `k8s.node.filesystem.available` | Gauge | `By` | - | - |
| `k8s.node.filesystem.capacity` | Gauge | `By` | - | - |
| `k8s.node.filesystem.usage` | Gauge | `By` | - | - |
| `k8s.node.memory.available` | Gauge | `By` | - | - |
| `k8s.node.memory.major_page_faults` | Gauge | `1` | - | - |
| `k8s.node.memory.page_faults` | Gauge | `1` | - | - |
| `k8s.node.memory.rss` | Gauge | `By` | - | - |
| `k8s.node.memory.usage` | Gauge | `By` | - | - |
| `k8s.node.memory.working_set` | Gauge | `By` | - | - |
| `k8s.pod.cpu.time` | Sum | `s` | - | - |
| `k8s.pod.cpu.usage` | Gauge | `{cpu}` | - | - |
| `k8s.pod.filesystem.available` | Gauge | `By` | - | - |
| `k8s.pod.filesystem.capacity` | Gauge | `By` | - | - |
| `k8s.pod.filesystem.usage` | Gauge | `By` | - | - |
| `k8s.pod.memory.available` | Gauge | `By` | - | - |
| `k8s.pod.memory.major_page_faults` | Gauge | `1` | - | - |
| `k8s.pod.memory.page_faults` | Gauge | `1` | - | - |
| `k8s.pod.memory.rss` | Gauge | `By` | - | - |
| `k8s.pod.memory.usage` | Gauge | `By` | - | - |
| `k8s.pod.memory.working_set` | Gauge | `By` | - | - |
| `k8s.node.network.errors` | Sum | `1` | interface, direction | - |
| `k8s.node.network.io` | Sum | `By` | interface, direction | - |
| `k8s.pod.network.errors` | Sum | `1` | interface, direction | - |
| `k8s.pod.network.io` | Sum | `By` | interface, direction | - |
| `k8s.volume.available` | Gauge | `By` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.capacity` | Gauge | `By` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes.free` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes.used` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `container.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.container.uptime.enabled`. |
| `k8s.container.cpu.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.cpu.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.container.cpu_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.cpu_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.container.cpu_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.cpu_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.container.ephemeral_storage.usage` | Sum | `By` | fs.type | Optional: disabled by default; enable with `metrics.k8s.container.ephemeral_storage.usage.enabled`. |
| `k8s.container.memory.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.memory.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.container.memory_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.memory_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.container.memory_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.memory_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.node.system_container.cpu.time` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.cpu.time.enabled`. |
| `k8s.node.system_container.cpu.usage` | Gauge | `{cpu}` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.cpu.usage.enabled`. |
| `k8s.node.system_container.memory.usage` | Gauge | `By` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.memory.usage.enabled`. |
| `k8s.node.system_container.memory.working_set` | Gauge | `By` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.memory.working_set.enabled`. |
| `k8s.node.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.node.uptime.enabled`. |
| `k8s.pod.cpu.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.cpu.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.pod.cpu_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.cpu_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.pod.cpu_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.cpu_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.pod.memory.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.memory.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.pod.memory_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.memory_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.pod.memory_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.memory_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.pod.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.pod.uptime.enabled`. |
| `k8s.pod.volume.usage` | Sum | `By` | - | Optional: disabled by default; enable with `metrics.k8s.pod.volume.usage.enabled`. Collected when metric group `volume` is enabled. |


## Sources

- `receiver/kubeletstatsreceiver/metadata.yaml`
- `receiver/kubeletstatsreceiver/internal/kubelet/accumulator.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/cpu.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/fs.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/network.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/volume.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/metadata.go`
- `receiver/kubeletstatsreceiver/config.go`
        • v0.154.0.md 7.4 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/kubeletstatsreceiver
version: v0.154.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/kubeletstatsreceiver
commit_sha: 853eda0e12b3ba142552ecd2b63cec07062904f0
last_verified: 2026-08-11
---

# Kubelet Stats Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `container.cpu.time` | Sum | `s` | - | - |
| `container.cpu.usage` | Gauge | `{cpu}` | - | - |
| `container.filesystem.available` | Gauge | `By` | - | - |
| `container.filesystem.capacity` | Gauge | `By` | - | - |
| `container.filesystem.usage` | Gauge | `By` | - | - |
| `container.memory.available` | Gauge | `By` | - | - |
| `container.memory.major_page_faults` | Gauge | `1` | - | - |
| `container.memory.page_faults` | Gauge | `1` | - | - |
| `container.memory.rss` | Gauge | `By` | - | - |
| `container.memory.usage` | Gauge | `By` | - | - |
| `container.memory.working_set` | Gauge | `By` | - | - |
| `k8s.node.cpu.time` | Sum | `s` | - | - |
| `k8s.node.cpu.usage` | Gauge | `{cpu}` | - | - |
| `k8s.node.filesystem.available` | Gauge | `By` | - | - |
| `k8s.node.filesystem.capacity` | Gauge | `By` | - | - |
| `k8s.node.filesystem.usage` | Gauge | `By` | - | - |
| `k8s.node.memory.available` | Gauge | `By` | - | - |
| `k8s.node.memory.major_page_faults` | Gauge | `1` | - | - |
| `k8s.node.memory.page_faults` | Gauge | `1` | - | - |
| `k8s.node.memory.rss` | Gauge | `By` | - | - |
| `k8s.node.memory.usage` | Gauge | `By` | - | - |
| `k8s.node.memory.working_set` | Gauge | `By` | - | - |
| `k8s.pod.cpu.time` | Sum | `s` | - | - |
| `k8s.pod.cpu.usage` | Gauge | `{cpu}` | - | - |
| `k8s.pod.filesystem.available` | Gauge | `By` | - | - |
| `k8s.pod.filesystem.capacity` | Gauge | `By` | - | - |
| `k8s.pod.filesystem.usage` | Gauge | `By` | - | - |
| `k8s.pod.memory.available` | Gauge | `By` | - | - |
| `k8s.pod.memory.major_page_faults` | Gauge | `1` | - | - |
| `k8s.pod.memory.page_faults` | Gauge | `1` | - | - |
| `k8s.pod.memory.rss` | Gauge | `By` | - | - |
| `k8s.pod.memory.usage` | Gauge | `By` | - | - |
| `k8s.pod.memory.working_set` | Gauge | `By` | - | - |
| `k8s.node.network.errors` | Sum | `1` | interface, direction | - |
| `k8s.node.network.io` | Sum | `By` | interface, direction | - |
| `k8s.pod.network.errors` | Sum | `1` | interface, direction | - |
| `k8s.pod.network.io` | Sum | `By` | interface, direction | - |
| `k8s.volume.available` | Gauge | `By` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.capacity` | Gauge | `By` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes.free` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes.used` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `container.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.container.uptime.enabled`. |
| `k8s.container.cpu.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.cpu.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.container.cpu_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.cpu_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.container.cpu_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.cpu_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.container.ephemeral_storage.usage` | Sum | `By` | fs.type | Optional: disabled by default; enable with `metrics.k8s.container.ephemeral_storage.usage.enabled`. |
| `k8s.container.memory.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.memory.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.container.memory_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.memory_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.container.memory_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.memory_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.node.system_container.cpu.time` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.cpu.time.enabled`. |
| `k8s.node.system_container.cpu.usage` | Gauge | `{cpu}` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.cpu.usage.enabled`. |
| `k8s.node.system_container.memory.usage` | Gauge | `By` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.memory.usage.enabled`. |
| `k8s.node.system_container.memory.working_set` | Gauge | `By` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.memory.working_set.enabled`. |
| `k8s.node.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.node.uptime.enabled`. |
| `k8s.pod.cpu.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.cpu.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.pod.cpu_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.cpu_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.pod.cpu_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.cpu_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.pod.memory.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.memory.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.pod.memory_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.memory_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.pod.memory_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.memory_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.pod.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.pod.uptime.enabled`. |
| `k8s.pod.volume.usage` | Sum | `By` | - | Optional: disabled by default; enable with `metrics.k8s.pod.volume.usage.enabled`. Collected when metric group `volume` is enabled. |


## Sources

- `receiver/kubeletstatsreceiver/metadata.yaml`
- `receiver/kubeletstatsreceiver/internal/kubelet/accumulator.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/cpu.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/fs.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/network.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/volume.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/metadata.go`
- `receiver/kubeletstatsreceiver/config.go`
        • v0.155.0.md 7.4 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/kubeletstatsreceiver
version: v0.155.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/kubeletstatsreceiver
commit_sha: aaf5045a24c0a6f000225c97ad5449e69aeb5835
last_verified: 2026-08-11
---

# Kubelet Stats Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `container.cpu.time` | Sum | `s` | - | - |
| `container.cpu.usage` | Gauge | `{cpu}` | - | - |
| `container.filesystem.available` | Gauge | `By` | - | - |
| `container.filesystem.capacity` | Gauge | `By` | - | - |
| `container.filesystem.usage` | Gauge | `By` | - | - |
| `container.memory.available` | Gauge | `By` | - | - |
| `container.memory.major_page_faults` | Gauge | `1` | - | - |
| `container.memory.page_faults` | Gauge | `1` | - | - |
| `container.memory.rss` | Gauge | `By` | - | - |
| `container.memory.usage` | Gauge | `By` | - | - |
| `container.memory.working_set` | Gauge | `By` | - | - |
| `k8s.node.cpu.time` | Sum | `s` | - | - |
| `k8s.node.cpu.usage` | Gauge | `{cpu}` | - | - |
| `k8s.node.filesystem.available` | Gauge | `By` | - | - |
| `k8s.node.filesystem.capacity` | Gauge | `By` | - | - |
| `k8s.node.filesystem.usage` | Gauge | `By` | - | - |
| `k8s.node.memory.available` | Gauge | `By` | - | - |
| `k8s.node.memory.major_page_faults` | Gauge | `1` | - | - |
| `k8s.node.memory.page_faults` | Gauge | `1` | - | - |
| `k8s.node.memory.rss` | Gauge | `By` | - | - |
| `k8s.node.memory.usage` | Gauge | `By` | - | - |
| `k8s.node.memory.working_set` | Gauge | `By` | - | - |
| `k8s.pod.cpu.time` | Sum | `s` | - | - |
| `k8s.pod.cpu.usage` | Gauge | `{cpu}` | - | - |
| `k8s.pod.filesystem.available` | Gauge | `By` | - | - |
| `k8s.pod.filesystem.capacity` | Gauge | `By` | - | - |
| `k8s.pod.filesystem.usage` | Gauge | `By` | - | - |
| `k8s.pod.memory.available` | Gauge | `By` | - | - |
| `k8s.pod.memory.major_page_faults` | Gauge | `1` | - | - |
| `k8s.pod.memory.page_faults` | Gauge | `1` | - | - |
| `k8s.pod.memory.rss` | Gauge | `By` | - | - |
| `k8s.pod.memory.usage` | Gauge | `By` | - | - |
| `k8s.pod.memory.working_set` | Gauge | `By` | - | - |
| `k8s.node.network.errors` | Sum | `1` | interface, direction | - |
| `k8s.node.network.io` | Sum | `By` | interface, direction | - |
| `k8s.pod.network.errors` | Sum | `1` | interface, direction | - |
| `k8s.pod.network.io` | Sum | `By` | interface, direction | - |
| `k8s.volume.available` | Gauge | `By` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.capacity` | Gauge | `By` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes.free` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes.used` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `container.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.container.uptime.enabled`. |
| `k8s.container.cpu.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.cpu.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.container.cpu_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.cpu_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.container.cpu_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.cpu_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.container.ephemeral_storage.usage` | Sum | `By` | fs.type | Optional: disabled by default; enable with `metrics.k8s.container.ephemeral_storage.usage.enabled`. |
| `k8s.container.memory.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.memory.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.container.memory_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.memory_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.container.memory_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.memory_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.node.system_container.cpu.time` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.cpu.time.enabled`. |
| `k8s.node.system_container.cpu.usage` | Gauge | `{cpu}` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.cpu.usage.enabled`. |
| `k8s.node.system_container.memory.usage` | Gauge | `By` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.memory.usage.enabled`. |
| `k8s.node.system_container.memory.working_set` | Gauge | `By` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.memory.working_set.enabled`. |
| `k8s.node.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.node.uptime.enabled`. |
| `k8s.pod.cpu.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.cpu.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.pod.cpu_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.cpu_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.pod.cpu_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.cpu_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.pod.memory.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.memory.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.pod.memory_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.memory_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.pod.memory_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.memory_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data. |
| `k8s.pod.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.pod.uptime.enabled`. |
| `k8s.pod.volume.usage` | Sum | `By` | - | Optional: disabled by default; enable with `metrics.k8s.pod.volume.usage.enabled`. Collected when metric group `volume` is enabled. |


## Sources

- `receiver/kubeletstatsreceiver/metadata.yaml`
- `receiver/kubeletstatsreceiver/internal/kubelet/accumulator.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/cpu.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/fs.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/network.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/volume.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/metadata.go`
- `receiver/kubeletstatsreceiver/config.go`
        • v0.156.0.md 8.7 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/kubeletstatsreceiver
version: v0.156.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/kubeletstatsreceiver
commit_sha: 41e24cd516dd69a5b4277465cdb2ff4ef0676f49
last_verified: 2026-08-06
---

# Kubelet Stats Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `container.cpu.time` | Sum | `s` | - | - |
| `container.cpu.usage` | Gauge | `{cpu}` | - | Feature gate `receiver.kubeletstats.cpuUsageScrapeBased` changes this to scrape-based calculation (from v0.156.0). |
| `container.filesystem.available` | Gauge | `By` | - | - |
| `container.filesystem.capacity` | Gauge | `By` | - | - |
| `container.filesystem.usage` | Gauge | `By` | - | - |
| `container.memory.available` | Gauge | `By` | - | - |
| `container.memory.major_page_faults` | Gauge | `1` | - | - |
| `container.memory.page_faults` | Gauge | `1` | - | - |
| `container.memory.rss` | Gauge | `By` | - | - |
| `container.memory.usage` | Gauge | `By` | - | - |
| `container.memory.working_set` | Gauge | `By` | - | - |
| `k8s.node.cpu.time` | Sum | `s` | - | - |
| `k8s.node.cpu.usage` | Gauge | `{cpu}` | - | Feature gate `receiver.kubeletstats.cpuUsageScrapeBased` changes this to scrape-based calculation (from v0.156.0). |
| `k8s.node.filesystem.available` | Gauge | `By` | - | - |
| `k8s.node.filesystem.capacity` | Gauge | `By` | - | - |
| `k8s.node.filesystem.usage` | Gauge | `By` | - | - |
| `k8s.node.memory.available` | Gauge | `By` | - | - |
| `k8s.node.memory.major_page_faults` | Gauge | `1` | - | - |
| `k8s.node.memory.page_faults` | Gauge | `1` | - | - |
| `k8s.node.memory.rss` | Gauge | `By` | - | - |
| `k8s.node.memory.usage` | Gauge | `By` | - | - |
| `k8s.node.memory.working_set` | Gauge | `By` | - | - |
| `k8s.pod.cpu.time` | Sum | `s` | - | - |
| `k8s.pod.cpu.usage` | Gauge | `{cpu}` | - | Feature gate `receiver.kubeletstats.cpuUsageScrapeBased` changes this to scrape-based calculation (from v0.156.0). |
| `k8s.pod.filesystem.available` | Gauge | `By` | - | - |
| `k8s.pod.filesystem.capacity` | Gauge | `By` | - | - |
| `k8s.pod.filesystem.usage` | Gauge | `By` | - | - |
| `k8s.pod.memory.available` | Gauge | `By` | - | - |
| `k8s.pod.memory.major_page_faults` | Gauge | `1` | - | - |
| `k8s.pod.memory.page_faults` | Gauge | `1` | - | - |
| `k8s.pod.memory.rss` | Gauge | `By` | - | - |
| `k8s.pod.memory.usage` | Gauge | `By` | - | - |
| `k8s.pod.memory.working_set` | Gauge | `By` | - | - |
| `k8s.node.network.errors` | Sum | `1` | interface, direction | - |
| `k8s.node.network.io` | Sum | `By` | interface, direction | - |
| `k8s.pod.network.errors` | Sum | `1` | interface, direction | - |
| `k8s.pod.network.io` | Sum | `By` | interface, direction | - |
| `k8s.volume.available` | Gauge | `By` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.capacity` | Gauge | `By` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes.free` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes.used` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `container.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.container.uptime.enabled`. |
| `k8s.container.cpu.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.cpu.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.cpu_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.cpu_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.cpu_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.cpu_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.ephemeral_storage.usage` | Sum | `By` | fs.type | Optional: disabled by default; enable with `metrics.k8s.container.ephemeral_storage.usage.enabled`. |
| `k8s.container.memory.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.memory.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.memory_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.memory_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.memory_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.memory_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.node.system_container.cpu.time` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.cpu.time.enabled`. |
| `k8s.node.system_container.cpu.usage` | Gauge | `{cpu}` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.cpu.usage.enabled`. |
| `k8s.node.system_container.memory.usage` | Gauge | `By` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.memory.usage.enabled`. |
| `k8s.node.system_container.memory.working_set` | Gauge | `By` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.memory.working_set.enabled`. |
| `k8s.node.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.node.uptime.enabled`. |
| `k8s.pod.cpu.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.cpu.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.cpu_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.cpu_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.cpu_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.cpu_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.memory.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.memory.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.memory_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.memory_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.memory_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.memory_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.pod.uptime.enabled`. |
| `k8s.pod.volume.usage` | Sum | `By` | - | Optional: disabled by default; enable with `metrics.k8s.pod.volume.usage.enabled`. Collected when metric group `volume` is enabled. |


## Sources

- `receiver/kubeletstatsreceiver/metadata.yaml`
- `receiver/kubeletstatsreceiver/internal/kubelet/accumulator.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/cpu.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/fs.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/network.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/volume.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/metadata.go`
- `receiver/kubeletstatsreceiver/config.go`
        • v0.157.0.md 8.7 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/kubeletstatsreceiver
version: v0.157.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/kubeletstatsreceiver
commit_sha: 89e43555904cd97c2d36605347c5d5237b1bdc8c
last_verified: 2026-08-06
---

# Kubelet Stats Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `container.cpu.time` | Sum | `s` | - | - |
| `container.cpu.usage` | Gauge | `{cpu}` | - | Feature gate `receiver.kubeletstats.cpuUsageScrapeBased` changes this to scrape-based calculation (from v0.156.0). |
| `container.filesystem.available` | Gauge | `By` | - | - |
| `container.filesystem.capacity` | Gauge | `By` | - | - |
| `container.filesystem.usage` | Gauge | `By` | - | - |
| `container.memory.available` | Gauge | `By` | - | - |
| `container.memory.major_page_faults` | Gauge | `1` | - | - |
| `container.memory.page_faults` | Gauge | `1` | - | - |
| `container.memory.rss` | Gauge | `By` | - | - |
| `container.memory.usage` | Gauge | `By` | - | - |
| `container.memory.working_set` | Gauge | `By` | - | - |
| `k8s.node.cpu.time` | Sum | `s` | - | - |
| `k8s.node.cpu.usage` | Gauge | `{cpu}` | - | Feature gate `receiver.kubeletstats.cpuUsageScrapeBased` changes this to scrape-based calculation (from v0.156.0). |
| `k8s.node.filesystem.available` | Gauge | `By` | - | - |
| `k8s.node.filesystem.capacity` | Gauge | `By` | - | - |
| `k8s.node.filesystem.usage` | Gauge | `By` | - | - |
| `k8s.node.memory.available` | Gauge | `By` | - | - |
| `k8s.node.memory.major_page_faults` | Gauge | `1` | - | - |
| `k8s.node.memory.page_faults` | Gauge | `1` | - | - |
| `k8s.node.memory.rss` | Gauge | `By` | - | - |
| `k8s.node.memory.usage` | Gauge | `By` | - | - |
| `k8s.node.memory.working_set` | Gauge | `By` | - | - |
| `k8s.pod.cpu.time` | Sum | `s` | - | - |
| `k8s.pod.cpu.usage` | Gauge | `{cpu}` | - | Feature gate `receiver.kubeletstats.cpuUsageScrapeBased` changes this to scrape-based calculation (from v0.156.0). |
| `k8s.pod.filesystem.available` | Gauge | `By` | - | - |
| `k8s.pod.filesystem.capacity` | Gauge | `By` | - | - |
| `k8s.pod.filesystem.usage` | Gauge | `By` | - | - |
| `k8s.pod.memory.available` | Gauge | `By` | - | - |
| `k8s.pod.memory.major_page_faults` | Gauge | `1` | - | - |
| `k8s.pod.memory.page_faults` | Gauge | `1` | - | - |
| `k8s.pod.memory.rss` | Gauge | `By` | - | - |
| `k8s.pod.memory.usage` | Gauge | `By` | - | - |
| `k8s.pod.memory.working_set` | Gauge | `By` | - | - |
| `k8s.node.network.errors` | Sum | `1` | interface, direction | - |
| `k8s.node.network.io` | Sum | `By` | interface, direction | - |
| `k8s.pod.network.errors` | Sum | `1` | interface, direction | - |
| `k8s.pod.network.io` | Sum | `By` | interface, direction | - |
| `k8s.volume.available` | Gauge | `By` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.capacity` | Gauge | `By` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes.free` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes.used` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `container.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.container.uptime.enabled`. |
| `k8s.container.cpu.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.cpu.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.cpu_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.cpu_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.cpu_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.cpu_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.ephemeral_storage.usage` | Sum | `By` | fs.type | Optional: disabled by default; enable with `metrics.k8s.container.ephemeral_storage.usage.enabled`. |
| `k8s.container.memory.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.memory.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.memory_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.memory_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.memory_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.memory_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.node.system_container.cpu.time` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.cpu.time.enabled`. |
| `k8s.node.system_container.cpu.usage` | Gauge | `{cpu}` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.cpu.usage.enabled`. |
| `k8s.node.system_container.memory.usage` | Gauge | `By` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.memory.usage.enabled`. |
| `k8s.node.system_container.memory.working_set` | Gauge | `By` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.memory.working_set.enabled`. |
| `k8s.node.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.node.uptime.enabled`. |
| `k8s.pod.cpu.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.cpu.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.cpu_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.cpu_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.cpu_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.cpu_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.memory.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.memory.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.memory_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.memory_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.memory_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.memory_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.pod.uptime.enabled`. |
| `k8s.pod.volume.usage` | Sum | `By` | - | Optional: disabled by default; enable with `metrics.k8s.pod.volume.usage.enabled`. Collected when metric group `volume` is enabled. |


## Sources

- `receiver/kubeletstatsreceiver/metadata.yaml`
- `receiver/kubeletstatsreceiver/internal/kubelet/accumulator.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/cpu.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/fs.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/network.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/volume.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/metadata.go`
- `receiver/kubeletstatsreceiver/config.go`
        • v0.158.0.md 8.7 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/kubeletstatsreceiver
version: v0.158.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/kubeletstatsreceiver
commit_sha: 821a9d9c2c1623c4a0ceba5d47b57c48879c3f84
last_verified: 2026-08-06
---

# Kubelet Stats Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `container.cpu.time` | Sum | `s` | - | - |
| `container.cpu.usage` | Gauge | `{cpu}` | - | Feature gate `receiver.kubeletstats.cpuUsageScrapeBased` changes this to scrape-based calculation (from v0.156.0). |
| `container.filesystem.available` | Gauge | `By` | - | - |
| `container.filesystem.capacity` | Gauge | `By` | - | - |
| `container.filesystem.usage` | Gauge | `By` | - | - |
| `container.memory.available` | Gauge | `By` | - | - |
| `container.memory.major_page_faults` | Gauge | `1` | - | - |
| `container.memory.page_faults` | Gauge | `1` | - | - |
| `container.memory.rss` | Gauge | `By` | - | - |
| `container.memory.usage` | Gauge | `By` | - | - |
| `container.memory.working_set` | Gauge | `By` | - | - |
| `k8s.node.cpu.time` | Sum | `s` | - | - |
| `k8s.node.cpu.usage` | Gauge | `{cpu}` | - | Feature gate `receiver.kubeletstats.cpuUsageScrapeBased` changes this to scrape-based calculation (from v0.156.0). |
| `k8s.node.filesystem.available` | Gauge | `By` | - | - |
| `k8s.node.filesystem.capacity` | Gauge | `By` | - | - |
| `k8s.node.filesystem.usage` | Gauge | `By` | - | - |
| `k8s.node.memory.available` | Gauge | `By` | - | - |
| `k8s.node.memory.major_page_faults` | Gauge | `1` | - | - |
| `k8s.node.memory.page_faults` | Gauge | `1` | - | - |
| `k8s.node.memory.rss` | Gauge | `By` | - | - |
| `k8s.node.memory.usage` | Gauge | `By` | - | - |
| `k8s.node.memory.working_set` | Gauge | `By` | - | - |
| `k8s.pod.cpu.time` | Sum | `s` | - | - |
| `k8s.pod.cpu.usage` | Gauge | `{cpu}` | - | Feature gate `receiver.kubeletstats.cpuUsageScrapeBased` changes this to scrape-based calculation (from v0.156.0). |
| `k8s.pod.filesystem.available` | Gauge | `By` | - | - |
| `k8s.pod.filesystem.capacity` | Gauge | `By` | - | - |
| `k8s.pod.filesystem.usage` | Gauge | `By` | - | - |
| `k8s.pod.memory.available` | Gauge | `By` | - | - |
| `k8s.pod.memory.major_page_faults` | Gauge | `1` | - | - |
| `k8s.pod.memory.page_faults` | Gauge | `1` | - | - |
| `k8s.pod.memory.rss` | Gauge | `By` | - | - |
| `k8s.pod.memory.usage` | Gauge | `By` | - | - |
| `k8s.pod.memory.working_set` | Gauge | `By` | - | - |
| `k8s.node.network.errors` | Sum | `1` | interface, direction | - |
| `k8s.node.network.io` | Sum | `By` | interface, direction | - |
| `k8s.pod.network.errors` | Sum | `1` | interface, direction | - |
| `k8s.pod.network.io` | Sum | `By` | interface, direction | - |
| `k8s.volume.available` | Gauge | `By` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.capacity` | Gauge | `By` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes.free` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes.used` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `container.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.container.uptime.enabled`. |
| `k8s.container.cpu.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.cpu.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.cpu_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.cpu_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.cpu_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.cpu_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.ephemeral_storage.usage` | Sum | `By` | fs.type | Optional: disabled by default; enable with `metrics.k8s.container.ephemeral_storage.usage.enabled`. |
| `k8s.container.memory.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.memory.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.memory_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.memory_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.memory_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.memory_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.node.system_container.cpu.time` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.cpu.time.enabled`. |
| `k8s.node.system_container.cpu.usage` | Gauge | `{cpu}` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.cpu.usage.enabled`. |
| `k8s.node.system_container.memory.usage` | Gauge | `By` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.memory.usage.enabled`. |
| `k8s.node.system_container.memory.working_set` | Gauge | `By` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.memory.working_set.enabled`. |
| `k8s.node.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.node.uptime.enabled`. |
| `k8s.pod.cpu.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.cpu.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.cpu_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.cpu_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.cpu_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.cpu_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.memory.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.memory.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.memory_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.memory_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.memory_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.memory_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.pod.uptime.enabled`. |
| `k8s.pod.volume.usage` | Sum | `By` | - | Optional: disabled by default; enable with `metrics.k8s.pod.volume.usage.enabled`. Collected when metric group `volume` is enabled. |


## Sources

- `receiver/kubeletstatsreceiver/metadata.yaml`
- `receiver/kubeletstatsreceiver/internal/kubelet/accumulator.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/cpu.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/fs.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/network.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/volume.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/metadata.go`
- `receiver/kubeletstatsreceiver/config.go`
        • v0.159.0.md 9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/kubeletstatsreceiver
version: v0.159.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/kubeletstatsreceiver
commit_sha: 1120cc0714bf4d14600105e5673c3b00fe87467a
last_verified: 2026-08-26
---

# Kubelet Stats Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `container.cpu.time` | Sum | `s` | - | - |
| `container.cpu.usage` | Gauge | `{cpu}` | - | Feature gate `receiver.kubeletstats.cpuUsageScrapeBased` changes this to scrape-based calculation (from v0.156.0). |
| `container.filesystem.available` | Gauge | `By` | - | - |
| `container.filesystem.capacity` | Gauge | `By` | - | - |
| `container.filesystem.usage` | Gauge | `By` | - | - |
| `container.memory.available` | Gauge | `By` | - | - |
| `container.memory.major_page_faults` | Gauge | `1` | - | - |
| `container.memory.page_faults` | Gauge | `1` | - | - |
| `container.memory.rss` | Gauge | `By` | - | - |
| `container.memory.usage` | Gauge | `By` | - | - |
| `container.memory.working_set` | Gauge | `By` | - | - |
| `k8s.node.cpu.time` | Sum | `s` | - | - |
| `k8s.node.cpu.usage` | Gauge | `{cpu}` | - | Feature gate `receiver.kubeletstats.cpuUsageScrapeBased` changes this to scrape-based calculation (from v0.156.0). |
| `k8s.node.filesystem.available` | Gauge | `By` | - | - |
| `k8s.node.filesystem.capacity` | Gauge | `By` | - | - |
| `k8s.node.filesystem.inode.count` | Sum | `{inode}` | - | Optional: disabled by default; enable with `metrics.k8s.node.filesystem.inode.count.enabled`. |
| `k8s.node.filesystem.inode.free` | Sum | `{inode}` | - | Optional: disabled by default; enable with `metrics.k8s.node.filesystem.inode.free.enabled`. |
| `k8s.node.filesystem.usage` | Gauge | `By` | - | - |
| `k8s.node.memory.available` | Gauge | `By` | - | - |
| `k8s.node.memory.major_page_faults` | Gauge | `1` | - | - |
| `k8s.node.memory.page_faults` | Gauge | `1` | - | - |
| `k8s.node.memory.rss` | Gauge | `By` | - | - |
| `k8s.node.memory.usage` | Gauge | `By` | - | - |
| `k8s.node.memory.working_set` | Gauge | `By` | - | - |
| `k8s.pod.cpu.time` | Sum | `s` | - | - |
| `k8s.pod.cpu.usage` | Gauge | `{cpu}` | - | Feature gate `receiver.kubeletstats.cpuUsageScrapeBased` changes this to scrape-based calculation (from v0.156.0). |
| `k8s.pod.filesystem.available` | Gauge | `By` | - | - |
| `k8s.pod.filesystem.capacity` | Gauge | `By` | - | - |
| `k8s.pod.filesystem.usage` | Gauge | `By` | - | - |
| `k8s.pod.memory.available` | Gauge | `By` | - | - |
| `k8s.pod.memory.major_page_faults` | Gauge | `1` | - | - |
| `k8s.pod.memory.page_faults` | Gauge | `1` | - | - |
| `k8s.pod.memory.rss` | Gauge | `By` | - | - |
| `k8s.pod.memory.usage` | Gauge | `By` | - | - |
| `k8s.pod.memory.working_set` | Gauge | `By` | - | - |
| `k8s.node.network.errors` | Sum | `1` | interface, direction | - |
| `k8s.node.network.io` | Sum | `By` | interface, direction | - |
| `k8s.pod.network.errors` | Sum | `1` | interface, direction | - |
| `k8s.pod.network.io` | Sum | `By` | interface, direction | - |
| `k8s.volume.available` | Gauge | `By` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.capacity` | Gauge | `By` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes.free` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes.used` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `container.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.container.uptime.enabled`. |
| `k8s.container.cpu.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.cpu.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.cpu_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.cpu_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.cpu_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.cpu_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.ephemeral_storage.usage` | Sum | `By` | fs.type | Optional: disabled by default; enable with `metrics.k8s.container.ephemeral_storage.usage.enabled`. |
| `k8s.container.memory.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.memory.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.memory_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.memory_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.memory_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.memory_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.node.system_container.cpu.time` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.cpu.time.enabled`. |
| `k8s.node.system_container.cpu.usage` | Gauge | `{cpu}` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.cpu.usage.enabled`. |
| `k8s.node.system_container.memory.usage` | Gauge | `By` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.memory.usage.enabled`. |
| `k8s.node.system_container.memory.working_set` | Gauge | `By` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.memory.working_set.enabled`. |
| `k8s.node.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.node.uptime.enabled`. |
| `k8s.pod.cpu.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.cpu.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.cpu_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.cpu_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.cpu_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.cpu_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.memory.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.memory.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.memory_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.memory_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.memory_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.memory_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.pod.uptime.enabled`. |
| `k8s.pod.volume.usage` | Sum | `By` | - | Optional: disabled by default; enable with `metrics.k8s.pod.volume.usage.enabled`. Collected when metric group `volume` is enabled. |


## Sources

- `receiver/kubeletstatsreceiver/metadata.yaml`
- `receiver/kubeletstatsreceiver/internal/kubelet/accumulator.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/cpu.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/fs.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/network.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/volume.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/metadata.go`
- `receiver/kubeletstatsreceiver/config.go`
        • v0.160.0.md 9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/kubeletstatsreceiver
version: v0.160.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/kubeletstatsreceiver
commit_sha: 982f20b8a8e8a2569fab3e27cf8b008e8a5080c1
last_verified: 2026-09-03
---

# Kubelet Stats Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `container.cpu.time` | Sum | `s` | - | - |
| `container.cpu.usage` | Gauge | `{cpu}` | - | Feature gate `receiver.kubeletstats.cpuUsageScrapeBased` changes this to scrape-based calculation (from v0.156.0). |
| `container.filesystem.available` | Gauge | `By` | - | - |
| `container.filesystem.capacity` | Gauge | `By` | - | - |
| `container.filesystem.usage` | Gauge | `By` | - | - |
| `container.memory.available` | Gauge | `By` | - | - |
| `container.memory.major_page_faults` | Gauge | `1` | - | - |
| `container.memory.page_faults` | Gauge | `1` | - | - |
| `container.memory.rss` | Gauge | `By` | - | - |
| `container.memory.usage` | Gauge | `By` | - | - |
| `container.memory.working_set` | Gauge | `By` | - | - |
| `k8s.node.cpu.time` | Sum | `s` | - | - |
| `k8s.node.cpu.usage` | Gauge | `{cpu}` | - | Feature gate `receiver.kubeletstats.cpuUsageScrapeBased` changes this to scrape-based calculation (from v0.156.0). |
| `k8s.node.filesystem.available` | Gauge | `By` | - | - |
| `k8s.node.filesystem.capacity` | Gauge | `By` | - | - |
| `k8s.node.filesystem.inode.count` | Sum | `{inode}` | - | Optional: disabled by default; enable with `metrics.k8s.node.filesystem.inode.count.enabled`. |
| `k8s.node.filesystem.inode.free` | Sum | `{inode}` | - | Optional: disabled by default; enable with `metrics.k8s.node.filesystem.inode.free.enabled`. |
| `k8s.node.filesystem.usage` | Gauge | `By` | - | - |
| `k8s.node.memory.available` | Gauge | `By` | - | - |
| `k8s.node.memory.major_page_faults` | Gauge | `1` | - | - |
| `k8s.node.memory.page_faults` | Gauge | `1` | - | - |
| `k8s.node.memory.rss` | Gauge | `By` | - | - |
| `k8s.node.memory.usage` | Gauge | `By` | - | - |
| `k8s.node.memory.working_set` | Gauge | `By` | - | - |
| `k8s.pod.cpu.time` | Sum | `s` | - | - |
| `k8s.pod.cpu.usage` | Gauge | `{cpu}` | - | Feature gate `receiver.kubeletstats.cpuUsageScrapeBased` changes this to scrape-based calculation (from v0.156.0). |
| `k8s.pod.filesystem.available` | Gauge | `By` | - | - |
| `k8s.pod.filesystem.capacity` | Gauge | `By` | - | - |
| `k8s.pod.filesystem.usage` | Gauge | `By` | - | - |
| `k8s.pod.memory.available` | Gauge | `By` | - | - |
| `k8s.pod.memory.major_page_faults` | Gauge | `1` | - | - |
| `k8s.pod.memory.page_faults` | Gauge | `1` | - | - |
| `k8s.pod.memory.rss` | Gauge | `By` | - | - |
| `k8s.pod.memory.usage` | Gauge | `By` | - | - |
| `k8s.pod.memory.working_set` | Gauge | `By` | - | - |
| `k8s.node.network.errors` | Sum | `1` | interface, direction | - |
| `k8s.node.network.io` | Sum | `By` | interface, direction | - |
| `k8s.pod.network.errors` | Sum | `1` | interface, direction | - |
| `k8s.pod.network.io` | Sum | `By` | interface, direction | - |
| `k8s.volume.available` | Gauge | `By` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.capacity` | Gauge | `By` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes.free` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes.used` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `container.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.container.uptime.enabled`. |
| `k8s.container.cpu.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.cpu.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.cpu_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.cpu_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.cpu_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.cpu_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.ephemeral_storage.usage` | Sum | `By` | fs.type | Optional: disabled by default; enable with `metrics.k8s.container.ephemeral_storage.usage.enabled`. |
| `k8s.container.memory.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.memory.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.memory_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.memory_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.memory_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.memory_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.node.system_container.cpu.time` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.cpu.time.enabled`. |
| `k8s.node.system_container.cpu.usage` | Gauge | `{cpu}` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.cpu.usage.enabled`. |
| `k8s.node.system_container.memory.usage` | Gauge | `By` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.memory.usage.enabled`. |
| `k8s.node.system_container.memory.working_set` | Gauge | `By` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.memory.working_set.enabled`. |
| `k8s.node.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.node.uptime.enabled`. |
| `k8s.pod.cpu.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.cpu.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.cpu_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.cpu_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.cpu_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.cpu_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.memory.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.memory.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.memory_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.memory_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.memory_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.memory_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.pod.uptime.enabled`. |
| `k8s.pod.volume.usage` | Sum | `By` | - | Optional: disabled by default; enable with `metrics.k8s.pod.volume.usage.enabled`. Collected when metric group `volume` is enabled. |


## Sources

- `receiver/kubeletstatsreceiver/metadata.yaml`
- `receiver/kubeletstatsreceiver/internal/kubelet/accumulator.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/cpu.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/fs.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/network.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/volume.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/metadata.go`
- `receiver/kubeletstatsreceiver/config.go`
        • v0.161.0.md 8.8 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/kubeletstatsreceiver
version: v0.161.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/kubeletstatsreceiver
commit_sha: 3f8455d8038a985398861171e5310bc9b4e988b2
last_verified: 2026-10-03
---

# Kubelet Stats Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `container.cpu.time` | Sum | `s` | - | - |
| `container.cpu.usage` | Gauge | `{cpu}` | - | Feature gate `receiver.kubeletstats.cpuUsageScrapeBased` (beta, enabled by default) computes this as the rate of the corresponding `*.cpu.time` counter between scrapes; disable the gate to read the kubelet's `UsageNanoCores` directly. |
| `container.filesystem.available` | Gauge | `By` | - | - |
| `container.filesystem.capacity` | Gauge | `By` | - | - |
| `container.filesystem.usage` | Gauge | `By` | - | - |
| `container.memory.available` | Gauge | `By` | - | - |
| `container.memory.major_page_faults` | Gauge | `1` | - | - |
| `container.memory.page_faults` | Gauge | `1` | - | - |
| `container.memory.rss` | Gauge | `By` | - | - |
| `container.memory.usage` | Gauge | `By` | - | - |
| `container.memory.working_set` | Gauge | `By` | - | - |
| `k8s.node.cpu.time` | Sum | `s` | - | - |
| `k8s.node.cpu.usage` | Gauge | `{cpu}` | - | Feature gate `receiver.kubeletstats.cpuUsageScrapeBased` (beta, enabled by default) computes this as the rate of the corresponding `*.cpu.time` counter between scrapes; disable the gate to read the kubelet's `UsageNanoCores` directly. |
| `k8s.node.filesystem.available` | Gauge | `By` | - | - |
| `k8s.node.filesystem.capacity` | Gauge | `By` | - | - |
| `k8s.node.filesystem.inode.count` | Sum | `{inode}` | - | Optional: disabled by default; enable with `metrics.k8s.node.filesystem.inode.count.enabled`. |
| `k8s.node.filesystem.inode.free` | Sum | `{inode}` | - | Optional: disabled by default; enable with `metrics.k8s.node.filesystem.inode.free.enabled`. |
| `k8s.node.filesystem.usage` | Gauge | `By` | - | - |
| `k8s.node.memory.available` | Gauge | `By` | - | - |
| `k8s.node.memory.major_page_faults` | Gauge | `1` | - | - |
| `k8s.node.memory.page_faults` | Gauge | `1` | - | - |
| `k8s.node.memory.rss` | Gauge | `By` | - | - |
| `k8s.node.memory.usage` | Gauge | `By` | - | - |
| `k8s.node.memory.working_set` | Gauge | `By` | - | - |
| `k8s.pod.cpu.time` | Sum | `s` | - | - |
| `k8s.pod.cpu.usage` | Gauge | `{cpu}` | - | Feature gate `receiver.kubeletstats.cpuUsageScrapeBased` (beta, enabled by default) computes this as the rate of the corresponding `*.cpu.time` counter between scrapes; disable the gate to read the kubelet's `UsageNanoCores` directly. |
| `k8s.pod.filesystem.available` | Gauge | `By` | - | - |
| `k8s.pod.filesystem.capacity` | Gauge | `By` | - | - |
| `k8s.pod.filesystem.usage` | Gauge | `By` | - | - |
| `k8s.pod.memory.available` | Gauge | `By` | - | - |
| `k8s.pod.memory.major_page_faults` | Gauge | `1` | - | - |
| `k8s.pod.memory.page_faults` | Gauge | `1` | - | - |
| `k8s.pod.memory.rss` | Gauge | `By` | - | - |
| `k8s.pod.memory.usage` | Gauge | `By` | - | - |
| `k8s.pod.memory.working_set` | Gauge | `By` | - | - |
| `k8s.node.network.errors` | Sum | `1` | interface, direction | - |
| `k8s.node.network.io` | Sum | `By` | interface, direction | - |
| `k8s.pod.network.errors` | Sum | `1` | interface, direction | - |
| `k8s.pod.network.io` | Sum | `By` | interface, direction | - |
| `k8s.volume.available` | Gauge | `By` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.capacity` | Gauge | `By` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes.free` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes.used` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `container.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.container.uptime.enabled`. |
| `k8s.container.cpu.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.cpu.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.cpu_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.cpu_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.cpu_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.cpu_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.ephemeral_storage.usage` | Sum | `By` | fs.type | Optional: disabled by default; enable with `metrics.k8s.container.ephemeral_storage.usage.enabled`. |
| `k8s.container.memory.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.memory.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; |
| `k8s.container.memory_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.memory_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; |
| `k8s.container.memory_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.memory_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; |
| `k8s.node.system_container.cpu.time` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.cpu.time.enabled`. |
| `k8s.node.system_container.cpu.usage` | Gauge | `{cpu}` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.cpu.usage.enabled`. |
| `k8s.node.system_container.memory.usage` | Gauge | `By` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.memory.usage.enabled`. |
| `k8s.node.system_container.memory.working_set` | Gauge | `By` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.memory.working_set.enabled`. |
| `k8s.node.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.node.uptime.enabled`. |
| `k8s.pod.cpu.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.cpu.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.cpu_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.cpu_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.cpu_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.cpu_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.memory.node.utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.memory.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; |
| `k8s.pod.memory_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.memory_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; |
| `k8s.pod.memory_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.memory_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; |
| `k8s.pod.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.pod.uptime.enabled`. |
| `k8s.pod.volume.usage` | Sum | `By` | - | Optional: disabled by default; enable with `metrics.k8s.pod.volume.usage.enabled`. Collected when metric group `volume` is enabled. |


## Sources

- `receiver/kubeletstatsreceiver/metadata.yaml`
- `receiver/kubeletstatsreceiver/internal/kubelet/accumulator.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/cpu.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/fs.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/network.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/volume.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/metadata.go`
- `receiver/kubeletstatsreceiver/config.go`
        • v0.162.0.md 9.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/kubeletstatsreceiver
version: v0.162.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/kubeletstatsreceiver
commit_sha: ae8c507510f48f433ab47dd1c6b01a59d6c388b5
last_verified: 2026-10-03
---

# Kubelet Stats Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `container.cpu.time` | Sum | `s` | - | - |
| `container.cpu.usage` | Gauge | `{cpu}` | - | Feature gate `receiver.kubeletstats.cpuUsageScrapeBased` (beta, enabled by default) computes this as the rate of the corresponding `*.cpu.time` counter between scrapes; disable the gate to read the kubelet's `UsageNanoCores` directly. |
| `container.filesystem.available` | Gauge | `By` | - | - |
| `container.filesystem.capacity` | Gauge | `By` | - | - |
| `container.filesystem.usage` | Gauge | `By` | - | - |
| `container.memory.available` | Gauge | `By` | - | - |
| `container.memory.major_page_faults` | Gauge | `1` | - | - |
| `container.memory.page_faults` | Gauge | `1` | - | - |
| `container.memory.rss` | Gauge | `By` | - | - |
| `container.memory.usage` | Gauge | `By` | - | - |
| `container.memory.working_set` | Gauge | `By` | - | - |
| `k8s.node.cpu.time` | Sum | `s` | - | - |
| `k8s.node.cpu.usage` | Gauge | `{cpu}` | - | Feature gate `receiver.kubeletstats.cpuUsageScrapeBased` (beta, enabled by default) computes this as the rate of the corresponding `*.cpu.time` counter between scrapes; disable the gate to read the kubelet's `UsageNanoCores` directly. |
| `k8s.node.filesystem.available` | Gauge | `By` | - | - |
| `k8s.node.filesystem.capacity` | Gauge | `By` | - | - |
| `k8s.node.filesystem.inode.count` | Sum | `{inode}` | - | Optional: disabled by default; enable with `metrics.k8s.node.filesystem.inode.count.enabled`. |
| `k8s.node.filesystem.inode.free` | Sum | `{inode}` | - | Optional: disabled by default; enable with `metrics.k8s.node.filesystem.inode.free.enabled`. |
| `k8s.node.filesystem.usage` | Gauge | `By` | - | - |
| `k8s.node.memory.available` | Gauge | `By` | - | - |
| `k8s.node.memory.major_page_faults` | Gauge | `1` | - | - |
| `k8s.node.memory.page_faults` | Gauge | `1` | - | - |
| `k8s.node.memory.rss` | Gauge | `By` | - | - |
| `k8s.node.memory.usage` | Gauge | `By` | - | - |
| `k8s.node.memory.working_set` | Gauge | `By` | - | - |
| `k8s.pod.cpu.time` | Sum | `s` | - | - |
| `k8s.pod.cpu.usage` | Gauge | `{cpu}` | - | Feature gate `receiver.kubeletstats.cpuUsageScrapeBased` (beta, enabled by default) computes this as the rate of the corresponding `*.cpu.time` counter between scrapes; disable the gate to read the kubelet's `UsageNanoCores` directly. |
| `k8s.pod.filesystem.available` | Gauge | `By` | - | - |
| `k8s.pod.filesystem.capacity` | Gauge | `By` | - | - |
| `k8s.pod.filesystem.usage` | Gauge | `By` | - | - |
| `k8s.pod.memory.available` | Gauge | `By` | - | - |
| `k8s.pod.memory.major_page_faults` | Gauge | `1` | - | - |
| `k8s.pod.memory.page_faults` | Gauge | `1` | - | - |
| `k8s.pod.memory.rss` | Gauge | `By` | - | - |
| `k8s.pod.memory.usage` | Gauge | `By` | - | - |
| `k8s.pod.memory.working_set` | Gauge | `By` | - | - |
| `k8s.node.network.errors` | Sum | `1` | interface, direction | - |
| `k8s.node.network.io` | Sum | `By` | interface, direction | - |
| `k8s.pod.network.errors` | Sum | `1` | interface, direction | - |
| `k8s.pod.network.io` | Sum | `By` | interface, direction | - |
| `k8s.volume.available` | Gauge | `By` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.capacity` | Gauge | `By` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes.free` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes.used` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `container.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.container.uptime.enabled`. |
| `k8s.container.cpu.node.utilization` | Gauge | `1` | - | Deprecated: the receiver logs a warning when it is enabled. Optional: disabled by default; enable with `metrics.k8s.container.cpu.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.cpu_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.cpu_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.cpu_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.cpu_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.ephemeral_storage.usage` | Sum | `By` | fs.type | Optional: disabled by default; enable with `metrics.k8s.container.ephemeral_storage.usage.enabled`. |
| `k8s.container.memory.node.utilization` | Gauge | `1` | - | Deprecated: the receiver logs a warning when it is enabled. Optional: disabled by default; enable with `metrics.k8s.container.memory.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.memory_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.memory_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.memory_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.memory_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.node.system_container.cpu.time` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.cpu.time.enabled`. |
| `k8s.node.system_container.cpu.usage` | Gauge | `{cpu}` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.cpu.usage.enabled`. |
| `k8s.node.system_container.memory.usage` | Gauge | `By` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.memory.usage.enabled`. |
| `k8s.node.system_container.memory.working_set` | Gauge | `By` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.memory.working_set.enabled`. |
| `k8s.node.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.node.uptime.enabled`. |
| `k8s.pod.cpu.node.utilization` | Gauge | `1` | - | Deprecated: the receiver logs a warning when it is enabled. Optional: disabled by default; enable with `metrics.k8s.pod.cpu.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.cpu_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.cpu_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.cpu_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.cpu_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.memory.node.utilization` | Gauge | `1` | - | Deprecated: the receiver logs a warning when it is enabled. Optional: disabled by default; enable with `metrics.k8s.pod.memory.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.memory_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.memory_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.memory_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.memory_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.pod.uptime.enabled`. |
| `k8s.pod.volume.usage` | Sum | `By` | - | Optional: disabled by default; enable with `metrics.k8s.pod.volume.usage.enabled`. Collected when metric group `volume` is enabled. |


## Sources

- `receiver/kubeletstatsreceiver/metadata.yaml`
- `receiver/kubeletstatsreceiver/internal/kubelet/accumulator.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/cpu.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/fs.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/network.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/volume.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/metadata.go`
- `receiver/kubeletstatsreceiver/config.go`
        • v0.163.0.md 10 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/kubeletstatsreceiver
version: v0.163.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/kubeletstatsreceiver
commit_sha: df849b5403c041d5e799e7846392a6f18b0b55ae
last_verified: null
---

# Kubelet Stats Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `container.cpu.time` | Sum | `s` | - | - |
| `container.cpu.usage` | Gauge | `{cpu}` | - | Feature gate `receiver.kubeletstats.cpuUsageScrapeBased` (beta, enabled by default) computes this as the rate of the corresponding `*.cpu.time` counter between scrapes; disable the gate to read the kubelet's `UsageNanoCores` directly. |
| `container.filesystem.available` | Gauge | `By` | - | - |
| `container.filesystem.capacity` | Gauge | `By` | - | - |
| `container.filesystem.usage` | Gauge | `By` | - | - |
| `container.memory.available` | Gauge | `By` | - | - |
| `container.memory.major_page_faults` | Gauge | `1` | - | - |
| `container.memory.page_faults` | Gauge | `1` | - | - |
| `container.memory.rss` | Gauge | `By` | - | - |
| `container.memory.usage` | Gauge | `By` | - | - |
| `container.memory.working_set` | Gauge | `By` | - | - |
| `k8s.node.cpu.time` | Sum | `s` | - | - |
| `k8s.node.cpu.usage` | Gauge | `{cpu}` | - | Feature gate `receiver.kubeletstats.cpuUsageScrapeBased` (beta, enabled by default) computes this as the rate of the corresponding `*.cpu.time` counter between scrapes; disable the gate to read the kubelet's `UsageNanoCores` directly. |
| `k8s.node.filesystem.available` | Gauge | `By` | - | - |
| `k8s.node.filesystem.capacity` | Gauge | `By` | - | - |
| `k8s.node.filesystem.inode.count` | Sum | `{inode}` | - | Optional: disabled by default; enable with `metrics.k8s.node.filesystem.inode.count.enabled`. |
| `k8s.node.filesystem.inode.free` | Sum | `{inode}` | - | Optional: disabled by default; enable with `metrics.k8s.node.filesystem.inode.free.enabled`. |
| `k8s.node.filesystem.usage` | Gauge | `By` | - | - |
| `k8s.node.memory.available` | Gauge | `By` | - | - |
| `k8s.node.memory.major_page_faults` | Gauge | `1` | - | - |
| `k8s.node.memory.page_faults` | Gauge | `1` | - | - |
| `k8s.node.memory.rss` | Gauge | `By` | - | - |
| `k8s.node.memory.usage` | Gauge | `By` | - | - |
| `k8s.node.memory.working_set` | Gauge | `By` | - | - |
| `k8s.pod.cpu.time` | Sum | `s` | - | - |
| `k8s.pod.cpu.usage` | Gauge | `{cpu}` | - | Feature gate `receiver.kubeletstats.cpuUsageScrapeBased` (beta, enabled by default) computes this as the rate of the corresponding `*.cpu.time` counter between scrapes; disable the gate to read the kubelet's `UsageNanoCores` directly. |
| `k8s.pod.filesystem.available` | Gauge | `By` | - | - |
| `k8s.pod.filesystem.capacity` | Gauge | `By` | - | - |
| `k8s.pod.filesystem.usage` | Gauge | `By` | - | - |
| `k8s.pod.memory.available` | Gauge | `By` | - | - |
| `k8s.pod.memory.major_page_faults` | Gauge | `1` | - | - |
| `k8s.pod.memory.page_faults` | Gauge | `1` | - | - |
| `k8s.pod.memory.rss` | Gauge | `By` | - | - |
| `k8s.pod.memory.usage` | Gauge | `By` | - | - |
| `k8s.pod.memory.working_set` | Gauge | `By` | - | - |
| `k8s.node.network.errors` | Sum | `1` | interface, direction | - |
| `k8s.node.network.io` | Sum | `By` | interface, direction | - |
| `k8s.node.pid.limit` | Sum | `{thread}` | - | Optional: disabled by default; enable with `metrics.k8s.node.pid.limit.enabled`. |
| `k8s.node.pid.usage` | Sum | `{thread}` | - | Optional: disabled by default; enable with `metrics.k8s.node.pid.usage.enabled`. |
| `k8s.pod.network.errors` | Sum | `1` | interface, direction | - |
| `k8s.pod.network.io` | Sum | `By` | interface, direction | - |
| `k8s.volume.available` | Gauge | `By` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.capacity` | Gauge | `By` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes.free` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `k8s.volume.inodes.used` | Gauge | `1` | - | Collected when metric group `volume` is enabled (not in the default metric groups). |
| `container.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.container.uptime.enabled`. |
| `k8s.container.cpu.node.utilization` | Gauge | `1` | - | Deprecated: the receiver logs a warning when it is enabled. Optional: disabled by default; enable with `metrics.k8s.container.cpu.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.cpu_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.cpu_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.cpu_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.cpu_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.ephemeral_storage.usage` | Sum | `By` | fs.type | Optional: disabled by default; enable with `metrics.k8s.container.ephemeral_storage.usage.enabled`. |
| `k8s.container.memory.node.utilization` | Gauge | `1` | - | Deprecated: the receiver logs a warning when it is enabled. Optional: disabled by default; enable with `metrics.k8s.container.memory.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.memory_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.memory_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.container.memory_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.container.memory_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.node.system_container.cpu.time` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.cpu.time.enabled`. |
| `k8s.node.system_container.cpu.usage` | Gauge | `{cpu}` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.cpu.usage.enabled`. |
| `k8s.node.system_container.memory.usage` | Gauge | `By` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.memory.usage.enabled`. |
| `k8s.node.system_container.memory.working_set` | Gauge | `By` | - | Optional: disabled by default; enable with `metrics.k8s.node.system_container.memory.working_set.enabled`. |
| `k8s.node.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.node.uptime.enabled`. |
| `k8s.pod.cpu.node.utilization` | Gauge | `1` | - | Deprecated: the receiver logs a warning when it is enabled. Optional: disabled by default; enable with `metrics.k8s.pod.cpu.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.cpu_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.cpu_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.cpu_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.cpu_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.memory.node.utilization` | Gauge | `1` | - | Deprecated: the receiver logs a warning when it is enabled. Optional: disabled by default; enable with `metrics.k8s.pod.memory.node.utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.memory_limit_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.memory_limit_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.memory_request_utilization` | Gauge | `1` | - | Optional: disabled by default; enable with `metrics.k8s.pod.memory_request_utilization.enabled`. Requires the corresponding Kubernetes resource/node data; CPU-derived utilization also follows `receiver.kubeletstats.cpuUsageScrapeBased`. |
| `k8s.pod.uptime` | Sum | `s` | - | Optional: disabled by default; enable with `metrics.k8s.pod.uptime.enabled`. |
| `k8s.pod.volume.usage` | Sum | `By` | - | Optional: disabled by default; enable with `metrics.k8s.pod.volume.usage.enabled`. Collected when metric group `volume` is enabled. |


## Sources

- `receiver/kubeletstatsreceiver/metadata.yaml`
- `receiver/kubeletstatsreceiver/internal/kubelet/accumulator.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/rlimit.go`
- `receiver/kubeletstatsreceiver/internal/metadata/generated_metrics.go` `receiver/kubeletstatsreceiver/metadata.yaml`
- `receiver/kubeletstatsreceiver/internal/kubelet/accumulator.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/cpu.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/fs.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/network.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/volume.go`
- `receiver/kubeletstatsreceiver/internal/kubelet/metadata.go`
- `receiver/kubeletstatsreceiver/config.go`
      • mongodbreceiver
        • v0.153.0.md 6.1 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/mongodbreceiver
version: v0.153.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/mongodbreceiver
commit_sha: 42f949127580c0d00088b785cd0b35842dc0ddb8
last_verified: 2026-08-11
---

# MongoDB Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `mongodb.active.reads` | Sum (cumulative, non-monotonic) | `{reads}` | - | Disabled by default; enable with `metrics.mongodb.active.reads.enabled`. |
| `mongodb.active.writes` | Sum (cumulative, non-monotonic) | `{writes}` | - | Disabled by default; enable with `metrics.mongodb.active.writes.enabled`. |
| `mongodb.cache.operations` | Sum (cumulative, monotonic) | `{operations}` | type | - |
| `mongodb.collection.count` | Sum (cumulative, non-monotonic) | `{collections}` | db.namespace | - |
| `mongodb.commands.rate` | Gauge | `{command}/s` | - | Disabled by default; enable with `metrics.mongodb.commands.rate.enabled`. |
| `mongodb.connection.count` | Sum (cumulative, non-monotonic) | `{connections}` | type, db.namespace | - |
| `mongodb.cursor.count` | Sum (cumulative, non-monotonic) | `{cursors}` | - | - |
| `mongodb.cursor.timeout.count` | Sum (cumulative, non-monotonic) | `{cursors}` | - | - |
| `mongodb.data.size` | Sum (cumulative, non-monotonic) | `By` | db.namespace | - |
| `mongodb.database.count` | Sum (cumulative, non-monotonic) | `{databases}` | - | - |
| `mongodb.deletes.rate` | Gauge | `{delete}/s` | - | Disabled by default; enable with `metrics.mongodb.deletes.rate.enabled`. |
| `mongodb.document.operation.count` | Sum (cumulative, non-monotonic) | `{documents}` | operation, db.namespace | - |
| `mongodb.extent.count` | Sum (cumulative, non-monotonic) | `{extents}` | db.namespace | - |
| `mongodb.flushes.rate` | Gauge | `{flush}/s` | - | Disabled by default; enable with `metrics.mongodb.flushes.rate.enabled`. |
| `mongodb.getmores.rate` | Gauge | `{getmore}/s` | - | Disabled by default; enable with `metrics.mongodb.getmores.rate.enabled`. |
| `mongodb.global_lock.time` | Sum (cumulative, monotonic) | `ms` | - | - |
| `mongodb.health` | Gauge | `1` | - | Disabled by default; enable with `metrics.mongodb.health.enabled`. |
| `mongodb.index.access.count` | Sum (cumulative, non-monotonic) | `{accesses}` | collection, db.namespace | - |
| `mongodb.index.count` | Sum (cumulative, non-monotonic) | `{indexes}` | db.namespace | - |
| `mongodb.index.size` | Sum (cumulative, non-monotonic) | `By` | db.namespace | - |
| `mongodb.inserts.rate` | Gauge | `{insert}/s` | - | Disabled by default; enable with `metrics.mongodb.inserts.rate.enabled`. |
| `mongodb.lock.acquire.count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.count.enabled`. |
| `mongodb.lock.acquire.time` | Sum (cumulative, monotonic) | `microseconds` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.time.enabled`. |
| `mongodb.lock.acquire.wait_count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.wait_count.enabled`. |
| `mongodb.lock.deadlock.count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.deadlock.count.enabled`. |
| `mongodb.memory.usage` | Sum (cumulative, non-monotonic) | `By` | type, db.namespace | - |
| `mongodb.network.io.receive` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `mongodb.network.io.transmit` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `mongodb.network.request.count` | Sum (cumulative, non-monotonic) | `{requests}` | - | - |
| `mongodb.object.count` | Sum (cumulative, non-monotonic) | `{objects}` | db.namespace | - |
| `mongodb.operation.count` | Sum (cumulative, monotonic) | `{operations}` | operation | - |
| `mongodb.operation.latency.time` | Gauge | `us` | operation | Disabled by default; enable with `metrics.mongodb.operation.latency.time.enabled`. |
| `mongodb.operation.repl.count` | Sum (cumulative, monotonic) | `{operations}` | operation | Disabled by default; enable with `metrics.mongodb.operation.repl.count.enabled`. |
| `mongodb.operation.time` | Sum (cumulative, monotonic) | `ms` | operation | - |
| `mongodb.page_faults` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.mongodb.page_faults.enabled`. |
| `mongodb.queries.rate` | Gauge | `{query}/s` | - | Disabled by default; enable with `metrics.mongodb.queries.rate.enabled`. |
| `mongodb.repl_commands_per_sec` | Gauge | `{command}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_commands_per_sec.enabled`. |
| `mongodb.repl_deletes_per_sec` | Gauge | `{delete}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_deletes_per_sec.enabled`. |
| `mongodb.repl_getmores_per_sec` | Gauge | `{getmore}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_getmores_per_sec.enabled`. |
| `mongodb.repl_inserts_per_sec` | Gauge | `{insert}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_inserts_per_sec.enabled`. |
| `mongodb.repl_queries_per_sec` | Gauge | `{query}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_queries_per_sec.enabled`. |
| `mongodb.repl_updates_per_sec` | Gauge | `{update}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_updates_per_sec.enabled`. |
| `mongodb.session.count` | Sum (cumulative, non-monotonic) | `{sessions}` | - | - |
| `mongodb.storage.size` | Sum (cumulative, monotonic) | `By` | db.namespace | - |
| `mongodb.updates.rate` | Gauge | `{update}/s` | - | Disabled by default; enable with `metrics.mongodb.updates.rate.enabled`. |
| `mongodb.uptime` | Sum (cumulative, monotonic) | `ms` | - | Disabled by default; enable with `metrics.mongodb.uptime.enabled`. |
| `mongodb.wtcache.bytes.read` | Sum (cumulative, monotonic) | `By` | - | Disabled by default; enable with `metrics.mongodb.wtcache.bytes.read.enabled`. |

## Sources

- `receiver/mongodbreceiver/metadata.yaml`
- `receiver/mongodbreceiver/scraper.go`
- `receiver/mongodbreceiver/metrics.go`
        • v0.154.0.md 6.1 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/mongodbreceiver
version: v0.154.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/mongodbreceiver
commit_sha: 853eda0e12b3ba142552ecd2b63cec07062904f0
last_verified: 2026-08-11
---

# MongoDB Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `mongodb.active.reads` | Sum (cumulative, non-monotonic) | `{reads}` | - | Disabled by default; enable with `metrics.mongodb.active.reads.enabled`. |
| `mongodb.active.writes` | Sum (cumulative, non-monotonic) | `{writes}` | - | Disabled by default; enable with `metrics.mongodb.active.writes.enabled`. |
| `mongodb.cache.operations` | Sum (cumulative, monotonic) | `{operations}` | type | - |
| `mongodb.collection.count` | Sum (cumulative, non-monotonic) | `{collections}` | db.namespace | - |
| `mongodb.commands.rate` | Gauge | `{command}/s` | - | Disabled by default; enable with `metrics.mongodb.commands.rate.enabled`. |
| `mongodb.connection.count` | Sum (cumulative, non-monotonic) | `{connections}` | type, db.namespace | - |
| `mongodb.cursor.count` | Sum (cumulative, non-monotonic) | `{cursors}` | - | - |
| `mongodb.cursor.timeout.count` | Sum (cumulative, non-monotonic) | `{cursors}` | - | - |
| `mongodb.data.size` | Sum (cumulative, non-monotonic) | `By` | db.namespace | - |
| `mongodb.database.count` | Sum (cumulative, non-monotonic) | `{databases}` | - | - |
| `mongodb.deletes.rate` | Gauge | `{delete}/s` | - | Disabled by default; enable with `metrics.mongodb.deletes.rate.enabled`. |
| `mongodb.document.operation.count` | Sum (cumulative, non-monotonic) | `{documents}` | operation, db.namespace | - |
| `mongodb.extent.count` | Sum (cumulative, non-monotonic) | `{extents}` | db.namespace | - |
| `mongodb.flushes.rate` | Gauge | `{flush}/s` | - | Disabled by default; enable with `metrics.mongodb.flushes.rate.enabled`. |
| `mongodb.getmores.rate` | Gauge | `{getmore}/s` | - | Disabled by default; enable with `metrics.mongodb.getmores.rate.enabled`. |
| `mongodb.global_lock.time` | Sum (cumulative, monotonic) | `ms` | - | - |
| `mongodb.health` | Gauge | `1` | - | Disabled by default; enable with `metrics.mongodb.health.enabled`. |
| `mongodb.index.access.count` | Sum (cumulative, non-monotonic) | `{accesses}` | collection, db.namespace | - |
| `mongodb.index.count` | Sum (cumulative, non-monotonic) | `{indexes}` | db.namespace | - |
| `mongodb.index.size` | Sum (cumulative, non-monotonic) | `By` | db.namespace | - |
| `mongodb.inserts.rate` | Gauge | `{insert}/s` | - | Disabled by default; enable with `metrics.mongodb.inserts.rate.enabled`. |
| `mongodb.lock.acquire.count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.count.enabled`. |
| `mongodb.lock.acquire.time` | Sum (cumulative, monotonic) | `microseconds` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.time.enabled`. |
| `mongodb.lock.acquire.wait_count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.wait_count.enabled`. |
| `mongodb.lock.deadlock.count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.deadlock.count.enabled`. |
| `mongodb.memory.usage` | Sum (cumulative, non-monotonic) | `By` | type, db.namespace | - |
| `mongodb.network.io.receive` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `mongodb.network.io.transmit` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `mongodb.network.request.count` | Sum (cumulative, non-monotonic) | `{requests}` | - | - |
| `mongodb.object.count` | Sum (cumulative, non-monotonic) | `{objects}` | db.namespace | - |
| `mongodb.operation.count` | Sum (cumulative, monotonic) | `{operations}` | operation | - |
| `mongodb.operation.latency.time` | Gauge | `us` | operation | Disabled by default; enable with `metrics.mongodb.operation.latency.time.enabled`. |
| `mongodb.operation.repl.count` | Sum (cumulative, monotonic) | `{operations}` | operation | Disabled by default; enable with `metrics.mongodb.operation.repl.count.enabled`. |
| `mongodb.operation.time` | Sum (cumulative, monotonic) | `ms` | operation | - |
| `mongodb.page_faults` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.mongodb.page_faults.enabled`. |
| `mongodb.queries.rate` | Gauge | `{query}/s` | - | Disabled by default; enable with `metrics.mongodb.queries.rate.enabled`. |
| `mongodb.repl_commands_per_sec` | Gauge | `{command}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_commands_per_sec.enabled`. |
| `mongodb.repl_deletes_per_sec` | Gauge | `{delete}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_deletes_per_sec.enabled`. |
| `mongodb.repl_getmores_per_sec` | Gauge | `{getmore}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_getmores_per_sec.enabled`. |
| `mongodb.repl_inserts_per_sec` | Gauge | `{insert}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_inserts_per_sec.enabled`. |
| `mongodb.repl_queries_per_sec` | Gauge | `{query}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_queries_per_sec.enabled`. |
| `mongodb.repl_updates_per_sec` | Gauge | `{update}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_updates_per_sec.enabled`. |
| `mongodb.session.count` | Sum (cumulative, non-monotonic) | `{sessions}` | - | - |
| `mongodb.storage.size` | Sum (cumulative, monotonic) | `By` | db.namespace | - |
| `mongodb.updates.rate` | Gauge | `{update}/s` | - | Disabled by default; enable with `metrics.mongodb.updates.rate.enabled`. |
| `mongodb.uptime` | Sum (cumulative, monotonic) | `ms` | - | Disabled by default; enable with `metrics.mongodb.uptime.enabled`. |
| `mongodb.wtcache.bytes.read` | Sum (cumulative, monotonic) | `By` | - | Disabled by default; enable with `metrics.mongodb.wtcache.bytes.read.enabled`. |

## Sources

- `receiver/mongodbreceiver/metadata.yaml`
- `receiver/mongodbreceiver/scraper.go`
- `receiver/mongodbreceiver/metrics.go`
        • v0.155.0.md 6.1 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/mongodbreceiver
version: v0.155.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/mongodbreceiver
commit_sha: aaf5045a24c0a6f000225c97ad5449e69aeb5835
last_verified: 2026-08-11
---

# MongoDB Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `mongodb.active.reads` | Sum (cumulative, non-monotonic) | `{reads}` | - | Disabled by default; enable with `metrics.mongodb.active.reads.enabled`. |
| `mongodb.active.writes` | Sum (cumulative, non-monotonic) | `{writes}` | - | Disabled by default; enable with `metrics.mongodb.active.writes.enabled`. |
| `mongodb.cache.operations` | Sum (cumulative, monotonic) | `{operations}` | type | - |
| `mongodb.collection.count` | Sum (cumulative, non-monotonic) | `{collections}` | db.namespace | - |
| `mongodb.commands.rate` | Gauge | `{command}/s` | - | Disabled by default; enable with `metrics.mongodb.commands.rate.enabled`. |
| `mongodb.connection.count` | Sum (cumulative, non-monotonic) | `{connections}` | type, db.namespace | - |
| `mongodb.cursor.count` | Sum (cumulative, non-monotonic) | `{cursors}` | - | - |
| `mongodb.cursor.timeout.count` | Sum (cumulative, non-monotonic) | `{cursors}` | - | - |
| `mongodb.data.size` | Sum (cumulative, non-monotonic) | `By` | db.namespace | - |
| `mongodb.database.count` | Sum (cumulative, non-monotonic) | `{databases}` | - | - |
| `mongodb.deletes.rate` | Gauge | `{delete}/s` | - | Disabled by default; enable with `metrics.mongodb.deletes.rate.enabled`. |
| `mongodb.document.operation.count` | Sum (cumulative, non-monotonic) | `{documents}` | operation, db.namespace | - |
| `mongodb.extent.count` | Sum (cumulative, non-monotonic) | `{extents}` | db.namespace | - |
| `mongodb.flushes.rate` | Gauge | `{flush}/s` | - | Disabled by default; enable with `metrics.mongodb.flushes.rate.enabled`. |
| `mongodb.getmores.rate` | Gauge | `{getmore}/s` | - | Disabled by default; enable with `metrics.mongodb.getmores.rate.enabled`. |
| `mongodb.global_lock.time` | Sum (cumulative, monotonic) | `ms` | - | - |
| `mongodb.health` | Gauge | `1` | - | Disabled by default; enable with `metrics.mongodb.health.enabled`. |
| `mongodb.index.access.count` | Sum (cumulative, non-monotonic) | `{accesses}` | collection, db.namespace | - |
| `mongodb.index.count` | Sum (cumulative, non-monotonic) | `{indexes}` | db.namespace | - |
| `mongodb.index.size` | Sum (cumulative, non-monotonic) | `By` | db.namespace | - |
| `mongodb.inserts.rate` | Gauge | `{insert}/s` | - | Disabled by default; enable with `metrics.mongodb.inserts.rate.enabled`. |
| `mongodb.lock.acquire.count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.count.enabled`. |
| `mongodb.lock.acquire.time` | Sum (cumulative, monotonic) | `microseconds` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.time.enabled`. |
| `mongodb.lock.acquire.wait_count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.wait_count.enabled`. |
| `mongodb.lock.deadlock.count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.deadlock.count.enabled`. |
| `mongodb.memory.usage` | Sum (cumulative, non-monotonic) | `By` | type, db.namespace | - |
| `mongodb.network.io.receive` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `mongodb.network.io.transmit` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `mongodb.network.request.count` | Sum (cumulative, non-monotonic) | `{requests}` | - | - |
| `mongodb.object.count` | Sum (cumulative, non-monotonic) | `{objects}` | db.namespace | - |
| `mongodb.operation.count` | Sum (cumulative, monotonic) | `{operations}` | operation | - |
| `mongodb.operation.latency.time` | Gauge | `us` | operation | Disabled by default; enable with `metrics.mongodb.operation.latency.time.enabled`. |
| `mongodb.operation.repl.count` | Sum (cumulative, monotonic) | `{operations}` | operation | Disabled by default; enable with `metrics.mongodb.operation.repl.count.enabled`. |
| `mongodb.operation.time` | Sum (cumulative, monotonic) | `ms` | operation | - |
| `mongodb.page_faults` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.mongodb.page_faults.enabled`. |
| `mongodb.queries.rate` | Gauge | `{query}/s` | - | Disabled by default; enable with `metrics.mongodb.queries.rate.enabled`. |
| `mongodb.repl_commands_per_sec` | Gauge | `{command}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_commands_per_sec.enabled`. |
| `mongodb.repl_deletes_per_sec` | Gauge | `{delete}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_deletes_per_sec.enabled`. |
| `mongodb.repl_getmores_per_sec` | Gauge | `{getmore}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_getmores_per_sec.enabled`. |
| `mongodb.repl_inserts_per_sec` | Gauge | `{insert}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_inserts_per_sec.enabled`. |
| `mongodb.repl_queries_per_sec` | Gauge | `{query}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_queries_per_sec.enabled`. |
| `mongodb.repl_updates_per_sec` | Gauge | `{update}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_updates_per_sec.enabled`. |
| `mongodb.session.count` | Sum (cumulative, non-monotonic) | `{sessions}` | - | - |
| `mongodb.storage.size` | Sum (cumulative, monotonic) | `By` | db.namespace | - |
| `mongodb.updates.rate` | Gauge | `{update}/s` | - | Disabled by default; enable with `metrics.mongodb.updates.rate.enabled`. |
| `mongodb.uptime` | Sum (cumulative, monotonic) | `ms` | - | Disabled by default; enable with `metrics.mongodb.uptime.enabled`. |
| `mongodb.wtcache.bytes.read` | Sum (cumulative, monotonic) | `By` | - | Disabled by default; enable with `metrics.mongodb.wtcache.bytes.read.enabled`. |

## Sources

- `receiver/mongodbreceiver/metadata.yaml`
- `receiver/mongodbreceiver/scraper.go`
- `receiver/mongodbreceiver/metrics.go`
        • v0.156.0.md 7.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/mongodbreceiver
version: v0.156.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/mongodbreceiver
commit_sha: 41e24cd516dd69a5b4277465cdb2ff4ef0676f49
last_verified: 2026-08-11
---

# MongoDB Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `mongodb.active.reads` | Sum (cumulative, non-monotonic) | `{reads}` | - | Disabled by default; enable with `metrics.mongodb.active.reads.enabled`. |
| `mongodb.active.writes` | Sum (cumulative, non-monotonic) | `{writes}` | - | Disabled by default; enable with `metrics.mongodb.active.writes.enabled`. |
| `mongodb.cache.operations` | Sum (cumulative, monotonic) | `{operations}` | type | - |
| `mongodb.collection.count` | Sum (cumulative, non-monotonic) | `{collections}` | db.namespace | - |
| `mongodb.commands.rate` | Gauge | `{command}/s` | - | Disabled by default; enable with `metrics.mongodb.commands.rate.enabled`. |
| `mongodb.connection.count` | Sum (cumulative, non-monotonic) | `{connections}` | type, db.namespace | - |
| `mongodb.cursor.count` | Sum (cumulative, non-monotonic) | `{cursors}` | - | - |
| `mongodb.cursor.timeout.count` | Sum (cumulative, non-monotonic) | `{cursors}` | - | - |
| `mongodb.data.size` | Sum (cumulative, non-monotonic) | `By` | db.namespace | - |
| `mongodb.database.count` | Sum (cumulative, non-monotonic) | `{databases}` | - | - |
| `mongodb.deletes.rate` | Gauge | `{delete}/s` | - | Disabled by default; enable with `metrics.mongodb.deletes.rate.enabled`. |
| `mongodb.document.operation.count` | Sum (cumulative, non-monotonic) | `{documents}` | operation, db.namespace | - |
| `mongodb.extent.count` | Sum (cumulative, non-monotonic) | `{extents}` | db.namespace | - |
| `mongodb.flushes.rate` | Gauge | `{flush}/s` | - | Disabled by default; enable with `metrics.mongodb.flushes.rate.enabled`. |
| `mongodb.getmores.rate` | Gauge | `{getmore}/s` | - | Disabled by default; enable with `metrics.mongodb.getmores.rate.enabled`. |
| `mongodb.global_lock.time` | Sum (cumulative, monotonic) | `ms` | - | - |
| `mongodb.health` | Gauge | `1` | - | Disabled by default; enable with `metrics.mongodb.health.enabled`. |
| `mongodb.index.access.count` | Sum (cumulative, non-monotonic) | `{accesses}` | collection, db.namespace | - |
| `mongodb.index.count` | Sum (cumulative, non-monotonic) | `{indexes}` | db.namespace | - |
| `mongodb.index.size` | Sum (cumulative, non-monotonic) | `By` | db.namespace | - |
| `mongodb.inserts.rate` | Gauge | `{insert}/s` | - | Disabled by default; enable with `metrics.mongodb.inserts.rate.enabled`. |
| `mongodb.lock.acquire.count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.count.enabled`. |
| `mongodb.lock.acquire.time` | Sum (cumulative, monotonic) | `microseconds` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.time.enabled`. |
| `mongodb.lock.acquire.wait_count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.wait_count.enabled`. |
| `mongodb.lock.deadlock.count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.deadlock.count.enabled`. |
| `mongodb.memory.usage` | Sum (cumulative, non-monotonic) | `By` | type, db.namespace | - |
| `mongodb.network.io.receive` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `mongodb.network.io.transmit` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `mongodb.network.request.count` | Sum (cumulative, non-monotonic) | `{requests}` | - | - |
| `mongodb.object.count` | Sum (cumulative, non-monotonic) | `{objects}` | db.namespace | - |
| `mongodb.operation.count` | Sum (cumulative, monotonic) | `{operations}` | operation | - |
| `mongodb.operation.latency.time` | Gauge | `us` | operation | Disabled by default; enable with `metrics.mongodb.operation.latency.time.enabled`. |
| `mongodb.operation.repl.count` | Sum (cumulative, monotonic) | `{operations}` | operation | Disabled by default; enable with `metrics.mongodb.operation.repl.count.enabled`. |
| `mongodb.operation.time` | Sum (cumulative, monotonic) | `ms` | operation | - |
| `mongodb.page_faults` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.mongodb.page_faults.enabled`. |
| `mongodb.queries.rate` | Gauge | `{query}/s` | - | Disabled by default; enable with `metrics.mongodb.queries.rate.enabled`. |
| `mongodb.repl_commands_per_sec` | Gauge | `{command}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_commands_per_sec.enabled`. |
| `mongodb.repl_deletes_per_sec` | Gauge | `{delete}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_deletes_per_sec.enabled`. |
| `mongodb.repl_getmores_per_sec` | Gauge | `{getmore}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_getmores_per_sec.enabled`. |
| `mongodb.repl_inserts_per_sec` | Gauge | `{insert}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_inserts_per_sec.enabled`. |
| `mongodb.repl_queries_per_sec` | Gauge | `{query}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_queries_per_sec.enabled`. |
| `mongodb.repl_updates_per_sec` | Gauge | `{update}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_updates_per_sec.enabled`. |
| `mongodb.session.count` | Sum (cumulative, non-monotonic) | `{sessions}` | - | - |
| `mongodb.storage.size` | Sum (cumulative, monotonic) | `By` | db.namespace | - |
| `mongodb.updates.rate` | Gauge | `{update}/s` | - | Disabled by default; enable with `metrics.mongodb.updates.rate.enabled`. |
| `mongodb.uptime` | Sum (cumulative, monotonic) | `ms` | - | Disabled by default; enable with `metrics.mongodb.uptime.enabled`. |
| `mongodb.wtcache.bytes.read` | Sum (cumulative, monotonic) | `By` | - | Disabled by default; enable with `metrics.mongodb.wtcache.bytes.read.enabled`. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `db.server.query_sample` | client.address, client.port, db.system.name, db.namespace, db.collection.name, db.operation.name, db.query.text, mongodb.query.truncated, user.name, mongodb.client.app.name, mongodb.cursor.await_data, mongodb.cursor.id, mongodb.cursor.no_timeout, mongodb.cursor.originating_command, mongodb.cursor.returned_batches, mongodb.cursor.returned_documents, mongodb.cursor.tailable, mongodb.lsid.id, mongodb.operation.id, mongodb.operation.plan.summary, mongodb.query.framework, mongodb.operation.state, mongodb.operation.type, mongodb.operation.comment, mongodb.operation.duration, mongodb.operation.prepared_read_conflict.count, mongodb.operation.write_conflict.count, mongodb.operation.yield.count, mongodb.operation.wait.type, mongodb.operation.wait.details | Disabled by default; enable with `logs.events.db.server.query_sample.enabled`. |

## Sources

- `receiver/mongodbreceiver/metadata.yaml`
- `receiver/mongodbreceiver/scraper.go`
- `receiver/mongodbreceiver/metrics.go`
- `receiver/mongodbreceiver/internal/metadata/generated_metrics.go`
- `receiver/mongodbreceiver/internal/metadata/generated_logs.go`
        • v0.157.0.md 7.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/mongodbreceiver
version: v0.157.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/mongodbreceiver
commit_sha: 89e43555904cd97c2d36605347c5d5237b1bdc8c
last_verified: 2026-08-11
---

# MongoDB Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `mongodb.active.reads` | Sum (cumulative, non-monotonic) | `{reads}` | - | Disabled by default; enable with `metrics.mongodb.active.reads.enabled`. |
| `mongodb.active.writes` | Sum (cumulative, non-monotonic) | `{writes}` | - | Disabled by default; enable with `metrics.mongodb.active.writes.enabled`. |
| `mongodb.cache.operations` | Sum (cumulative, monotonic) | `{operations}` | type | - |
| `mongodb.collection.count` | Sum (cumulative, non-monotonic) | `{collections}` | db.namespace | - |
| `mongodb.commands.rate` | Gauge | `{command}/s` | - | Disabled by default; enable with `metrics.mongodb.commands.rate.enabled`. |
| `mongodb.connection.count` | Sum (cumulative, non-monotonic) | `{connections}` | type, db.namespace | - |
| `mongodb.cursor.count` | Sum (cumulative, non-monotonic) | `{cursors}` | - | - |
| `mongodb.cursor.timeout.count` | Sum (cumulative, non-monotonic) | `{cursors}` | - | - |
| `mongodb.data.size` | Sum (cumulative, non-monotonic) | `By` | db.namespace | - |
| `mongodb.database.count` | Sum (cumulative, non-monotonic) | `{databases}` | - | - |
| `mongodb.deletes.rate` | Gauge | `{delete}/s` | - | Disabled by default; enable with `metrics.mongodb.deletes.rate.enabled`. |
| `mongodb.document.operation.count` | Sum (cumulative, non-monotonic) | `{documents}` | operation, db.namespace | - |
| `mongodb.extent.count` | Sum (cumulative, non-monotonic) | `{extents}` | db.namespace | - |
| `mongodb.flushes.rate` | Gauge | `{flush}/s` | - | Disabled by default; enable with `metrics.mongodb.flushes.rate.enabled`. |
| `mongodb.getmores.rate` | Gauge | `{getmore}/s` | - | Disabled by default; enable with `metrics.mongodb.getmores.rate.enabled`. |
| `mongodb.global_lock.time` | Sum (cumulative, monotonic) | `ms` | - | - |
| `mongodb.health` | Gauge | `1` | - | Disabled by default; enable with `metrics.mongodb.health.enabled`. |
| `mongodb.index.access.count` | Sum (cumulative, non-monotonic) | `{accesses}` | collection, db.namespace | - |
| `mongodb.index.count` | Sum (cumulative, non-monotonic) | `{indexes}` | db.namespace | - |
| `mongodb.index.size` | Sum (cumulative, non-monotonic) | `By` | db.namespace | - |
| `mongodb.inserts.rate` | Gauge | `{insert}/s` | - | Disabled by default; enable with `metrics.mongodb.inserts.rate.enabled`. |
| `mongodb.lock.acquire.count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.count.enabled`. |
| `mongodb.lock.acquire.time` | Sum (cumulative, monotonic) | `us` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.time.enabled`. |
| `mongodb.lock.acquire.wait_count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.wait_count.enabled`. |
| `mongodb.lock.deadlock.count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.deadlock.count.enabled`. |
| `mongodb.memory.usage` | Sum (cumulative, non-monotonic) | `By` | type, db.namespace | - |
| `mongodb.network.io.receive` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `mongodb.network.io.transmit` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `mongodb.network.request.count` | Sum (cumulative, non-monotonic) | `{requests}` | - | - |
| `mongodb.object.count` | Sum (cumulative, non-monotonic) | `{objects}` | db.namespace | - |
| `mongodb.operation.count` | Sum (cumulative, monotonic) | `{operations}` | operation | - |
| `mongodb.operation.latency.time` | Gauge | `us` | operation | Disabled by default; enable with `metrics.mongodb.operation.latency.time.enabled`. |
| `mongodb.operation.repl.count` | Sum (cumulative, monotonic) | `{operations}` | operation | Disabled by default; enable with `metrics.mongodb.operation.repl.count.enabled`. |
| `mongodb.operation.time` | Sum (cumulative, monotonic) | `ms` | operation | - |
| `mongodb.page_faults` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.mongodb.page_faults.enabled`. |
| `mongodb.queries.rate` | Gauge | `{query}/s` | - | Disabled by default; enable with `metrics.mongodb.queries.rate.enabled`. |
| `mongodb.repl_commands_per_sec` | Gauge | `{command}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_commands_per_sec.enabled`. |
| `mongodb.repl_deletes_per_sec` | Gauge | `{delete}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_deletes_per_sec.enabled`. |
| `mongodb.repl_getmores_per_sec` | Gauge | `{getmore}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_getmores_per_sec.enabled`. |
| `mongodb.repl_inserts_per_sec` | Gauge | `{insert}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_inserts_per_sec.enabled`. |
| `mongodb.repl_queries_per_sec` | Gauge | `{query}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_queries_per_sec.enabled`. |
| `mongodb.repl_updates_per_sec` | Gauge | `{update}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_updates_per_sec.enabled`. |
| `mongodb.session.count` | Sum (cumulative, non-monotonic) | `{sessions}` | - | - |
| `mongodb.storage.size` | Sum (cumulative, monotonic) | `By` | db.namespace | - |
| `mongodb.updates.rate` | Gauge | `{update}/s` | - | Disabled by default; enable with `metrics.mongodb.updates.rate.enabled`. |
| `mongodb.uptime` | Sum (cumulative, monotonic) | `ms` | - | Disabled by default; enable with `metrics.mongodb.uptime.enabled`. |
| `mongodb.wtcache.bytes.read` | Sum (cumulative, monotonic) | `By` | - | Disabled by default; enable with `metrics.mongodb.wtcache.bytes.read.enabled`. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `db.server.query_sample` | client.address, client.port, db.system.name, db.namespace, db.collection.name, db.operation.name, db.query.text, mongodb.query.truncated, user.name, mongodb.client.app.name, mongodb.cursor.await_data, mongodb.cursor.id, mongodb.cursor.no_timeout, mongodb.cursor.originating_command, mongodb.cursor.returned_batches, mongodb.cursor.returned_documents, mongodb.cursor.tailable, mongodb.lsid.id, mongodb.operation.id, mongodb.operation.plan.summary, mongodb.query.framework, mongodb.operation.state, mongodb.operation.type, mongodb.operation.comment, mongodb.operation.duration, mongodb.operation.prepared_read_conflict.count, mongodb.operation.write_conflict.count, mongodb.operation.yield.count, mongodb.operation.wait.type, mongodb.operation.wait.details | Disabled by default; enable with `logs.events.db.server.query_sample.enabled`. |

## Sources

- `receiver/mongodbreceiver/metadata.yaml`
- `receiver/mongodbreceiver/scraper.go`
- `receiver/mongodbreceiver/metrics.go`
- `receiver/mongodbreceiver/internal/metadata/generated_metrics.go`
- `receiver/mongodbreceiver/internal/metadata/generated_logs.go`
        • v0.158.0.md 7.8 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/mongodbreceiver
version: v0.158.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/mongodbreceiver
commit_sha: 821a9d9c2c1623c4a0ceba5d47b57c48879c3f84
last_verified: 2026-08-11
---

# MongoDB Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `mongodb.active.reads` | Sum (cumulative, non-monotonic) | `{reads}` | - | Disabled by default; enable with `metrics.mongodb.active.reads.enabled`. |
| `mongodb.active.writes` | Sum (cumulative, non-monotonic) | `{writes}` | - | Disabled by default; enable with `metrics.mongodb.active.writes.enabled`. |
| `mongodb.cache.operations` | Sum (cumulative, monotonic) | `{operations}` | type | - |
| `mongodb.collection.count` | Sum (cumulative, non-monotonic) | `{collections}` | db.namespace | - |
| `mongodb.commands.rate` | Gauge | `{command}/s` | - | Disabled by default; enable with `metrics.mongodb.commands.rate.enabled`. |
| `mongodb.connection.count` | Sum (cumulative, non-monotonic) | `{connections}` | type, db.namespace | - |
| `mongodb.cursor.count` | Sum (cumulative, non-monotonic) | `{cursors}` | - | - |
| `mongodb.cursor.timeout.count` | Sum (cumulative, non-monotonic) | `{cursors}` | - | - |
| `mongodb.data.size` | Sum (cumulative, non-monotonic) | `By` | db.namespace | - |
| `mongodb.database.count` | Sum (cumulative, non-monotonic) | `{databases}` | - | - |
| `mongodb.deletes.rate` | Gauge | `{delete}/s` | - | Disabled by default; enable with `metrics.mongodb.deletes.rate.enabled`. |
| `mongodb.document.operation.count` | Sum (cumulative, non-monotonic) | `{documents}` | operation, db.namespace | - |
| `mongodb.extent.count` | Sum (cumulative, non-monotonic) | `{extents}` | db.namespace | - |
| `mongodb.flushes.rate` | Gauge | `{flush}/s` | - | Disabled by default; enable with `metrics.mongodb.flushes.rate.enabled`. |
| `mongodb.getmores.rate` | Gauge | `{getmore}/s` | - | Disabled by default; enable with `metrics.mongodb.getmores.rate.enabled`. |
| `mongodb.global_lock.time` | Sum (cumulative, monotonic) | `ms` | - | - |
| `mongodb.health` | Gauge | `1` | - | Disabled by default; enable with `metrics.mongodb.health.enabled`. |
| `mongodb.index.access.count` | Sum (cumulative, non-monotonic) | `{accesses}` | collection, db.namespace | - |
| `mongodb.index.count` | Sum (cumulative, non-monotonic) | `{indexes}` | db.namespace | - |
| `mongodb.index.size` | Sum (cumulative, non-monotonic) | `By` | db.namespace | - |
| `mongodb.inserts.rate` | Gauge | `{insert}/s` | - | Disabled by default; enable with `metrics.mongodb.inserts.rate.enabled`. |
| `mongodb.lock.acquire.count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.count.enabled`. |
| `mongodb.lock.acquire.time` | Sum (cumulative, monotonic) | `us` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.time.enabled`. |
| `mongodb.lock.acquire.wait_count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.wait_count.enabled`. |
| `mongodb.lock.deadlock.count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.deadlock.count.enabled`. |
| `mongodb.memory.usage` | Sum (cumulative, non-monotonic) | `By` | type, db.namespace | - |
| `mongodb.network.io.receive` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `mongodb.network.io.transmit` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `mongodb.network.request.count` | Sum (cumulative, non-monotonic) | `{requests}` | - | - |
| `mongodb.object.count` | Sum (cumulative, non-monotonic) | `{objects}` | db.namespace | - |
| `mongodb.operation.count` | Sum (cumulative, monotonic) | `{operations}` | operation | - |
| `mongodb.operation.latency.time` | Gauge | `us` | operation | Disabled by default; enable with `metrics.mongodb.operation.latency.time.enabled`. |
| `mongodb.operation.repl.count` | Sum (cumulative, monotonic) | `{operations}` | operation | Disabled by default; enable with `metrics.mongodb.operation.repl.count.enabled`. |
| `mongodb.operation.time` | Sum (cumulative, monotonic) | `ms` | operation | - |
| `mongodb.page_faults` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.mongodb.page_faults.enabled`. |
| `mongodb.queries.rate` | Gauge | `{query}/s` | - | Disabled by default; enable with `metrics.mongodb.queries.rate.enabled`. |
| `mongodb.repl_commands_per_sec` | Gauge | `{command}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_commands_per_sec.enabled`. |
| `mongodb.repl_deletes_per_sec` | Gauge | `{delete}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_deletes_per_sec.enabled`. |
| `mongodb.repl_getmores_per_sec` | Gauge | `{getmore}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_getmores_per_sec.enabled`. |
| `mongodb.repl_inserts_per_sec` | Gauge | `{insert}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_inserts_per_sec.enabled`. |
| `mongodb.repl_queries_per_sec` | Gauge | `{query}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_queries_per_sec.enabled`. |
| `mongodb.repl_updates_per_sec` | Gauge | `{update}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_updates_per_sec.enabled`. |
| `mongodb.session.count` | Sum (cumulative, non-monotonic) | `{sessions}` | - | - |
| `mongodb.storage.size` | Sum (cumulative, monotonic) | `By` | db.namespace | - |
| `mongodb.updates.rate` | Gauge | `{update}/s` | - | Disabled by default; enable with `metrics.mongodb.updates.rate.enabled`. |
| `mongodb.uptime` | Sum (cumulative, monotonic) | `ms` | - | Disabled by default; enable with `metrics.mongodb.uptime.enabled`. |
| `mongodb.wtcache.bytes.read` | Sum (cumulative, monotonic) | `By` | - | Disabled by default; enable with `metrics.mongodb.wtcache.bytes.read.enabled`. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `db.server.query_sample` | client.address, client.port, db.system.name, db.namespace, db.collection.name, db.operation.name, db.query.text, mongodb.query.truncated, user.name, mongodb.client.app.name, mongodb.cursor.await_data, mongodb.cursor.id, mongodb.cursor.no_timeout, mongodb.cursor.originating_command, mongodb.cursor.returned_batches, mongodb.cursor.returned_documents, mongodb.cursor.tailable, mongodb.lsid.id, mongodb.operation.id, mongodb.operation.plan.summary, mongodb.query.framework, mongodb.operation.state, mongodb.operation.type, mongodb.operation.comment, mongodb.operation.duration, mongodb.operation.prepared_read_conflict.count, mongodb.operation.write_conflict.count, mongodb.operation.yield.count, mongodb.operation.wait.type, mongodb.operation.wait.details | Disabled by default; enable with `logs.events.db.server.query_sample.enabled`. |
| `db.server.top_query` | db.collection.name, db.namespace, db.operation.name, db.query.text, db.system.name, mongodb.cursor.id, mongodb.cursor.originating_command, mongodb.explain_plan.hash, mongodb.explain_plan.text, mongodb.operation.comment, mongodb.operation.cpu.time, mongodb.operation.docs_examined, mongodb.operation.docs_returned, mongodb.operation.duration, mongodb.operation.keys_examined, mongodb.operation.plan.summary, mongodb.operation.response_length, mongodb.operation.type, mongodb.query.truncated | Disabled by default; enable with `logs.events.db.server.top_query.enabled`. |

## Sources

- `receiver/mongodbreceiver/metadata.yaml`
- `receiver/mongodbreceiver/scraper.go`
- `receiver/mongodbreceiver/metrics.go`
- `receiver/mongodbreceiver/top_query_scraper.go`
- `receiver/mongodbreceiver/top_query_utils.go`
- `receiver/mongodbreceiver/internal/metadata/generated_metrics.go`
- `receiver/mongodbreceiver/internal/metadata/generated_logs.go`
        • v0.159.0.md 10.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/mongodbreceiver
version: v0.159.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/mongodbreceiver
commit_sha: 1120cc0714bf4d14600105e5673c3b00fe87467a
last_verified: 2026-10-03
---

# MongoDB Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `mongodb.active.reads` | Sum (cumulative, non-monotonic) | `{reads}` | - | Disabled by default; enable with `metrics.mongodb.active.reads.enabled`. |
| `mongodb.active.writes` | Sum (cumulative, non-monotonic) | `{writes}` | - | Disabled by default; enable with `metrics.mongodb.active.writes.enabled`. |
| `mongodb.cache.operations` | Sum (cumulative, monotonic) | `{operations}` | type | - |
| `mongodb.collection.count` | Sum (cumulative, non-monotonic) | `{collections}` | db.namespace | - |
| `mongodb.commands.rate` | Gauge | `{command}/s` | - | Disabled by default; enable with `metrics.mongodb.commands.rate.enabled`. |
| `mongodb.connection.count` | Sum (cumulative, non-monotonic) | `{connections}` | type, db.namespace | - |
| `mongodb.cursor.count` | Sum (cumulative, non-monotonic) | `{cursors}` | - | - |
| `mongodb.cursor.timeout.count` | Sum (cumulative, non-monotonic) | `{cursors}` | - | - |
| `mongodb.data.size` | Sum (cumulative, non-monotonic) | `By` | db.namespace | - |
| `mongodb.database.count` | Sum (cumulative, non-monotonic) | `{databases}` | - | - |
| `mongodb.deletes.rate` | Gauge | `{delete}/s` | - | Disabled by default; enable with `metrics.mongodb.deletes.rate.enabled`. |
| `mongodb.document.operation.count` | Sum (cumulative, non-monotonic) | `{documents}` | operation, db.namespace | - |
| `mongodb.extent.count` | Sum (cumulative, non-monotonic) | `{extents}` | db.namespace | - |
| `mongodb.flushes.rate` | Gauge | `{flush}/s` | - | Disabled by default; enable with `metrics.mongodb.flushes.rate.enabled`. |
| `mongodb.getmores.rate` | Gauge | `{getmore}/s` | - | Disabled by default; enable with `metrics.mongodb.getmores.rate.enabled`. |
| `mongodb.global_lock.time` | Sum (cumulative, monotonic) | `ms` | - | - |
| `mongodb.health` | Gauge | `1` | - | Disabled by default; enable with `metrics.mongodb.health.enabled`. |
| `mongodb.index.access.count` | Sum (cumulative, non-monotonic) | `{accesses}` | collection, db.namespace | - |
| `mongodb.index.count` | Sum (cumulative, non-monotonic) | `{indexes}` | db.namespace | - |
| `mongodb.index.size` | Sum (cumulative, non-monotonic) | `By` | db.namespace | - |
| `mongodb.inserts.rate` | Gauge | `{insert}/s` | - | Disabled by default; enable with `metrics.mongodb.inserts.rate.enabled`. |
| `mongodb.lock.acquire.count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.count.enabled`. |
| `mongodb.lock.acquire.time` | Sum (cumulative, monotonic) | `us` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.time.enabled`. |
| `mongodb.lock.acquire.wait_count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.wait_count.enabled`. |
| `mongodb.lock.deadlock.count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.deadlock.count.enabled`. |
| `mongodb.memory.usage` | Sum (cumulative, non-monotonic) | `By` | type, db.namespace | - |
| `mongodb.network.io.receive` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `mongodb.network.io.transmit` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `mongodb.network.request.count` | Sum (cumulative, non-monotonic) | `{requests}` | - | - |
| `mongodb.object.count` | Sum (cumulative, non-monotonic) | `{objects}` | db.namespace | - |
| `mongodb.operation.count` | Sum (cumulative, monotonic) | `{operations}` | operation | - |
| `mongodb.operation.latency.time` | Gauge | `us` | operation | Disabled by default; enable with `metrics.mongodb.operation.latency.time.enabled`. |
| `mongodb.operation.repl.count` | Sum (cumulative, monotonic) | `{operations}` | operation | Disabled by default; enable with `metrics.mongodb.operation.repl.count.enabled`. |
| `mongodb.operation.time` | Sum (cumulative, monotonic) | `ms` | operation | - |
| `mongodb.oplog.limit` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.mongodb.oplog.limit.enabled`. Only emitted by a `mongod` replica set member (skipped on standalone, `mongos`, or an uninitiated replica set); requires the `clusterMonitor` role. |
| `mongodb.oplog.usage` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.mongodb.oplog.usage.enabled`. Only emitted by a `mongod` replica set member (skipped on standalone, `mongos`, or an uninitiated replica set); requires the `clusterMonitor` role. |
| `mongodb.oplog.window` | Gauge | `s` | - | Disabled by default; enable with `metrics.mongodb.oplog.window.enabled`. Only emitted by a `mongod` replica set member (skipped on standalone, `mongos`, or an uninitiated replica set); requires the `clusterMonitor` role. |
| `mongodb.page_faults` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.mongodb.page_faults.enabled`. |
| `mongodb.queries.rate` | Gauge | `{query}/s` | - | Disabled by default; enable with `metrics.mongodb.queries.rate.enabled`. |
| `mongodb.repl_commands_per_sec` | Gauge | `{command}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_commands_per_sec.enabled`. |
| `mongodb.repl_deletes_per_sec` | Gauge | `{delete}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_deletes_per_sec.enabled`. |
| `mongodb.repl_getmores_per_sec` | Gauge | `{getmore}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_getmores_per_sec.enabled`. |
| `mongodb.repl_inserts_per_sec` | Gauge | `{insert}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_inserts_per_sec.enabled`. |
| `mongodb.repl_queries_per_sec` | Gauge | `{query}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_queries_per_sec.enabled`. |
| `mongodb.repl_updates_per_sec` | Gauge | `{update}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_updates_per_sec.enabled`. |
| `mongodb.replica.status` | Sum (cumulative, non-monotonic) | `1` | mongodb.replica.state | Disabled by default; enable with `metrics.mongodb.replica.status.enabled`. One series per possible state: 1 for the current state of the scraped member, 0 otherwise. Only emitted by a `mongod` replica set member (skipped on standalone, `mongos`, or an uninitiated replica set); requires the `clusterMonitor` role. |
| `mongodb.replica_set.headroom` | Gauge | `s` | mongodb.replica.name | Disabled by default; enable with `metrics.mongodb.replica_set.headroom.enabled`. Only emitted by a `mongod` replica set member (skipped on standalone, `mongos`, or an uninitiated replica set); requires the `clusterMonitor` role. Only emitted when the scraped member is the primary. |
| `mongodb.replica_set.lag` | Gauge | `s` | mongodb.replica.name, mongodb.replica_set.lag.type | Disabled by default; enable with `metrics.mongodb.replica_set.lag.enabled`. Only emitted by a `mongod` replica set member (skipped on standalone, `mongos`, or an uninitiated replica set); requires the `clusterMonitor` role. Only emitted when the scraped member is the primary. |
| `mongodb.replica_set.member.count` | Sum (cumulative, non-monotonic) | `{member}` | mongodb.replica.state | Disabled by default; enable with `metrics.mongodb.replica_set.member.count.enabled`. Only emitted by a `mongod` replica set member (skipped on standalone, `mongos`, or an uninitiated replica set); requires the `clusterMonitor` role. Describes the whole replica set, so every member reports the same value; do not sum across members. |
| `mongodb.session.count` | Sum (cumulative, non-monotonic) | `{sessions}` | - | - |
| `mongodb.storage.size` | Sum (cumulative, monotonic) | `By` | db.namespace | - |
| `mongodb.updates.rate` | Gauge | `{update}/s` | - | Disabled by default; enable with `metrics.mongodb.updates.rate.enabled`. |
| `mongodb.uptime` | Sum (cumulative, monotonic) | `ms` | - | Disabled by default; enable with `metrics.mongodb.uptime.enabled`. |
| `mongodb.wt.concurrent_transaction.ticket.in_use` | Sum (cumulative, non-monotonic) | `{ticket}` | `mongodb.wt.concurrent_transaction.ticket.type` | Disabled by default. |
| `mongodb.wt.fsync.count` | Sum (cumulative, monotonic) | `{fsync}` | - | Disabled by default. |
| `mongodb.wt.log.operation.count` | Sum (cumulative, monotonic) | `{operation}` | `mongodb.wt.log.operation.type` | Disabled by default. |
| `mongodb.wt.log.sync.time` | Sum (cumulative, monotonic) | `s` | - | Disabled by default. |
| `mongodb.wt.log.write` | Sum (cumulative, monotonic) | `By` | - | Disabled by default. |
| `mongodb.wtcache.bytes.read` | Sum (cumulative, monotonic) | `By` | - | Disabled by default; enable with `metrics.mongodb.wtcache.bytes.read.enabled`. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `db.server.query_sample` | client.address, client.port, db.system.name, db.namespace, db.collection.name, db.operation.name, db.query.text, mongodb.query.truncated, user.name, mongodb.client.app.name, mongodb.cursor.await_data, mongodb.cursor.id, mongodb.cursor.no_timeout, mongodb.cursor.originating_command, mongodb.cursor.returned_batches, mongodb.cursor.returned_documents, mongodb.cursor.tailable, mongodb.lsid.id, mongodb.operation.id, mongodb.operation.plan.summary, mongodb.query.framework, mongodb.operation.state, mongodb.operation.type, mongodb.operation.comment, mongodb.operation.duration, mongodb.operation.prepared_read_conflict.count, mongodb.operation.write_conflict.count, mongodb.operation.yield.count, mongodb.operation.wait.type, mongodb.operation.wait.details | Disabled by default; enable with `events.db.server.query_sample.enabled`. |
| `db.server.top_query` | db.collection.name, db.namespace, db.operation.name, db.query.text, db.system.name, mongodb.cursor.id, mongodb.cursor.originating_command, mongodb.explain_plan.hash, mongodb.explain_plan.text, mongodb.operation.comment, mongodb.operation.cpu.time, mongodb.operation.docs_examined, mongodb.operation.docs_returned, mongodb.operation.duration, mongodb.operation.keys_examined, mongodb.operation.plan.summary, mongodb.operation.response_length, mongodb.operation.type, mongodb.query.truncated | Disabled by default; enable with `events.db.server.top_query.enabled`. |

## Sources

- `receiver/mongodbreceiver/metadata.yaml`
- `receiver/mongodbreceiver/scraper.go`
- `receiver/mongodbreceiver/metrics.go`
- `receiver/mongodbreceiver/client.go`
- `receiver/mongodbreceiver/README.md`
- `receiver/mongodbreceiver/top_query_scraper.go`
- `receiver/mongodbreceiver/top_query_utils.go`
- `receiver/mongodbreceiver/internal/metadata/generated_metrics.go`
- `receiver/mongodbreceiver/internal/metadata/generated_logs.go`
        • v0.160.0.md 8.4 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/mongodbreceiver
version: v0.160.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/mongodbreceiver
commit_sha: 982f20b8a8e8a2569fab3e27cf8b008e8a5080c1
last_verified: 2026-09-03
---

# MongoDB Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `mongodb.active.reads` | Sum (cumulative, non-monotonic) | `{reads}` | - | Disabled by default; enable with `metrics.mongodb.active.reads.enabled`. |
| `mongodb.active.writes` | Sum (cumulative, non-monotonic) | `{writes}` | - | Disabled by default; enable with `metrics.mongodb.active.writes.enabled`. |
| `mongodb.cache.operations` | Sum (cumulative, monotonic) | `{operations}` | type | - |
| `mongodb.collection.count` | Sum (cumulative, non-monotonic) | `{collections}` | db.namespace | - |
| `mongodb.commands.rate` | Gauge | `{command}/s` | - | Disabled by default; enable with `metrics.mongodb.commands.rate.enabled`. |
| `mongodb.connection.count` | Sum (cumulative, non-monotonic) | `{connections}` | type, db.namespace | - |
| `mongodb.cursor.count` | Sum (cumulative, non-monotonic) | `{cursors}` | - | - |
| `mongodb.cursor.timeout.count` | Sum (cumulative, non-monotonic) | `{cursors}` | - | - |
| `mongodb.data.size` | Sum (cumulative, non-monotonic) | `By` | db.namespace | - |
| `mongodb.database.count` | Sum (cumulative, non-monotonic) | `{databases}` | - | - |
| `mongodb.deletes.rate` | Gauge | `{delete}/s` | - | Disabled by default; enable with `metrics.mongodb.deletes.rate.enabled`. |
| `mongodb.document.operation.count` | Sum (cumulative, non-monotonic) | `{documents}` | operation, db.namespace | - |
| `mongodb.extent.count` | Sum (cumulative, non-monotonic) | `{extents}` | db.namespace | - |
| `mongodb.flushes.rate` | Gauge | `{flush}/s` | - | Disabled by default; enable with `metrics.mongodb.flushes.rate.enabled`. |
| `mongodb.getmores.rate` | Gauge | `{getmore}/s` | - | Disabled by default; enable with `metrics.mongodb.getmores.rate.enabled`. |
| `mongodb.global_lock.time` | Sum (cumulative, monotonic) | `ms` | - | - |
| `mongodb.health` | Gauge | `1` | - | Disabled by default; enable with `metrics.mongodb.health.enabled`. |
| `mongodb.index.access.count` | Sum (cumulative, non-monotonic) | `{accesses}` | collection, db.namespace | - |
| `mongodb.index.count` | Sum (cumulative, non-monotonic) | `{indexes}` | db.namespace | - |
| `mongodb.index.size` | Sum (cumulative, non-monotonic) | `By` | db.namespace | - |
| `mongodb.inserts.rate` | Gauge | `{insert}/s` | - | Disabled by default; enable with `metrics.mongodb.inserts.rate.enabled`. |
| `mongodb.lock.acquire.count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.count.enabled`. |
| `mongodb.lock.acquire.time` | Sum (cumulative, monotonic) | `us` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.time.enabled`. |
| `mongodb.lock.acquire.wait_count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.wait_count.enabled`. |
| `mongodb.lock.deadlock.count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.deadlock.count.enabled`. |
| `mongodb.memory.usage` | Sum (cumulative, non-monotonic) | `By` | type, db.namespace | - |
| `mongodb.network.io.receive` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `mongodb.network.io.transmit` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `mongodb.network.request.count` | Sum (cumulative, non-monotonic) | `{requests}` | - | - |
| `mongodb.object.count` | Sum (cumulative, non-monotonic) | `{objects}` | db.namespace | - |
| `mongodb.operation.count` | Sum (cumulative, monotonic) | `{operations}` | operation | - |
| `mongodb.operation.latency.time` | Gauge | `us` | operation | Disabled by default; enable with `metrics.mongodb.operation.latency.time.enabled`. |
| `mongodb.operation.repl.count` | Sum (cumulative, monotonic) | `{operations}` | operation | Disabled by default; enable with `metrics.mongodb.operation.repl.count.enabled`. |
| `mongodb.operation.time` | Sum (cumulative, monotonic) | `ms` | operation | - |
| `mongodb.page_faults` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.mongodb.page_faults.enabled`. |
| `mongodb.queries.rate` | Gauge | `{query}/s` | - | Disabled by default; enable with `metrics.mongodb.queries.rate.enabled`. |
| `mongodb.repl_commands_per_sec` | Gauge | `{command}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_commands_per_sec.enabled`. |
| `mongodb.repl_deletes_per_sec` | Gauge | `{delete}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_deletes_per_sec.enabled`. |
| `mongodb.repl_getmores_per_sec` | Gauge | `{getmore}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_getmores_per_sec.enabled`. |
| `mongodb.repl_inserts_per_sec` | Gauge | `{insert}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_inserts_per_sec.enabled`. |
| `mongodb.repl_queries_per_sec` | Gauge | `{query}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_queries_per_sec.enabled`. |
| `mongodb.repl_updates_per_sec` | Gauge | `{update}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_updates_per_sec.enabled`. |
| `mongodb.session.count` | Sum (cumulative, non-monotonic) | `{sessions}` | - | - |
| `mongodb.storage.size` | Sum (cumulative, monotonic) | `By` | db.namespace | - |
| `mongodb.updates.rate` | Gauge | `{update}/s` | - | Disabled by default; enable with `metrics.mongodb.updates.rate.enabled`. |
| `mongodb.uptime` | Sum (cumulative, monotonic) | `ms` | - | Disabled by default; enable with `metrics.mongodb.uptime.enabled`. |
| `mongodb.wt.concurrent_transaction.ticket.in_use` | Sum (cumulative, non-monotonic) | `{ticket}` | `mongodb.wt.concurrent_transaction.ticket.type` | Disabled by default. |
| `mongodb.wt.fsync.count` | Sum (cumulative, monotonic) | `{fsync}` | - | Disabled by default. |
| `mongodb.wt.log.operation.count` | Sum (cumulative, monotonic) | `{operation}` | `mongodb.wt.log.operation.type` | Disabled by default. |
| `mongodb.wt.log.sync.time` | Sum (cumulative, monotonic) | `s` | - | Disabled by default. |
| `mongodb.wt.log.write` | Sum (cumulative, monotonic) | `By` | - | Disabled by default. |
| `mongodb.wtcache.bytes.read` | Sum (cumulative, monotonic) | `By` | - | Disabled by default; enable with `metrics.mongodb.wtcache.bytes.read.enabled`. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `db.server.query_sample` | client.address, client.port, db.system.name, db.namespace, db.collection.name, db.operation.name, db.query.text, mongodb.query.truncated, user.name, mongodb.client.app.name, mongodb.cursor.await_data, mongodb.cursor.id, mongodb.cursor.no_timeout, mongodb.cursor.originating_command, mongodb.cursor.returned_batches, mongodb.cursor.returned_documents, mongodb.cursor.tailable, mongodb.lsid.id, mongodb.operation.id, mongodb.operation.plan.summary, mongodb.query.framework, mongodb.operation.state, mongodb.operation.type, mongodb.operation.comment, mongodb.operation.duration, mongodb.operation.prepared_read_conflict.count, mongodb.operation.write_conflict.count, mongodb.operation.yield.count, mongodb.operation.wait.type, mongodb.operation.wait.details | Disabled by default; enable with `logs.events.db.server.query_sample.enabled`. |
| `db.server.top_query` | db.collection.name, db.namespace, db.operation.name, db.query.text, db.system.name, mongodb.cursor.id, mongodb.cursor.originating_command, mongodb.explain_plan.hash, mongodb.explain_plan.text, mongodb.operation.comment, mongodb.operation.cpu.time, mongodb.operation.docs_examined, mongodb.operation.docs_returned, mongodb.operation.duration, mongodb.operation.keys_examined, mongodb.operation.plan.summary, mongodb.operation.response_length, mongodb.operation.type, mongodb.query.truncated | Disabled by default; enable with `logs.events.db.server.top_query.enabled`. |

## Sources

- `receiver/mongodbreceiver/metadata.yaml`
- `receiver/mongodbreceiver/scraper.go`
- `receiver/mongodbreceiver/metrics.go`
- `receiver/mongodbreceiver/top_query_scraper.go`
- `receiver/mongodbreceiver/top_query_utils.go`
- `receiver/mongodbreceiver/internal/metadata/generated_metrics.go`
- `receiver/mongodbreceiver/internal/metadata/generated_logs.go`
        • v0.161.0.md 8.4 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/mongodbreceiver
version: v0.161.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/mongodbreceiver
commit_sha: 3f8455d8038a985398861171e5310bc9b4e988b2
last_verified: 2026-10-03
---

# MongoDB Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `mongodb.active.reads` | Sum (cumulative, non-monotonic) | `{reads}` | - | Disabled by default; enable with `metrics.mongodb.active.reads.enabled`. |
| `mongodb.active.writes` | Sum (cumulative, non-monotonic) | `{writes}` | - | Disabled by default; enable with `metrics.mongodb.active.writes.enabled`. |
| `mongodb.cache.operations` | Sum (cumulative, monotonic) | `{operations}` | type | - |
| `mongodb.collection.count` | Sum (cumulative, non-monotonic) | `{collections}` | db.namespace | - |
| `mongodb.commands.rate` | Gauge | `{command}/s` | - | Disabled by default; enable with `metrics.mongodb.commands.rate.enabled`. |
| `mongodb.connection.count` | Sum (cumulative, non-monotonic) | `{connections}` | type, db.namespace | - |
| `mongodb.cursor.count` | Sum (cumulative, non-monotonic) | `{cursors}` | - | - |
| `mongodb.cursor.timeout.count` | Sum (cumulative, non-monotonic) | `{cursors}` | - | - |
| `mongodb.data.size` | Sum (cumulative, non-monotonic) | `By` | db.namespace | - |
| `mongodb.database.count` | Sum (cumulative, non-monotonic) | `{databases}` | - | - |
| `mongodb.deletes.rate` | Gauge | `{delete}/s` | - | Disabled by default; enable with `metrics.mongodb.deletes.rate.enabled`. |
| `mongodb.document.operation.count` | Sum (cumulative, non-monotonic) | `{documents}` | operation, db.namespace | - |
| `mongodb.extent.count` | Sum (cumulative, non-monotonic) | `{extents}` | db.namespace | - |
| `mongodb.flushes.rate` | Gauge | `{flush}/s` | - | Disabled by default; enable with `metrics.mongodb.flushes.rate.enabled`. |
| `mongodb.getmores.rate` | Gauge | `{getmore}/s` | - | Disabled by default; enable with `metrics.mongodb.getmores.rate.enabled`. |
| `mongodb.global_lock.time` | Sum (cumulative, monotonic) | `ms` | - | - |
| `mongodb.health` | Gauge | `1` | - | Disabled by default; enable with `metrics.mongodb.health.enabled`. |
| `mongodb.index.access.count` | Sum (cumulative, non-monotonic) | `{accesses}` | collection, db.namespace | - |
| `mongodb.index.count` | Sum (cumulative, non-monotonic) | `{indexes}` | db.namespace | - |
| `mongodb.index.size` | Sum (cumulative, non-monotonic) | `By` | db.namespace | - |
| `mongodb.inserts.rate` | Gauge | `{insert}/s` | - | Disabled by default; enable with `metrics.mongodb.inserts.rate.enabled`. |
| `mongodb.lock.acquire.count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.count.enabled`. |
| `mongodb.lock.acquire.time` | Sum (cumulative, monotonic) | `us` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.time.enabled`. |
| `mongodb.lock.acquire.wait_count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.wait_count.enabled`. |
| `mongodb.lock.deadlock.count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.deadlock.count.enabled`. |
| `mongodb.memory.usage` | Sum (cumulative, non-monotonic) | `By` | type, db.namespace | - |
| `mongodb.network.io.receive` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `mongodb.network.io.transmit` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `mongodb.network.request.count` | Sum (cumulative, non-monotonic) | `{requests}` | - | - |
| `mongodb.object.count` | Sum (cumulative, non-monotonic) | `{objects}` | db.namespace | - |
| `mongodb.operation.count` | Sum (cumulative, monotonic) | `{operations}` | operation | - |
| `mongodb.operation.latency.time` | Gauge | `us` | operation | Disabled by default; enable with `metrics.mongodb.operation.latency.time.enabled`. |
| `mongodb.operation.repl.count` | Sum (cumulative, monotonic) | `{operations}` | operation | Disabled by default; enable with `metrics.mongodb.operation.repl.count.enabled`. |
| `mongodb.operation.time` | Sum (cumulative, monotonic) | `ms` | operation | - |
| `mongodb.page_faults` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.mongodb.page_faults.enabled`. |
| `mongodb.queries.rate` | Gauge | `{query}/s` | - | Disabled by default; enable with `metrics.mongodb.queries.rate.enabled`. |
| `mongodb.repl_commands_per_sec` | Gauge | `{command}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_commands_per_sec.enabled`. |
| `mongodb.repl_deletes_per_sec` | Gauge | `{delete}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_deletes_per_sec.enabled`. |
| `mongodb.repl_getmores_per_sec` | Gauge | `{getmore}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_getmores_per_sec.enabled`. |
| `mongodb.repl_inserts_per_sec` | Gauge | `{insert}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_inserts_per_sec.enabled`. |
| `mongodb.repl_queries_per_sec` | Gauge | `{query}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_queries_per_sec.enabled`. |
| `mongodb.repl_updates_per_sec` | Gauge | `{update}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_updates_per_sec.enabled`. |
| `mongodb.session.count` | Sum (cumulative, non-monotonic) | `{sessions}` | - | - |
| `mongodb.storage.size` | Sum (cumulative, monotonic) | `By` | db.namespace | - |
| `mongodb.updates.rate` | Gauge | `{update}/s` | - | Disabled by default; enable with `metrics.mongodb.updates.rate.enabled`. |
| `mongodb.uptime` | Sum (cumulative, monotonic) | `ms` | - | Disabled by default; enable with `metrics.mongodb.uptime.enabled`. |
| `mongodb.wt.concurrent_transaction.ticket.in_use` | Sum (cumulative, non-monotonic) | `{ticket}` | `mongodb.wt.concurrent_transaction.ticket.type` | Disabled by default. |
| `mongodb.wt.fsync.count` | Sum (cumulative, monotonic) | `{fsync}` | - | Disabled by default. |
| `mongodb.wt.log.operation.count` | Sum (cumulative, monotonic) | `{operation}` | `mongodb.wt.log.operation.type` | Disabled by default. |
| `mongodb.wt.log.sync.time` | Sum (cumulative, monotonic) | `s` | - | Disabled by default. |
| `mongodb.wt.log.write` | Sum (cumulative, monotonic) | `By` | - | Disabled by default. |
| `mongodb.wtcache.bytes.read` | Sum (cumulative, monotonic) | `By` | - | Disabled by default; enable with `metrics.mongodb.wtcache.bytes.read.enabled`. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `db.server.query_sample` | client.address, client.port, db.system.name, db.namespace, db.collection.name, db.operation.name, db.query.text, mongodb.query.truncated, user.name, mongodb.client.app.name, mongodb.cursor.await_data, mongodb.cursor.id, mongodb.cursor.no_timeout, mongodb.cursor.originating_command, mongodb.cursor.returned_batches, mongodb.cursor.returned_documents, mongodb.cursor.tailable, mongodb.lsid.id, mongodb.operation.id, mongodb.operation.plan.summary, mongodb.query.framework, mongodb.operation.state, mongodb.operation.type, mongodb.operation.comment, mongodb.operation.duration, mongodb.operation.prepared_read_conflict.count, mongodb.operation.write_conflict.count, mongodb.operation.yield.count, mongodb.operation.wait.type, mongodb.operation.wait.details | Disabled by default; enable with `events.db.server.query_sample.enabled`. |
| `db.server.top_query` | db.collection.name, db.namespace, db.operation.name, db.query.text, db.system.name, mongodb.cursor.id, mongodb.cursor.originating_command, mongodb.explain_plan.hash, mongodb.explain_plan.text, mongodb.operation.comment, mongodb.operation.cpu.time, mongodb.operation.docs_examined, mongodb.operation.docs_returned, mongodb.operation.duration, mongodb.operation.keys_examined, mongodb.operation.plan.summary, mongodb.operation.response_length, mongodb.operation.type, mongodb.query.truncated | Disabled by default; enable with `events.db.server.top_query.enabled`. |

## Sources

- `receiver/mongodbreceiver/metadata.yaml`
- `receiver/mongodbreceiver/scraper.go`
- `receiver/mongodbreceiver/metrics.go`
- `receiver/mongodbreceiver/top_query_scraper.go`
- `receiver/mongodbreceiver/top_query_utils.go`
- `receiver/mongodbreceiver/internal/metadata/generated_metrics.go`
- `receiver/mongodbreceiver/internal/metadata/generated_logs.go`
        • v0.162.0.md 10.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/mongodbreceiver
version: v0.162.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/mongodbreceiver
commit_sha: ae8c507510f48f433ab47dd1c6b01a59d6c388b5
last_verified: 2026-10-03
---

# MongoDB Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `mongodb.active.reads` | Sum (cumulative, non-monotonic) | `{reads}` | - | Disabled by default; enable with `metrics.mongodb.active.reads.enabled`. |
| `mongodb.active.writes` | Sum (cumulative, non-monotonic) | `{writes}` | - | Disabled by default; enable with `metrics.mongodb.active.writes.enabled`. |
| `mongodb.cache.operations` | Sum (cumulative, monotonic) | `{operations}` | type | - |
| `mongodb.collection.count` | Sum (cumulative, non-monotonic) | `{collections}` | db.namespace | - |
| `mongodb.commands.rate` | Gauge | `{command}/s` | - | Disabled by default; enable with `metrics.mongodb.commands.rate.enabled`. |
| `mongodb.connection.count` | Sum (cumulative, non-monotonic) | `{connections}` | type, db.namespace | - |
| `mongodb.cursor.count` | Sum (cumulative, non-monotonic) | `{cursors}` | - | - |
| `mongodb.cursor.timeout.count` | Sum (cumulative, non-monotonic) | `{cursors}` | - | - |
| `mongodb.data.size` | Sum (cumulative, non-monotonic) | `By` | db.namespace | - |
| `mongodb.database.count` | Sum (cumulative, non-monotonic) | `{databases}` | - | - |
| `mongodb.deletes.rate` | Gauge | `{delete}/s` | - | Disabled by default; enable with `metrics.mongodb.deletes.rate.enabled`. |
| `mongodb.document.operation.count` | Sum (cumulative, non-monotonic) | `{documents}` | operation, db.namespace | - |
| `mongodb.extent.count` | Sum (cumulative, non-monotonic) | `{extents}` | db.namespace | - |
| `mongodb.flushes.rate` | Gauge | `{flush}/s` | - | Disabled by default; enable with `metrics.mongodb.flushes.rate.enabled`. |
| `mongodb.getmores.rate` | Gauge | `{getmore}/s` | - | Disabled by default; enable with `metrics.mongodb.getmores.rate.enabled`. |
| `mongodb.global_lock.time` | Sum (cumulative, monotonic) | `ms` | - | - |
| `mongodb.health` | Gauge | `1` | - | Disabled by default; enable with `metrics.mongodb.health.enabled`. |
| `mongodb.index.access.count` | Sum (cumulative, non-monotonic) | `{accesses}` | collection, db.namespace | - |
| `mongodb.index.count` | Sum (cumulative, non-monotonic) | `{indexes}` | db.namespace | - |
| `mongodb.index.size` | Sum (cumulative, non-monotonic) | `By` | db.namespace | - |
| `mongodb.inserts.rate` | Gauge | `{insert}/s` | - | Disabled by default; enable with `metrics.mongodb.inserts.rate.enabled`. |
| `mongodb.lock.acquire.count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.count.enabled`. |
| `mongodb.lock.acquire.time` | Sum (cumulative, monotonic) | `us` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.time.enabled`. |
| `mongodb.lock.acquire.wait_count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.wait_count.enabled`. |
| `mongodb.lock.deadlock.count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.deadlock.count.enabled`. |
| `mongodb.memory.usage` | Sum (cumulative, non-monotonic) | `By` | type, db.namespace | - |
| `mongodb.network.io.receive` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `mongodb.network.io.transmit` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `mongodb.network.request.count` | Sum (cumulative, non-monotonic) | `{requests}` | - | - |
| `mongodb.object.count` | Sum (cumulative, non-monotonic) | `{objects}` | db.namespace | - |
| `mongodb.operation.count` | Sum (cumulative, monotonic) | `{operations}` | operation | - |
| `mongodb.operation.latency.time` | Gauge | `us` | operation | Disabled by default; enable with `metrics.mongodb.operation.latency.time.enabled`. |
| `mongodb.operation.repl.count` | Sum (cumulative, monotonic) | `{operations}` | operation | Disabled by default; enable with `metrics.mongodb.operation.repl.count.enabled`. |
| `mongodb.operation.time` | Sum (cumulative, monotonic) | `ms` | operation | - |
| `mongodb.oplog.limit` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.mongodb.oplog.limit.enabled`. Only emitted by a `mongod` replica set member (skipped on standalone, `mongos`, or an uninitiated replica set); requires the `clusterMonitor` role. |
| `mongodb.oplog.usage` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.mongodb.oplog.usage.enabled`. Only emitted by a `mongod` replica set member (skipped on standalone, `mongos`, or an uninitiated replica set); requires the `clusterMonitor` role. |
| `mongodb.oplog.window` | Gauge | `s` | - | Disabled by default; enable with `metrics.mongodb.oplog.window.enabled`. Only emitted by a `mongod` replica set member (skipped on standalone, `mongos`, or an uninitiated replica set); requires the `clusterMonitor` role. |
| `mongodb.page_faults` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.mongodb.page_faults.enabled`. |
| `mongodb.queries.rate` | Gauge | `{query}/s` | - | Disabled by default; enable with `metrics.mongodb.queries.rate.enabled`. |
| `mongodb.repl_commands_per_sec` | Gauge | `{command}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_commands_per_sec.enabled`. |
| `mongodb.repl_deletes_per_sec` | Gauge | `{delete}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_deletes_per_sec.enabled`. |
| `mongodb.repl_getmores_per_sec` | Gauge | `{getmore}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_getmores_per_sec.enabled`. |
| `mongodb.repl_inserts_per_sec` | Gauge | `{insert}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_inserts_per_sec.enabled`. |
| `mongodb.repl_queries_per_sec` | Gauge | `{query}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_queries_per_sec.enabled`. |
| `mongodb.repl_updates_per_sec` | Gauge | `{update}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_updates_per_sec.enabled`. |
| `mongodb.replica.status` | Sum (cumulative, non-monotonic) | `1` | mongodb.replica.state | Disabled by default; enable with `metrics.mongodb.replica.status.enabled`. One series per possible state: 1 for the current state of the scraped member, 0 otherwise. Only emitted by a `mongod` replica set member (skipped on standalone, `mongos`, or an uninitiated replica set); requires the `clusterMonitor` role. |
| `mongodb.replica_set.headroom` | Gauge | `s` | mongodb.replica.name | Disabled by default; enable with `metrics.mongodb.replica_set.headroom.enabled`. Only emitted by a `mongod` replica set member (skipped on standalone, `mongos`, or an uninitiated replica set); requires the `clusterMonitor` role. Only emitted when the scraped member is the primary. |
| `mongodb.replica_set.lag` | Gauge | `s` | mongodb.replica.name, mongodb.replica_set.lag.type | Disabled by default; enable with `metrics.mongodb.replica_set.lag.enabled`. Only emitted by a `mongod` replica set member (skipped on standalone, `mongos`, or an uninitiated replica set); requires the `clusterMonitor` role. Only emitted when the scraped member is the primary. |
| `mongodb.replica_set.member.count` | Sum (cumulative, non-monotonic) | `{member}` | mongodb.replica.state | Disabled by default; enable with `metrics.mongodb.replica_set.member.count.enabled`. Only emitted by a `mongod` replica set member (skipped on standalone, `mongos`, or an uninitiated replica set); requires the `clusterMonitor` role. Describes the whole replica set, so every member reports the same value; do not sum across members. |
| `mongodb.session.count` | Sum (cumulative, non-monotonic) | `{sessions}` | - | - |
| `mongodb.storage.size` | Sum (cumulative, monotonic) | `By` | db.namespace | - |
| `mongodb.updates.rate` | Gauge | `{update}/s` | - | Disabled by default; enable with `metrics.mongodb.updates.rate.enabled`. |
| `mongodb.uptime` | Sum (cumulative, monotonic) | `ms` | - | Disabled by default; enable with `metrics.mongodb.uptime.enabled`. |
| `mongodb.wt.concurrent_transaction.ticket.in_use` | Sum (cumulative, non-monotonic) | `{ticket}` | `mongodb.wt.concurrent_transaction.ticket.type` | Disabled by default. |
| `mongodb.wt.fsync.count` | Sum (cumulative, monotonic) | `{fsync}` | - | Disabled by default. |
| `mongodb.wt.log.operation.count` | Sum (cumulative, monotonic) | `{operation}` | `mongodb.wt.log.operation.type` | Disabled by default. |
| `mongodb.wt.log.sync.time` | Sum (cumulative, monotonic) | `s` | - | Disabled by default. |
| `mongodb.wt.log.write` | Sum (cumulative, monotonic) | `By` | - | Disabled by default. |
| `mongodb.wtcache.bytes.read` | Sum (cumulative, monotonic) | `By` | - | Disabled by default; enable with `metrics.mongodb.wtcache.bytes.read.enabled`. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `db.server.query_sample` | client.address, client.port, db.system.name, db.namespace, db.collection.name, db.operation.name, db.query.text, mongodb.query.truncated, user.name, mongodb.client.app.name, mongodb.cursor.await_data, mongodb.cursor.id, mongodb.cursor.no_timeout, mongodb.cursor.originating_command, mongodb.cursor.returned_batches, mongodb.cursor.returned_documents, mongodb.cursor.tailable, mongodb.lsid.id, mongodb.operation.id, mongodb.operation.plan.summary, mongodb.query.framework, mongodb.operation.state, mongodb.operation.type, mongodb.operation.comment, mongodb.operation.duration, mongodb.operation.prepared_read_conflict.count, mongodb.operation.write_conflict.count, mongodb.operation.yield.count, mongodb.operation.wait.type, mongodb.operation.wait.details | Disabled by default; enable with `events.db.server.query_sample.enabled`. |
| `db.server.top_query` | db.collection.name, db.namespace, db.operation.name, db.query.text, db.system.name, mongodb.cursor.id, mongodb.cursor.originating_command, mongodb.explain_plan.hash, mongodb.explain_plan.text, mongodb.operation.comment, mongodb.operation.cpu.time, mongodb.operation.docs_examined, mongodb.operation.docs_returned, mongodb.operation.duration, mongodb.operation.keys_examined, mongodb.operation.plan.summary, mongodb.operation.response_length, mongodb.operation.type, mongodb.query.truncated | Disabled by default; enable with `events.db.server.top_query.enabled`. |

## Sources

- `receiver/mongodbreceiver/metadata.yaml`
- `receiver/mongodbreceiver/scraper.go`
- `receiver/mongodbreceiver/metrics.go`
- `receiver/mongodbreceiver/client.go`
- `receiver/mongodbreceiver/README.md`
- `receiver/mongodbreceiver/top_query_scraper.go`
- `receiver/mongodbreceiver/top_query_utils.go`
- `receiver/mongodbreceiver/internal/metadata/generated_metrics.go`
- `receiver/mongodbreceiver/internal/metadata/generated_logs.go`
        • v0.163.0.md 10.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/mongodbreceiver
version: v0.163.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/mongodbreceiver
commit_sha: df849b5403c041d5e799e7846392a6f18b0b55ae
last_verified: null
---

# MongoDB Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `mongodb.active.reads` | Sum (cumulative, non-monotonic) | `{reads}` | - | Disabled by default; enable with `metrics.mongodb.active.reads.enabled`. |
| `mongodb.active.writes` | Sum (cumulative, non-monotonic) | `{writes}` | - | Disabled by default; enable with `metrics.mongodb.active.writes.enabled`. |
| `mongodb.cache.operations` | Sum (cumulative, monotonic) | `{operations}` | type | - |
| `mongodb.collection.count` | Sum (cumulative, non-monotonic) | `{collections}` | db.namespace | - |
| `mongodb.commands.rate` | Gauge | `{command}/s` | - | Disabled by default; enable with `metrics.mongodb.commands.rate.enabled`. |
| `mongodb.connection.count` | Sum (cumulative, non-monotonic) | `{connections}` | type, db.namespace | - |
| `mongodb.cursor.count` | Sum (cumulative, non-monotonic) | `{cursors}` | - | - |
| `mongodb.cursor.timeout.count` | Sum (cumulative, non-monotonic) | `{cursors}` | - | - |
| `mongodb.data.size` | Sum (cumulative, non-monotonic) | `By` | db.namespace | - |
| `mongodb.database.count` | Sum (cumulative, non-monotonic) | `{databases}` | - | - |
| `mongodb.deletes.rate` | Gauge | `{delete}/s` | - | Disabled by default; enable with `metrics.mongodb.deletes.rate.enabled`. |
| `mongodb.document.operation.count` | Sum (cumulative, non-monotonic) | `{documents}` | operation, db.namespace | - |
| `mongodb.extent.count` | Sum (cumulative, non-monotonic) | `{extents}` | db.namespace | - |
| `mongodb.flushes.rate` | Gauge | `{flush}/s` | - | Disabled by default; enable with `metrics.mongodb.flushes.rate.enabled`. |
| `mongodb.getmores.rate` | Gauge | `{getmore}/s` | - | Disabled by default; enable with `metrics.mongodb.getmores.rate.enabled`. |
| `mongodb.global_lock.time` | Sum (cumulative, monotonic) | `ms` | - | - |
| `mongodb.health` | Gauge | `1` | - | Disabled by default; enable with `metrics.mongodb.health.enabled`. |
| `mongodb.index.access.count` | Sum (cumulative, non-monotonic) | `{accesses}` | collection, db.namespace | - |
| `mongodb.index.count` | Sum (cumulative, non-monotonic) | `{indexes}` | db.namespace | - |
| `mongodb.index.size` | Sum (cumulative, non-monotonic) | `By` | db.namespace | - |
| `mongodb.inserts.rate` | Gauge | `{insert}/s` | - | Disabled by default; enable with `metrics.mongodb.inserts.rate.enabled`. |
| `mongodb.lock.acquire.count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.count.enabled`. |
| `mongodb.lock.acquire.time` | Sum (cumulative, monotonic) | `us` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.time.enabled`. |
| `mongodb.lock.acquire.wait_count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.acquire.wait_count.enabled`. |
| `mongodb.lock.deadlock.count` | Sum (cumulative, monotonic) | `{count}` | lock_type, lock_mode, db.namespace | Disabled by default; enable with `metrics.mongodb.lock.deadlock.count.enabled`. |
| `mongodb.memory.usage` | Sum (cumulative, non-monotonic) | `By` | type, db.namespace | - |
| `mongodb.network.io.receive` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `mongodb.network.io.transmit` | Sum (cumulative, non-monotonic) | `By` | - | - |
| `mongodb.network.request.count` | Sum (cumulative, non-monotonic) | `{requests}` | - | - |
| `mongodb.object.count` | Sum (cumulative, non-monotonic) | `{objects}` | db.namespace | - |
| `mongodb.operation.count` | Sum (cumulative, monotonic) | `{operations}` | operation | - |
| `mongodb.operation.latency.time` | Gauge | `us` | operation | Disabled by default; enable with `metrics.mongodb.operation.latency.time.enabled`. |
| `mongodb.operation.repl.count` | Sum (cumulative, monotonic) | `{operations}` | operation | Disabled by default; enable with `metrics.mongodb.operation.repl.count.enabled`. |
| `mongodb.operation.time` | Sum (cumulative, monotonic) | `ms` | operation | - |
| `mongodb.oplog.limit` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.mongodb.oplog.limit.enabled`. Only emitted by a `mongod` replica set member (skipped on standalone, `mongos`, or an uninitiated replica set); requires the `clusterMonitor` role. |
| `mongodb.oplog.usage` | Sum (cumulative, non-monotonic) | `By` | - | Disabled by default; enable with `metrics.mongodb.oplog.usage.enabled`. Only emitted by a `mongod` replica set member (skipped on standalone, `mongos`, or an uninitiated replica set); requires the `clusterMonitor` role. |
| `mongodb.oplog.window` | Gauge | `s` | - | Disabled by default; enable with `metrics.mongodb.oplog.window.enabled`. Only emitted by a `mongod` replica set member (skipped on standalone, `mongos`, or an uninitiated replica set); requires the `clusterMonitor` role. |
| `mongodb.page_faults` | Sum (cumulative, monotonic) | `{faults}` | - | Disabled by default; enable with `metrics.mongodb.page_faults.enabled`. |
| `mongodb.queries.rate` | Gauge | `{query}/s` | - | Disabled by default; enable with `metrics.mongodb.queries.rate.enabled`. |
| `mongodb.repl_commands_per_sec` | Gauge | `{command}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_commands_per_sec.enabled`. |
| `mongodb.repl_deletes_per_sec` | Gauge | `{delete}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_deletes_per_sec.enabled`. |
| `mongodb.repl_getmores_per_sec` | Gauge | `{getmore}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_getmores_per_sec.enabled`. |
| `mongodb.repl_inserts_per_sec` | Gauge | `{insert}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_inserts_per_sec.enabled`. |
| `mongodb.repl_queries_per_sec` | Gauge | `{query}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_queries_per_sec.enabled`. |
| `mongodb.repl_updates_per_sec` | Gauge | `{update}/s` | - | Disabled by default; enable with `metrics.mongodb.repl_updates_per_sec.enabled`. |
| `mongodb.replica.status` | Sum (cumulative, non-monotonic) | `1` | mongodb.replica.state | Disabled by default; enable with `metrics.mongodb.replica.status.enabled`. One series per possible state: 1 for the current state of the scraped member, 0 otherwise. Only emitted by a `mongod` replica set member (skipped on standalone, `mongos`, or an uninitiated replica set); requires the `clusterMonitor` role. |
| `mongodb.replica_set.headroom` | Gauge | `s` | mongodb.replica.name | Disabled by default; enable with `metrics.mongodb.replica_set.headroom.enabled`. Only emitted by a `mongod` replica set member (skipped on standalone, `mongos`, or an uninitiated replica set); requires the `clusterMonitor` role. Only emitted when the scraped member is the primary. |
| `mongodb.replica_set.lag` | Gauge | `s` | mongodb.replica.name, mongodb.replica_set.lag.type | Disabled by default; enable with `metrics.mongodb.replica_set.lag.enabled`. Only emitted by a `mongod` replica set member (skipped on standalone, `mongos`, or an uninitiated replica set); requires the `clusterMonitor` role. Only emitted when the scraped member is the primary. |
| `mongodb.replica_set.member.count` | Sum (cumulative, non-monotonic) | `{member}` | mongodb.replica.state | Disabled by default; enable with `metrics.mongodb.replica_set.member.count.enabled`. Only emitted by a `mongod` replica set member (skipped on standalone, `mongos`, or an uninitiated replica set); requires the `clusterMonitor` role. Describes the whole replica set, so every member reports the same value; do not sum across members. |
| `mongodb.session.count` | Sum (cumulative, non-monotonic) | `{sessions}` | - | - |
| `mongodb.storage.size` | Sum (cumulative, monotonic) | `By` | db.namespace | - |
| `mongodb.updates.rate` | Gauge | `{update}/s` | - | Disabled by default; enable with `metrics.mongodb.updates.rate.enabled`. |
| `mongodb.uptime` | Sum (cumulative, monotonic) | `ms` | - | Disabled by default; enable with `metrics.mongodb.uptime.enabled`. |
| `mongodb.wt.concurrent_transaction.ticket.in_use` | Sum (cumulative, non-monotonic) | `{ticket}` | `mongodb.wt.concurrent_transaction.ticket.type` | Disabled by default. |
| `mongodb.wt.fsync.count` | Sum (cumulative, monotonic) | `{fsync}` | - | Disabled by default. |
| `mongodb.wt.log.operation.count` | Sum (cumulative, monotonic) | `{operation}` | `mongodb.wt.log.operation.type` | Disabled by default. |
| `mongodb.wt.log.sync.time` | Sum (cumulative, monotonic) | `s` | - | Disabled by default. |
| `mongodb.wt.log.write` | Sum (cumulative, monotonic) | `By` | - | Disabled by default. |
| `mongodb.wtcache.bytes.read` | Sum (cumulative, monotonic) | `By` | - | Disabled by default; enable with `metrics.mongodb.wtcache.bytes.read.enabled`. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `db.server.query_sample` | client.address, client.port, db.system.name, db.namespace, db.collection.name, db.operation.name, db.query.text, mongodb.query.truncated, user.name, mongodb.client.app.name, mongodb.cursor.await_data, mongodb.cursor.id, mongodb.cursor.no_timeout, mongodb.cursor.originating_command, mongodb.cursor.returned_batches, mongodb.cursor.returned_documents, mongodb.cursor.tailable, mongodb.lsid.id, mongodb.operation.id, mongodb.operation.plan.summary, mongodb.query.framework, mongodb.operation.state, mongodb.operation.type, mongodb.operation.comment, mongodb.operation.duration, mongodb.operation.prepared_read_conflict.count, mongodb.operation.write_conflict.count, mongodb.operation.yield.count, mongodb.operation.wait.type, mongodb.operation.wait.details | Disabled by default; enable with `events.db.server.query_sample.enabled`. |
| `db.server.top_query` | db.collection.name, db.namespace, db.operation.name, db.query.text, db.system.name, mongodb.cursor.id, mongodb.cursor.originating_command, mongodb.explain_plan.hash, mongodb.explain_plan.text, mongodb.operation.comment, mongodb.operation.cpu.time, mongodb.operation.docs_examined, mongodb.operation.docs_returned, mongodb.operation.duration, mongodb.operation.keys_examined, mongodb.operation.plan.summary, mongodb.operation.response_length, mongodb.operation.type, mongodb.query.truncated | Disabled by default; enable with `events.db.server.top_query.enabled`. |

## Sources

- `receiver/mongodbreceiver/metadata.yaml`
- `receiver/mongodbreceiver/scraper.go`
- `receiver/mongodbreceiver/metrics.go`
- `receiver/mongodbreceiver/client.go`
- `receiver/mongodbreceiver/README.md`
- `receiver/mongodbreceiver/top_query_scraper.go`
- `receiver/mongodbreceiver/top_query_utils.go`
- `receiver/mongodbreceiver/internal/metadata/generated_metrics.go`
- `receiver/mongodbreceiver/internal/metadata/generated_logs.go`
      • mysqlreceiver
        • v0.153.0.md 6.5 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/mysqlreceiver
version: v0.153.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/mysqlreceiver
commit_sha: 42f949127580c0d00088b785cd0b35842dc0ddb8
last_verified: 2026-08-11
---

# MySQL Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `mysql.buffer_pool.data_pages` | Sum | 1 | status | - |
| `mysql.buffer_pool.limit` | Sum | By | - | - |
| `mysql.buffer_pool.operations` | Sum | 1 | operation | - |
| `mysql.buffer_pool.page_flushes` | Sum | 1 | - | - |
| `mysql.buffer_pool.pages` | Sum | 1 | kind | - |
| `mysql.buffer_pool.usage` | Sum | By | status | - |
| `mysql.client.network.io` | Sum | By | kind | Disabled by default; enable via the receiver's `metrics.mysql.client.network.io` configuration. |
| `mysql.commands` | Sum | 1 | command | Disabled by default; enable via the receiver's `metrics.mysql.commands` configuration. |
| `mysql.connection.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.connection.count` configuration. |
| `mysql.connection.errors` | Sum | 1 | error | Disabled by default; enable via the receiver's `metrics.mysql.connection.errors` configuration. |
| `mysql.double_writes` | Sum | 1 | kind | - |
| `mysql.handlers` | Sum | 1 | kind | - |
| `mysql.index.io.wait.count` | Sum | 1 | operation, table, schema, index | - |
| `mysql.index.io.wait.time` | Sum | ns | operation, table, schema, index | - |
| `mysql.joins` | Sum | 1 | kind | Disabled by default; enable via the receiver's `metrics.mysql.joins` configuration. |
| `mysql.locks` | Sum | 1 | kind | - |
| `mysql.log_operations` | Sum | 1 | operation | - |
| `mysql.max_used_connections` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.max_used_connections` configuration. |
| `mysql.mysqlx_connections` | Sum | 1 | status | - |
| `mysql.mysqlx_worker_threads` | Sum | 1 | kind | Disabled by default; enable via the receiver's `metrics.mysql.mysqlx_worker_threads` configuration. |
| `mysql.opened_resources` | Sum | 1 | kind | - |
| `mysql.operations` | Sum | 1 | operation | - |
| `mysql.page_operations` | Sum | 1 | operation | - |
| `mysql.page_size` | Sum | By | - | Disabled by default; enable via the receiver's `metrics.mysql.page_size` configuration. |
| `mysql.prepared_statements` | Sum | 1 | command | - |
| `mysql.query.client.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.query.client.count` configuration. |
| `mysql.query.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.query.count` configuration. |
| `mysql.query.slow.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.query.slow.count` configuration. |
| `mysql.replica.sql_delay` | Sum | s | - | Disabled by default; enable via the receiver's `metrics.mysql.replica.sql_delay` configuration. |
| `mysql.replica.time_behind_source` | Sum | s | - | Disabled by default; enable via the receiver's `metrics.mysql.replica.time_behind_source` configuration. |
| `mysql.row_locks` | Sum | 1 | kind | - |
| `mysql.row_operations` | Sum | 1 | operation | - |
| `mysql.sorts` | Sum | 1 | kind | - |
| `mysql.statement_event.count` | Sum | 1 | schema, digest, digest_text, kind | Disabled by default; enable via the receiver's `metrics.mysql.statement_event.count` configuration. |
| `mysql.statement_event.wait.time` | Sum | ns | schema, digest, digest_text | Disabled by default; enable via the receiver's `metrics.mysql.statement_event.wait.time` configuration. |
| `mysql.table.average_row_length` | Sum | By | table, schema | Disabled by default; enable via the receiver's `metrics.mysql.table.average_row_length` configuration. |
| `mysql.table.io.wait.count` | Sum | 1 | operation, table, schema | - |
| `mysql.table.io.wait.time` | Sum | ns | operation, table, schema | - |
| `mysql.table.lock_wait.read.count` | Sum | 1 | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.read.count` configuration. |
| `mysql.table.lock_wait.read.time` | Sum | ns | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.read.time` configuration. |
| `mysql.table.lock_wait.write.count` | Sum | 1 | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.write.count` configuration. |
| `mysql.table.lock_wait.write.time` | Sum | ns | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.write.time` configuration. |
| `mysql.table.rows` | Sum | 1 | table, schema | Disabled by default; enable via the receiver's `metrics.mysql.table.rows` configuration. |
| `mysql.table.size` | Sum | By | table, schema, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.size` configuration. |
| `mysql.table_open_cache` | Sum | 1 | status | Disabled by default; enable via the receiver's `metrics.mysql.table_open_cache` configuration. |
| `mysql.threads` | Sum | 1 | kind | - |
| `mysql.tmp_resources` | Sum | 1 | resource | - |
| `mysql.uptime` | Sum | s | - | - |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `db.server.query_sample` | db.system.name, mysql.threads.thread_id, user.name, db.namespace, mysql.threads.processlist_command, mysql.threads.processlist_state, db.query.text, mysql.events_statements_current.digest, mysql.query_plan, mysql.query_plan.hash, mysql.event_id, mysql.wait_type, mysql.session.status, mysql.session.id, mysql.events_statements_current.timer_wait, mysql.events_waits_current.timer_wait, client.address, client.port, network.peer.address, network.peer.port | Disabled by default; enable via the receiver's `events.db.server.query_sample` configuration. `mysql.events_waits_current.timer_wait` is populated only when the MySQL `events_waits_current` consumer is enabled; trace/span IDs are copied when the query's `@traceparent` context is valid. |
| `db.server.top_query` | db.system.name, db.query.text, mysql.query_plan, mysql.query_plan.hash, mysql.events_statements_summary_by_digest.digest, mysql.events_statements_summary_by_digest.count_star, mysql.events_statements_summary_by_digest.sum_timer_wait | Disabled by default; enable via the receiver's `events.db.server.top_query` configuration. |

## Sources

- `receiver/mysqlreceiver/metadata.yaml`
- `receiver/mysqlreceiver/internal/metadata/generated_metrics.go`
- `receiver/mysqlreceiver/internal/metadata/generated_logs.go`
- `receiver/mysqlreceiver/scraper.go`
- `receiver/mysqlreceiver/README.md`
        • v0.154.0.md 6.5 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/mysqlreceiver
version: v0.154.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/mysqlreceiver
commit_sha: 853eda0e12b3ba142552ecd2b63cec07062904f0
last_verified: 2026-08-11
---

# MySQL Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `mysql.buffer_pool.data_pages` | Sum | 1 | status | - |
| `mysql.buffer_pool.limit` | Sum | By | - | - |
| `mysql.buffer_pool.operations` | Sum | 1 | operation | - |
| `mysql.buffer_pool.page_flushes` | Sum | 1 | - | - |
| `mysql.buffer_pool.pages` | Sum | 1 | kind | - |
| `mysql.buffer_pool.usage` | Sum | By | status | - |
| `mysql.client.network.io` | Sum | By | kind | Disabled by default; enable via the receiver's `metrics.mysql.client.network.io` configuration. |
| `mysql.commands` | Sum | 1 | command | Disabled by default; enable via the receiver's `metrics.mysql.commands` configuration. |
| `mysql.connection.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.connection.count` configuration. |
| `mysql.connection.errors` | Sum | 1 | error | Disabled by default; enable via the receiver's `metrics.mysql.connection.errors` configuration. |
| `mysql.double_writes` | Sum | 1 | kind | - |
| `mysql.handlers` | Sum | 1 | kind | - |
| `mysql.index.io.wait.count` | Sum | 1 | operation, table, schema, index | - |
| `mysql.index.io.wait.time` | Sum | ns | operation, table, schema, index | - |
| `mysql.joins` | Sum | 1 | kind | Disabled by default; enable via the receiver's `metrics.mysql.joins` configuration. |
| `mysql.locks` | Sum | 1 | kind | - |
| `mysql.log_operations` | Sum | 1 | operation | - |
| `mysql.max_used_connections` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.max_used_connections` configuration. |
| `mysql.mysqlx_connections` | Sum | 1 | status | - |
| `mysql.mysqlx_worker_threads` | Sum | 1 | kind | Disabled by default; enable via the receiver's `metrics.mysql.mysqlx_worker_threads` configuration. |
| `mysql.opened_resources` | Sum | 1 | kind | - |
| `mysql.operations` | Sum | 1 | operation | - |
| `mysql.page_operations` | Sum | 1 | operation | - |
| `mysql.page_size` | Sum | By | - | Disabled by default; enable via the receiver's `metrics.mysql.page_size` configuration. |
| `mysql.prepared_statements` | Sum | 1 | command | - |
| `mysql.query.client.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.query.client.count` configuration. |
| `mysql.query.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.query.count` configuration. |
| `mysql.query.slow.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.query.slow.count` configuration. |
| `mysql.replica.sql_delay` | Sum | s | - | Disabled by default; enable via the receiver's `metrics.mysql.replica.sql_delay` configuration. |
| `mysql.replica.time_behind_source` | Sum | s | - | Disabled by default; enable via the receiver's `metrics.mysql.replica.time_behind_source` configuration. |
| `mysql.row_locks` | Sum | 1 | kind | - |
| `mysql.row_operations` | Sum | 1 | operation | - |
| `mysql.sorts` | Sum | 1 | kind | - |
| `mysql.statement_event.count` | Sum | 1 | schema, digest, digest_text, kind | Disabled by default; enable via the receiver's `metrics.mysql.statement_event.count` configuration. |
| `mysql.statement_event.wait.time` | Sum | ns | schema, digest, digest_text | Disabled by default; enable via the receiver's `metrics.mysql.statement_event.wait.time` configuration. |
| `mysql.table.average_row_length` | Sum | By | table, schema | Disabled by default; enable via the receiver's `metrics.mysql.table.average_row_length` configuration. |
| `mysql.table.io.wait.count` | Sum | 1 | operation, table, schema | - |
| `mysql.table.io.wait.time` | Sum | ns | operation, table, schema | - |
| `mysql.table.lock_wait.read.count` | Sum | 1 | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.read.count` configuration. |
| `mysql.table.lock_wait.read.time` | Sum | ns | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.read.time` configuration. |
| `mysql.table.lock_wait.write.count` | Sum | 1 | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.write.count` configuration. |
| `mysql.table.lock_wait.write.time` | Sum | ns | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.write.time` configuration. |
| `mysql.table.rows` | Sum | 1 | table, schema | Disabled by default; enable via the receiver's `metrics.mysql.table.rows` configuration. |
| `mysql.table.size` | Sum | By | table, schema, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.size` configuration. |
| `mysql.table_open_cache` | Sum | 1 | status | Disabled by default; enable via the receiver's `metrics.mysql.table_open_cache` configuration. |
| `mysql.threads` | Sum | 1 | kind | - |
| `mysql.tmp_resources` | Sum | 1 | resource | - |
| `mysql.uptime` | Sum | s | - | - |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `db.server.query_sample` | db.system.name, mysql.threads.thread_id, user.name, db.namespace, mysql.threads.processlist_command, mysql.threads.processlist_state, db.query.text, mysql.events_statements_current.digest, mysql.query_plan, mysql.query_plan.hash, mysql.event_id, mysql.wait_type, mysql.session.status, mysql.session.id, mysql.events_statements_current.timer_wait, mysql.events_waits_current.timer_wait, client.address, client.port, network.peer.address, network.peer.port | Disabled by default; enable via the receiver's `events.db.server.query_sample` configuration. `mysql.events_waits_current.timer_wait` is populated only when the MySQL `events_waits_current` consumer is enabled; trace/span IDs are copied when the query's `@traceparent` context is valid. |
| `db.server.top_query` | db.system.name, db.query.text, mysql.query_plan, mysql.query_plan.hash, mysql.events_statements_summary_by_digest.digest, mysql.events_statements_summary_by_digest.count_star, mysql.events_statements_summary_by_digest.sum_timer_wait | Disabled by default; enable via the receiver's `events.db.server.top_query` configuration. |

## Sources

- `receiver/mysqlreceiver/metadata.yaml`
- `receiver/mysqlreceiver/internal/metadata/generated_metrics.go`
- `receiver/mysqlreceiver/internal/metadata/generated_logs.go`
- `receiver/mysqlreceiver/scraper.go`
- `receiver/mysqlreceiver/README.md`
        • v0.155.0.md 6.5 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/mysqlreceiver
version: v0.155.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/mysqlreceiver
commit_sha: aaf5045a24c0a6f000225c97ad5449e69aeb5835
last_verified: 2026-08-11
---

# MySQL Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `mysql.buffer_pool.data_pages` | Sum | 1 | status | - |
| `mysql.buffer_pool.limit` | Sum | By | - | - |
| `mysql.buffer_pool.operations` | Sum | 1 | operation | - |
| `mysql.buffer_pool.page_flushes` | Sum | 1 | - | - |
| `mysql.buffer_pool.pages` | Sum | 1 | kind | - |
| `mysql.buffer_pool.usage` | Sum | By | status | - |
| `mysql.client.network.io` | Sum | By | kind | Disabled by default; enable via the receiver's `metrics.mysql.client.network.io` configuration. |
| `mysql.commands` | Sum | 1 | command | Disabled by default; enable via the receiver's `metrics.mysql.commands` configuration. |
| `mysql.connection.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.connection.count` configuration. |
| `mysql.connection.errors` | Sum | 1 | error | Disabled by default; enable via the receiver's `metrics.mysql.connection.errors` configuration. |
| `mysql.double_writes` | Sum | 1 | kind | - |
| `mysql.handlers` | Sum | 1 | kind | - |
| `mysql.index.io.wait.count` | Sum | 1 | operation, table, schema, index | - |
| `mysql.index.io.wait.time` | Sum | ns | operation, table, schema, index | - |
| `mysql.joins` | Sum | 1 | kind | Disabled by default; enable via the receiver's `metrics.mysql.joins` configuration. |
| `mysql.locks` | Sum | 1 | kind | - |
| `mysql.log_operations` | Sum | 1 | operation | - |
| `mysql.max_used_connections` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.max_used_connections` configuration. |
| `mysql.mysqlx_connections` | Sum | 1 | status | - |
| `mysql.mysqlx_worker_threads` | Sum | 1 | kind | Disabled by default; enable via the receiver's `metrics.mysql.mysqlx_worker_threads` configuration. |
| `mysql.opened_resources` | Sum | 1 | kind | - |
| `mysql.operations` | Sum | 1 | operation | - |
| `mysql.page_operations` | Sum | 1 | operation | - |
| `mysql.page_size` | Sum | By | - | Disabled by default; enable via the receiver's `metrics.mysql.page_size` configuration. |
| `mysql.prepared_statements` | Sum | 1 | command | - |
| `mysql.query.client.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.query.client.count` configuration. |
| `mysql.query.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.query.count` configuration. |
| `mysql.query.slow.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.query.slow.count` configuration. |
| `mysql.replica.sql_delay` | Sum | s | - | Disabled by default; enable via the receiver's `metrics.mysql.replica.sql_delay` configuration. |
| `mysql.replica.time_behind_source` | Sum | s | - | Disabled by default; enable via the receiver's `metrics.mysql.replica.time_behind_source` configuration. |
| `mysql.row_locks` | Sum | 1 | kind | - |
| `mysql.row_operations` | Sum | 1 | operation | - |
| `mysql.sorts` | Sum | 1 | kind | - |
| `mysql.statement_event.count` | Sum | 1 | schema, digest, digest_text, kind | Disabled by default; enable via the receiver's `metrics.mysql.statement_event.count` configuration. |
| `mysql.statement_event.wait.time` | Sum | ns | schema, digest, digest_text | Disabled by default; enable via the receiver's `metrics.mysql.statement_event.wait.time` configuration. |
| `mysql.table.average_row_length` | Sum | By | table, schema | Disabled by default; enable via the receiver's `metrics.mysql.table.average_row_length` configuration. |
| `mysql.table.io.wait.count` | Sum | 1 | operation, table, schema | - |
| `mysql.table.io.wait.time` | Sum | ns | operation, table, schema | - |
| `mysql.table.lock_wait.read.count` | Sum | 1 | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.read.count` configuration. |
| `mysql.table.lock_wait.read.time` | Sum | ns | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.read.time` configuration. |
| `mysql.table.lock_wait.write.count` | Sum | 1 | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.write.count` configuration. |
| `mysql.table.lock_wait.write.time` | Sum | ns | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.write.time` configuration. |
| `mysql.table.rows` | Sum | 1 | table, schema | Disabled by default; enable via the receiver's `metrics.mysql.table.rows` configuration. |
| `mysql.table.size` | Sum | By | table, schema, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.size` configuration. |
| `mysql.table_open_cache` | Sum | 1 | status | Disabled by default; enable via the receiver's `metrics.mysql.table_open_cache` configuration. |
| `mysql.threads` | Sum | 1 | kind | - |
| `mysql.tmp_resources` | Sum | 1 | resource | - |
| `mysql.uptime` | Sum | s | - | - |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `db.server.query_sample` | db.system.name, mysql.threads.thread_id, user.name, db.namespace, mysql.threads.processlist_command, mysql.threads.processlist_state, db.query.text, mysql.events_statements_current.digest, mysql.query_plan, mysql.query_plan.hash, mysql.event_id, mysql.wait_type, mysql.session.status, mysql.session.id, mysql.events_statements_current.timer_wait, mysql.events_waits_current.timer_wait, client.address, client.port, network.peer.address, network.peer.port | Disabled by default; enable via the receiver's `events.db.server.query_sample` configuration. `mysql.events_waits_current.timer_wait` is populated only when the MySQL `events_waits_current` consumer is enabled; trace/span IDs are copied when the query's `@traceparent` context is valid. |
| `db.server.top_query` | db.system.name, db.query.text, mysql.query_plan, mysql.query_plan.hash, mysql.events_statements_summary_by_digest.digest, mysql.events_statements_summary_by_digest.count_star, mysql.events_statements_summary_by_digest.sum_timer_wait | Disabled by default; enable via the receiver's `events.db.server.top_query` configuration. |

## Sources

- `receiver/mysqlreceiver/metadata.yaml`
- `receiver/mysqlreceiver/internal/metadata/generated_metrics.go`
- `receiver/mysqlreceiver/internal/metadata/generated_logs.go`
- `receiver/mysqlreceiver/scraper.go`
- `receiver/mysqlreceiver/README.md`
        • v0.156.0.md 6.5 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/mysqlreceiver
version: v0.156.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/mysqlreceiver
commit_sha: 41e24cd516dd69a5b4277465cdb2ff4ef0676f49
last_verified: 2026-08-11
---

# MySQL Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `mysql.buffer_pool.data_pages` | Sum | 1 | status | - |
| `mysql.buffer_pool.limit` | Sum | By | - | - |
| `mysql.buffer_pool.operations` | Sum | 1 | operation | - |
| `mysql.buffer_pool.page_flushes` | Sum | 1 | - | - |
| `mysql.buffer_pool.pages` | Sum | 1 | kind | - |
| `mysql.buffer_pool.usage` | Sum | By | status | - |
| `mysql.client.network.io` | Sum | By | kind | Disabled by default; enable via the receiver's `metrics.mysql.client.network.io` configuration. |
| `mysql.commands` | Sum | 1 | command | Disabled by default; enable via the receiver's `metrics.mysql.commands` configuration. |
| `mysql.connection.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.connection.count` configuration. |
| `mysql.connection.errors` | Sum | 1 | error | Disabled by default; enable via the receiver's `metrics.mysql.connection.errors` configuration. |
| `mysql.double_writes` | Sum | 1 | kind | - |
| `mysql.handlers` | Sum | 1 | kind | - |
| `mysql.index.io.wait.count` | Sum | 1 | operation, table, schema, index | - |
| `mysql.index.io.wait.time` | Sum | ns | operation, table, schema, index | - |
| `mysql.joins` | Sum | 1 | kind | Disabled by default; enable via the receiver's `metrics.mysql.joins` configuration. |
| `mysql.locks` | Sum | 1 | kind | - |
| `mysql.log_operations` | Sum | 1 | operation | - |
| `mysql.max_used_connections` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.max_used_connections` configuration. |
| `mysql.mysqlx_connections` | Sum | 1 | status | - |
| `mysql.mysqlx_worker_threads` | Sum | 1 | kind | Disabled by default; enable via the receiver's `metrics.mysql.mysqlx_worker_threads` configuration. |
| `mysql.opened_resources` | Sum | 1 | kind | - |
| `mysql.operations` | Sum | 1 | operation | - |
| `mysql.page_operations` | Sum | 1 | operation | - |
| `mysql.page_size` | Sum | By | - | Disabled by default; enable via the receiver's `metrics.mysql.page_size` configuration. |
| `mysql.prepared_statements` | Sum | 1 | command | - |
| `mysql.query.client.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.query.client.count` configuration. |
| `mysql.query.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.query.count` configuration. |
| `mysql.query.slow.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.query.slow.count` configuration. |
| `mysql.replica.sql_delay` | Sum | s | - | Disabled by default; enable via the receiver's `metrics.mysql.replica.sql_delay` configuration. |
| `mysql.replica.time_behind_source` | Sum | s | - | Disabled by default; enable via the receiver's `metrics.mysql.replica.time_behind_source` configuration. |
| `mysql.row_locks` | Sum | 1 | kind | - |
| `mysql.row_operations` | Sum | 1 | operation | - |
| `mysql.sorts` | Sum | 1 | kind | - |
| `mysql.statement_event.count` | Sum | 1 | schema, digest, digest_text, kind | Disabled by default; enable via the receiver's `metrics.mysql.statement_event.count` configuration. |
| `mysql.statement_event.wait.time` | Sum | ns | schema, digest, digest_text | Disabled by default; enable via the receiver's `metrics.mysql.statement_event.wait.time` configuration. |
| `mysql.table.average_row_length` | Sum | By | table, schema | Disabled by default; enable via the receiver's `metrics.mysql.table.average_row_length` configuration. |
| `mysql.table.io.wait.count` | Sum | 1 | operation, table, schema | - |
| `mysql.table.io.wait.time` | Sum | ns | operation, table, schema | - |
| `mysql.table.lock_wait.read.count` | Sum | 1 | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.read.count` configuration. |
| `mysql.table.lock_wait.read.time` | Sum | ns | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.read.time` configuration. |
| `mysql.table.lock_wait.write.count` | Sum | 1 | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.write.count` configuration. |
| `mysql.table.lock_wait.write.time` | Sum | ns | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.write.time` configuration. |
| `mysql.table.rows` | Sum | 1 | table, schema | Disabled by default; enable via the receiver's `metrics.mysql.table.rows` configuration. |
| `mysql.table.size` | Sum | By | table, schema, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.size` configuration. |
| `mysql.table_open_cache` | Sum | 1 | status | Disabled by default; enable via the receiver's `metrics.mysql.table_open_cache` configuration. |
| `mysql.threads` | Sum | 1 | kind | - |
| `mysql.tmp_resources` | Sum | 1 | resource | - |
| `mysql.uptime` | Sum | s | - | - |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `db.server.query_sample` | db.system.name, mysql.threads.thread_id, user.name, db.namespace, mysql.threads.processlist_command, mysql.threads.processlist_state, db.query.text, mysql.events_statements_current.digest, mysql.query_plan, mysql.query_plan.hash, mysql.event_id, mysql.wait_type, mysql.session.status, mysql.session.id, mysql.events_statements_current.timer_wait, mysql.events_waits_current.timer_wait, client.address, client.port, network.peer.address, network.peer.port | Disabled by default; enable via the receiver's `events.db.server.query_sample` configuration. `mysql.events_waits_current.timer_wait` is populated only when the MySQL `events_waits_current` consumer is enabled; trace/span IDs are copied when the query's `@traceparent` context is valid. |
| `db.server.top_query` | db.system.name, db.query.text, mysql.query_plan, mysql.query_plan.hash, mysql.events_statements_summary_by_digest.digest, mysql.events_statements_summary_by_digest.count_star, mysql.events_statements_summary_by_digest.sum_timer_wait | Disabled by default; enable via the receiver's `events.db.server.top_query` configuration. |

## Sources

- `receiver/mysqlreceiver/metadata.yaml`
- `receiver/mysqlreceiver/internal/metadata/generated_metrics.go`
- `receiver/mysqlreceiver/internal/metadata/generated_logs.go`
- `receiver/mysqlreceiver/scraper.go`
- `receiver/mysqlreceiver/README.md`
        • v0.157.0.md 6.5 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/mysqlreceiver
version: v0.157.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/mysqlreceiver
commit_sha: 89e43555904cd97c2d36605347c5d5237b1bdc8c
last_verified: 2026-08-11
---

# MySQL Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `mysql.buffer_pool.data_pages` | Sum | 1 | status | - |
| `mysql.buffer_pool.limit` | Sum | By | - | - |
| `mysql.buffer_pool.operations` | Sum | 1 | operation | - |
| `mysql.buffer_pool.page_flushes` | Sum | 1 | - | - |
| `mysql.buffer_pool.pages` | Sum | 1 | kind | - |
| `mysql.buffer_pool.usage` | Sum | By | status | - |
| `mysql.client.network.io` | Sum | By | kind | Disabled by default; enable via the receiver's `metrics.mysql.client.network.io` configuration. |
| `mysql.commands` | Sum | 1 | command | Disabled by default; enable via the receiver's `metrics.mysql.commands` configuration. |
| `mysql.connection.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.connection.count` configuration. |
| `mysql.connection.errors` | Sum | 1 | error | Disabled by default; enable via the receiver's `metrics.mysql.connection.errors` configuration. |
| `mysql.double_writes` | Sum | 1 | kind | - |
| `mysql.handlers` | Sum | 1 | kind | - |
| `mysql.index.io.wait.count` | Sum | 1 | operation, table, schema, index | - |
| `mysql.index.io.wait.time` | Sum | ns | operation, table, schema, index | - |
| `mysql.joins` | Sum | 1 | kind | Disabled by default; enable via the receiver's `metrics.mysql.joins` configuration. |
| `mysql.locks` | Sum | 1 | kind | - |
| `mysql.log_operations` | Sum | 1 | operation | - |
| `mysql.max_used_connections` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.max_used_connections` configuration. |
| `mysql.mysqlx_connections` | Sum | 1 | status | - |
| `mysql.mysqlx_worker_threads` | Sum | 1 | kind | Disabled by default; enable via the receiver's `metrics.mysql.mysqlx_worker_threads` configuration. |
| `mysql.opened_resources` | Sum | 1 | kind | - |
| `mysql.operations` | Sum | 1 | operation | - |
| `mysql.page_operations` | Sum | 1 | operation | - |
| `mysql.page_size` | Sum | By | - | Disabled by default; enable via the receiver's `metrics.mysql.page_size` configuration. |
| `mysql.prepared_statements` | Sum | 1 | command | - |
| `mysql.query.client.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.query.client.count` configuration. |
| `mysql.query.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.query.count` configuration. |
| `mysql.query.slow.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.query.slow.count` configuration. |
| `mysql.replica.sql_delay` | Sum | s | - | Disabled by default; enable via the receiver's `metrics.mysql.replica.sql_delay` configuration. |
| `mysql.replica.time_behind_source` | Sum | s | - | Disabled by default; enable via the receiver's `metrics.mysql.replica.time_behind_source` configuration. |
| `mysql.row_locks` | Sum | 1 | kind | - |
| `mysql.row_operations` | Sum | 1 | operation | - |
| `mysql.sorts` | Sum | 1 | kind | - |
| `mysql.statement_event.count` | Sum | 1 | schema, digest, digest_text, kind | Disabled by default; enable via the receiver's `metrics.mysql.statement_event.count` configuration. |
| `mysql.statement_event.wait.time` | Sum | ns | schema, digest, digest_text | Disabled by default; enable via the receiver's `metrics.mysql.statement_event.wait.time` configuration. |
| `mysql.table.average_row_length` | Sum | By | table, schema | Disabled by default; enable via the receiver's `metrics.mysql.table.average_row_length` configuration. |
| `mysql.table.io.wait.count` | Sum | 1 | operation, table, schema | - |
| `mysql.table.io.wait.time` | Sum | ns | operation, table, schema | - |
| `mysql.table.lock_wait.read.count` | Sum | 1 | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.read.count` configuration. |
| `mysql.table.lock_wait.read.time` | Sum | ns | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.read.time` configuration. |
| `mysql.table.lock_wait.write.count` | Sum | 1 | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.write.count` configuration. |
| `mysql.table.lock_wait.write.time` | Sum | ns | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.write.time` configuration. |
| `mysql.table.rows` | Sum | 1 | table, schema | Disabled by default; enable via the receiver's `metrics.mysql.table.rows` configuration. |
| `mysql.table.size` | Sum | By | table, schema, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.size` configuration. |
| `mysql.table_open_cache` | Sum | 1 | status | Disabled by default; enable via the receiver's `metrics.mysql.table_open_cache` configuration. |
| `mysql.threads` | Sum | 1 | kind | - |
| `mysql.tmp_resources` | Sum | 1 | resource | - |
| `mysql.uptime` | Sum | s | - | - |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `db.server.query_sample` | db.system.name, mysql.threads.thread_id, user.name, db.namespace, mysql.threads.processlist_command, mysql.threads.processlist_state, db.query.text, mysql.events_statements_current.digest, mysql.query_plan, mysql.query_plan.hash, mysql.event_id, mysql.wait_type, mysql.session.status, mysql.session.id, mysql.events_statements_current.timer_wait, mysql.events_waits_current.timer_wait, client.address, client.port, network.peer.address, network.peer.port | Disabled by default; enable via the receiver's `events.db.server.query_sample` configuration. `mysql.events_waits_current.timer_wait` is populated only when the MySQL `events_waits_current` consumer is enabled; trace/span IDs are copied when the query's `@traceparent` context is valid. |
| `db.server.top_query` | db.system.name, db.query.text, mysql.query_plan, mysql.query_plan.hash, mysql.events_statements_summary_by_digest.digest, mysql.events_statements_summary_by_digest.count_star, mysql.events_statements_summary_by_digest.sum_timer_wait | Disabled by default; enable via the receiver's `events.db.server.top_query` configuration. |

## Sources

- `receiver/mysqlreceiver/metadata.yaml`
- `receiver/mysqlreceiver/internal/metadata/generated_metrics.go`
- `receiver/mysqlreceiver/internal/metadata/generated_logs.go`
- `receiver/mysqlreceiver/scraper.go`
- `receiver/mysqlreceiver/README.md`
        • v0.158.0.md 6.5 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/mysqlreceiver
version: v0.158.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/mysqlreceiver
commit_sha: 821a9d9c2c1623c4a0ceba5d47b57c48879c3f84
last_verified: 2026-08-11
---

# MySQL Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `mysql.buffer_pool.data_pages` | Sum | 1 | status | - |
| `mysql.buffer_pool.limit` | Sum | By | - | - |
| `mysql.buffer_pool.operations` | Sum | 1 | operation | - |
| `mysql.buffer_pool.page_flushes` | Sum | 1 | - | - |
| `mysql.buffer_pool.pages` | Sum | 1 | kind | - |
| `mysql.buffer_pool.usage` | Sum | By | status | - |
| `mysql.client.network.io` | Sum | By | kind | Disabled by default; enable via the receiver's `metrics.mysql.client.network.io` configuration. |
| `mysql.commands` | Sum | 1 | command | Disabled by default; enable via the receiver's `metrics.mysql.commands` configuration. |
| `mysql.connection.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.connection.count` configuration. |
| `mysql.connection.errors` | Sum | 1 | error | Disabled by default; enable via the receiver's `metrics.mysql.connection.errors` configuration. |
| `mysql.double_writes` | Sum | 1 | kind | - |
| `mysql.handlers` | Sum | 1 | kind | - |
| `mysql.index.io.wait.count` | Sum | 1 | operation, table, schema, index | - |
| `mysql.index.io.wait.time` | Sum | ns | operation, table, schema, index | - |
| `mysql.joins` | Sum | 1 | kind | Disabled by default; enable via the receiver's `metrics.mysql.joins` configuration. |
| `mysql.locks` | Sum | 1 | kind | - |
| `mysql.log_operations` | Sum | 1 | operation | - |
| `mysql.max_used_connections` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.max_used_connections` configuration. |
| `mysql.mysqlx_connections` | Sum | 1 | status | - |
| `mysql.mysqlx_worker_threads` | Sum | 1 | kind | Disabled by default; enable via the receiver's `metrics.mysql.mysqlx_worker_threads` configuration. |
| `mysql.opened_resources` | Sum | 1 | kind | - |
| `mysql.operations` | Sum | 1 | operation | - |
| `mysql.page_operations` | Sum | 1 | operation | - |
| `mysql.page_size` | Sum | By | - | Disabled by default; enable via the receiver's `metrics.mysql.page_size` configuration. |
| `mysql.prepared_statements` | Sum | 1 | command | - |
| `mysql.query.client.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.query.client.count` configuration. |
| `mysql.query.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.query.count` configuration. |
| `mysql.query.slow.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.query.slow.count` configuration. |
| `mysql.replica.sql_delay` | Sum | s | - | Disabled by default; enable via the receiver's `metrics.mysql.replica.sql_delay` configuration. |
| `mysql.replica.time_behind_source` | Sum | s | - | Disabled by default; enable via the receiver's `metrics.mysql.replica.time_behind_source` configuration. |
| `mysql.row_locks` | Sum | 1 | kind | - |
| `mysql.row_operations` | Sum | 1 | operation | - |
| `mysql.sorts` | Sum | 1 | kind | - |
| `mysql.statement_event.count` | Sum | 1 | schema, digest, digest_text, kind | Disabled by default; enable via the receiver's `metrics.mysql.statement_event.count` configuration. |
| `mysql.statement_event.wait.time` | Sum | ns | schema, digest, digest_text | Disabled by default; enable via the receiver's `metrics.mysql.statement_event.wait.time` configuration. |
| `mysql.table.average_row_length` | Sum | By | table, schema | Disabled by default; enable via the receiver's `metrics.mysql.table.average_row_length` configuration. |
| `mysql.table.io.wait.count` | Sum | 1 | operation, table, schema | - |
| `mysql.table.io.wait.time` | Sum | ns | operation, table, schema | - |
| `mysql.table.lock_wait.read.count` | Sum | 1 | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.read.count` configuration. |
| `mysql.table.lock_wait.read.time` | Sum | ns | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.read.time` configuration. |
| `mysql.table.lock_wait.write.count` | Sum | 1 | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.write.count` configuration. |
| `mysql.table.lock_wait.write.time` | Sum | ns | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.write.time` configuration. |
| `mysql.table.rows` | Sum | 1 | table, schema | Disabled by default; enable via the receiver's `metrics.mysql.table.rows` configuration. |
| `mysql.table.size` | Sum | By | table, schema, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.size` configuration. |
| `mysql.table_open_cache` | Sum | 1 | status | Disabled by default; enable via the receiver's `metrics.mysql.table_open_cache` configuration. |
| `mysql.threads` | Sum | 1 | kind | - |
| `mysql.tmp_resources` | Sum | 1 | resource | - |
| `mysql.uptime` | Sum | s | - | - |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `db.server.query_sample` | db.system.name, mysql.threads.thread_id, user.name, db.namespace, mysql.threads.processlist_command, mysql.threads.processlist_state, db.query.text, mysql.events_statements_current.digest, mysql.query_plan, mysql.query_plan.hash, mysql.event_id, mysql.wait_type, mysql.session.status, mysql.session.id, mysql.events_statements_current.timer_wait, mysql.events_waits_current.timer_wait, client.address, client.port, network.peer.address, network.peer.port | Disabled by default; enable via the receiver's `events.db.server.query_sample` configuration. `mysql.events_waits_current.timer_wait` is populated only when the MySQL `events_waits_current` consumer is enabled; trace/span IDs are copied when the query's `@traceparent` context is valid. |
| `db.server.top_query` | db.system.name, db.query.text, mysql.query_plan, mysql.query_plan.hash, mysql.events_statements_summary_by_digest.digest, mysql.events_statements_summary_by_digest.count_star, mysql.events_statements_summary_by_digest.sum_timer_wait | Disabled by default; enable via the receiver's `events.db.server.top_query` configuration. |

## Sources

- `receiver/mysqlreceiver/metadata.yaml`
- `receiver/mysqlreceiver/internal/metadata/generated_metrics.go`
- `receiver/mysqlreceiver/internal/metadata/generated_logs.go`
- `receiver/mysqlreceiver/scraper.go`
- `receiver/mysqlreceiver/README.md`
        • v0.159.0.md 7.8 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/mysqlreceiver
version: v0.159.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/mysqlreceiver
commit_sha: 1120cc0714bf4d14600105e5673c3b00fe87467a
last_verified: 2026-08-26
---

# MySQL Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `mysql.buffer_pool.data_pages` | Sum | 1 | status | - |
| `mysql.buffer_pool.limit` | Sum | By | - | - |
| `mysql.buffer_pool.operations` | Sum | 1 | operation | - |
| `mysql.buffer_pool.page_flushes` | Sum | 1 | - | - |
| `mysql.buffer_pool.pages` | Sum | 1 | kind | - |
| `mysql.buffer_pool.usage` | Sum | By | status | - |
| `mysql.client.network.io` | Sum | By | kind | Disabled by default; enable via the receiver's `metrics.mysql.client.network.io` configuration. |
| `mysql.commands` | Sum | 1 | command | Disabled by default; enable via the receiver's `metrics.mysql.commands` configuration. v0.159.0 adds `alter_table`, `create_index`, `create_table`, and `optimize` command values. |
| `mysql.connection.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.connection.count` configuration. |
| `mysql.connection.errors` | Sum | 1 | error | Disabled by default; enable via the receiver's `metrics.mysql.connection.errors` configuration. |
| `mysql.double_writes` | Sum | 1 | kind | - |
| `mysql.file.open` | Gauge | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.file.open` configuration. |
| `mysql.handlers` | Sum | 1 | kind | - |
| `mysql.index.io.wait.count` | Sum | 1 | operation, table, schema, index | - |
| `mysql.index.io.wait.time` | Sum | ns | operation, table, schema, index | - |
| `mysql.innodb.data_file.io` | Sum | By | disk.io.direction | Disabled by default; enable via the receiver's `metrics.mysql.innodb.data_file.io` configuration. |
| `mysql.innodb.operation.pending` | Sum | 1 | operation | Disabled by default; enable via the receiver's `metrics.mysql.innodb.operation.pending` configuration. Non-monotonic cumulative sum. |
| `mysql.joins` | Sum | 1 | kind | Disabled by default; enable via the receiver's `metrics.mysql.joins` configuration. |
| `mysql.locks` | Sum | 1 | kind | - |
| `mysql.log_operations` | Sum | 1 | operation | - |
| `mysql.max_used_connections` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.max_used_connections` configuration. |
| `mysql.mysqlx_connections` | Sum | 1 | status | - |
| `mysql.mysqlx_worker_threads` | Sum | 1 | kind | Disabled by default; enable via the receiver's `metrics.mysql.mysqlx_worker_threads` configuration. |
| `mysql.opened_resources` | Sum | 1 | kind | - |
| `mysql.operations` | Sum | 1 | operation | - |
| `mysql.page_operations` | Sum | 1 | operation | - |
| `mysql.page_size` | Sum | By | - | Disabled by default; enable via the receiver's `metrics.mysql.page_size` configuration. |
| `mysql.prepared_statements` | Sum | 1 | command | - |
| `mysql.query.client.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.query.client.count` configuration. |
| `mysql.query.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.query.count` configuration. |
| `mysql.query.slow.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.query.slow.count` configuration. |
| `mysql.replica.sql_delay` | Sum | s | - | Disabled by default; enable via the receiver's `metrics.mysql.replica.sql_delay` configuration. |
| `mysql.replica.temp_table.open` | Gauge | `{table}` | - | Disabled by default; enable via the receiver's `metrics.mysql.replica.temp_table.open` configuration. |
| `mysql.replica.thread.running` | Gauge | 1 | mysql.replica.thread.type, mysql.replica.channel.name | Disabled by default; enable via the receiver's `metrics.mysql.replica.thread.running` configuration. Value is 1 for `Yes`, otherwise 0. |
| `mysql.replica.time_behind_source` | Sum | s | - | Disabled by default; enable via the receiver's `metrics.mysql.replica.time_behind_source` configuration. |
| `mysql.row_locks` | Sum | 1 | kind | - |
| `mysql.row_operations` | Sum | 1 | operation | - |
| `mysql.sorts` | Sum | 1 | kind | - |
| `mysql.statement_event.count` | Sum | 1 | schema, digest, digest_text, kind | Disabled by default; enable via the receiver's `metrics.mysql.statement_event.count` configuration. |
| `mysql.statement_event.wait.time` | Sum | ns | schema, digest, digest_text | Disabled by default; enable via the receiver's `metrics.mysql.statement_event.wait.time` configuration. |
| `mysql.table.average_row_length` | Sum | By | table, schema | Disabled by default; enable via the receiver's `metrics.mysql.table.average_row_length` configuration. |
| `mysql.table.io.wait.count` | Sum | 1 | operation, table, schema | - |
| `mysql.table.io.wait.time` | Sum | ns | operation, table, schema | - |
| `mysql.table.lock_wait.read.count` | Sum | 1 | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.read.count` configuration. |
| `mysql.table.lock_wait.read.time` | Sum | ns | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.read.time` configuration. |
| `mysql.table.lock_wait.write.count` | Sum | 1 | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.write.count` configuration. |
| `mysql.table.lock_wait.write.time` | Sum | ns | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.write.time` configuration. |
| `mysql.table.open` | Gauge | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.table.open` configuration. |
| `mysql.table.rows` | Sum | 1 | table, schema | Disabled by default; enable via the receiver's `metrics.mysql.table.rows` configuration. |
| `mysql.table.size` | Sum | By | table, schema, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.size` configuration. |
| `mysql.table_open_cache` | Sum | 1 | status | Disabled by default; enable via the receiver's `metrics.mysql.table_open_cache` configuration. |
| `mysql.thread.slow_launch` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.thread.slow_launch` configuration. Monotonic cumulative sum. |
| `mysql.threads` | Sum | 1 | kind | - |
| `mysql.tmp_resources` | Sum | 1 | resource | - |
| `mysql.uptime` | Sum | s | - | - |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `db.server.query_sample` | db.system.name, mysql.threads.thread_id, user.name, db.namespace, mysql.threads.processlist_command, mysql.threads.processlist_state, db.query.text, mysql.events_statements_current.digest, mysql.query_plan, mysql.query_plan.hash, mysql.event_id, mysql.wait_type, mysql.session.status, mysql.session.id, mysql.events_statements_current.timer_wait, mysql.events_waits_current.timer_wait, client.address, client.port, network.peer.address, network.peer.port | Disabled by default; enable via the receiver's `events.db.server.query_sample` configuration. `mysql.events_waits_current.timer_wait` is populated only when the MySQL `events_waits_current` consumer is enabled; trace/span IDs are copied when the query's `@traceparent` context is valid. |
| `db.server.top_query` | db.system.name, db.query.text, mysql.query_plan, mysql.query_plan.hash, mysql.events_statements_summary_by_digest.digest, mysql.events_statements_summary_by_digest.count_star, mysql.events_statements_summary_by_digest.sum_timer_wait | Disabled by default; enable via the receiver's `events.db.server.top_query` configuration. |

## Sources

- `receiver/mysqlreceiver/metadata.yaml`
- `receiver/mysqlreceiver/internal/metadata/generated_metrics.go`
- `receiver/mysqlreceiver/internal/metadata/generated_logs.go`
- `receiver/mysqlreceiver/scraper.go`
- `receiver/mysqlreceiver/README.md`
        • v0.160.0.md 8.5 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/mysqlreceiver
version: v0.160.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/mysqlreceiver
commit_sha: 982f20b8a8e8a2569fab3e27cf8b008e8a5080c1
last_verified: 2026-09-03
---

# MySQL Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `mysql.buffer_pool.data_pages` | Sum | 1 | status | - |
| `mysql.buffer_pool.limit` | Sum | By | - | - |
| `mysql.buffer_pool.operations` | Sum | 1 | operation | - |
| `mysql.buffer_pool.page_flushes` | Sum | 1 | - | - |
| `mysql.buffer_pool.pages` | Sum | 1 | kind | - |
| `mysql.buffer_pool.usage` | Sum | By | status | - |
| `mysql.client.network.io` | Sum | By | kind | Disabled by default; enable via the receiver's `metrics.mysql.client.network.io` configuration. |
| `mysql.commands` | Sum | 1 | command | Disabled by default; enable via the receiver's `metrics.mysql.commands` configuration. v0.159.0 adds `alter_table`, `create_index`, `create_table`, and `optimize` command values. |
| `mysql.connection.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.connection.count` configuration. |
| `mysql.connection.errors` | Sum | 1 | error | Disabled by default; enable via the receiver's `metrics.mysql.connection.errors` configuration. |
| `mysql.double_writes` | Sum | 1 | kind | - |
| `mysql.file.open` | Gauge | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.file.open` configuration. |
| `mysql.handlers` | Sum | 1 | kind | - |
| `mysql.index.io.wait.count` | Sum | 1 | operation, table, schema, index | - |
| `mysql.index.io.wait.time` | Sum | ns | operation, table, schema, index | - |
| `mysql.innodb.data_file.io` | Sum | By | disk.io.direction | Disabled by default; enable via the receiver's `metrics.mysql.innodb.data_file.io` configuration. |
| `mysql.innodb.operation.pending` | Sum | 1 | operation | Disabled by default; enable via the receiver's `metrics.mysql.innodb.operation.pending` configuration. Non-monotonic cumulative sum. |
| `mysql.innodb.row_lock.wait.count` | Gauge | `{wait}` | - | Disabled by default. |
| `mysql.innodb.row_lock.wait.duration.avg` | Gauge | `s` | - | Disabled by default. |
| `mysql.innodb.row_lock.wait.duration.max` | Gauge | `s` | - | Disabled by default. |
| `mysql.joins` | Sum | 1 | kind | Disabled by default; enable via the receiver's `metrics.mysql.joins` configuration. |
| `mysql.locks` | Sum | 1 | kind | - |
| `mysql.log_operations` | Sum | 1 | operation | - |
| `mysql.max_used_connections` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.max_used_connections` configuration. |
| `mysql.myisam.key_cache.block.unused` | Gauge | `{block}` | - | Disabled by default. |
| `mysql.myisam.key_cache.block.used.max` | Gauge | `{block}` | - | Disabled by default. |
| `mysql.myisam.key_cache.disk.operation` | Sum (cumulative, monotonic) | `{operation}` | `operation` (`read` or `write`) | Disabled by default. |
| `mysql.myisam.key_cache.request` | Sum (cumulative, monotonic) | `{request}` | `operation` (`read` or `write`) | Disabled by default. |
| `mysql.mysqlx_connections` | Sum | 1 | status | - |
| `mysql.mysqlx_worker_threads` | Sum | 1 | kind | Disabled by default; enable via the receiver's `metrics.mysql.mysqlx_worker_threads` configuration. |
| `mysql.opened_resources` | Sum | 1 | kind | - |
| `mysql.operations` | Sum | 1 | operation | - |
| `mysql.page_operations` | Sum | 1 | operation | - |
| `mysql.page_size` | Sum | By | - | Disabled by default; enable via the receiver's `metrics.mysql.page_size` configuration. |
| `mysql.prepared_statements` | Sum | 1 | command | - |
| `mysql.query.client.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.query.client.count` configuration. |
| `mysql.query.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.query.count` configuration. |
| `mysql.query.slow.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.query.slow.count` configuration. |
| `mysql.replica.sql_delay` | Sum | s | - | Disabled by default; enable via the receiver's `metrics.mysql.replica.sql_delay` configuration. |
| `mysql.replica.temp_table.open` | Gauge | `{table}` | - | Disabled by default; enable via the receiver's `metrics.mysql.replica.temp_table.open` configuration. |
| `mysql.replica.thread.running` | Gauge | 1 | mysql.replica.thread.type, mysql.replica.channel.name | Disabled by default; enable via the receiver's `metrics.mysql.replica.thread.running` configuration. Value is 1 for `Yes`, otherwise 0. |
| `mysql.replica.time_behind_source` | Sum | s | - | Disabled by default; enable via the receiver's `metrics.mysql.replica.time_behind_source` configuration. |
| `mysql.row_locks` | Sum | 1 | kind | - |
| `mysql.row_operations` | Sum | 1 | operation | - |
| `mysql.sorts` | Sum | 1 | kind | - |
| `mysql.statement_event.count` | Sum | 1 | schema, digest, digest_text, kind | Disabled by default; enable via the receiver's `metrics.mysql.statement_event.count` configuration. |
| `mysql.statement_event.wait.time` | Sum | ns | schema, digest, digest_text | Disabled by default; enable via the receiver's `metrics.mysql.statement_event.wait.time` configuration. |
| `mysql.table.average_row_length` | Sum | By | table, schema | Disabled by default; enable via the receiver's `metrics.mysql.table.average_row_length` configuration. |
| `mysql.table.io.wait.count` | Sum | 1 | operation, table, schema | - |
| `mysql.table.io.wait.time` | Sum | ns | operation, table, schema | - |
| `mysql.table.lock_wait.read.count` | Sum | 1 | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.read.count` configuration. |
| `mysql.table.lock_wait.read.time` | Sum | ns | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.read.time` configuration. |
| `mysql.table.lock_wait.write.count` | Sum | 1 | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.write.count` configuration. |
| `mysql.table.lock_wait.write.time` | Sum | ns | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.write.time` configuration. |
| `mysql.table.open` | Gauge | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.table.open` configuration. |
| `mysql.table.rows` | Sum | 1 | table, schema | Disabled by default; enable via the receiver's `metrics.mysql.table.rows` configuration. |
| `mysql.table.size` | Sum | By | table, schema, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.size` configuration. |
| `mysql.table_open_cache` | Sum | 1 | status | Disabled by default; enable via the receiver's `metrics.mysql.table_open_cache` configuration. |
| `mysql.thread.slow_launch` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.thread.slow_launch` configuration. Monotonic cumulative sum. |
| `mysql.threads` | Sum | 1 | kind | - |
| `mysql.tmp_resources` | Sum | 1 | resource | - |
| `mysql.uptime` | Sum | s | - | - |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `db.server.query_sample` | db.system.name, mysql.threads.thread_id, user.name, db.namespace, mysql.threads.processlist_command, mysql.threads.processlist_state, db.query.text, mysql.events_statements_current.digest, mysql.query_plan, mysql.query_plan.hash, mysql.event_id, mysql.wait_type, mysql.session.status, mysql.session.id, mysql.events_statements_current.timer_wait, mysql.events_waits_current.timer_wait, client.address, client.port, network.peer.address, network.peer.port | Disabled by default; enable via the receiver's `events.db.server.query_sample` configuration. `mysql.events_waits_current.timer_wait` is populated only when the MySQL `events_waits_current` consumer is enabled; trace/span IDs are copied when the query's `@traceparent` context is valid. |
| `db.server.top_query` | db.system.name, db.query.text, mysql.query_plan, mysql.query_plan.hash, mysql.events_statements_summary_by_digest.digest, mysql.events_statements_summary_by_digest.count_star, mysql.events_statements_summary_by_digest.sum_timer_wait | Disabled by default; enable via the receiver's `events.db.server.top_query` configuration. |

## Sources

- `receiver/mysqlreceiver/metadata.yaml`
- `receiver/mysqlreceiver/internal/metadata/generated_metrics.go`
- `receiver/mysqlreceiver/internal/metadata/generated_logs.go`
- `receiver/mysqlreceiver/scraper.go`
- `receiver/mysqlreceiver/README.md`
        • v0.161.0.md 10.5 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/mysqlreceiver
version: v0.161.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/mysqlreceiver
commit_sha: 3f8455d8038a985398861171e5310bc9b4e988b2
last_verified: 2026-10-03
---

# MySQL Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `mysql.buffer_pool.data_pages` | Sum | 1 | status | - |
| `mysql.buffer_pool.limit` | Sum | By | - | - |
| `mysql.buffer_pool.operations` | Sum | 1 | operation | - |
| `mysql.buffer_pool.page_flushes` | Sum | 1 | - | - |
| `mysql.buffer_pool.pages` | Sum | 1 | kind | - |
| `mysql.buffer_pool.usage` | Sum | By | status | - |
| `mysql.client.network.io` | Sum | By | kind | Disabled by default; enable via the receiver's `metrics.mysql.client.network.io` configuration. |
| `mysql.commands` | Sum | 1 | command | Disabled by default; enable via the receiver's `metrics.mysql.commands` configuration. v0.159.0 adds `alter_table`, `create_index`, `create_table`, and `optimize` command values. |
| `mysql.connection.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.connection.count` configuration. |
| `mysql.connection.errors` | Sum | 1 | error | Disabled by default; enable via the receiver's `metrics.mysql.connection.errors` configuration. |
| `mysql.double_writes` | Sum | 1 | kind | - |
| `mysql.file.open` | Gauge | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.file.open` configuration. |
| `mysql.handlers` | Sum | 1 | kind | - |
| `mysql.index.io.wait.count` | Sum | 1 | operation, table, schema, index | - |
| `mysql.index.io.wait.time` | Sum | ns | operation, table, schema, index | - |
| `mysql.innodb.data_file.io` | Sum | By | disk.io.direction | Disabled by default; enable via the receiver's `metrics.mysql.innodb.data_file.io` configuration. |
| `mysql.innodb.history_list.length` | Gauge | `{transactions}` | - | Disabled by default; enable via the receiver's `metrics.mysql.innodb.history_list.length` configuration. |
| `mysql.innodb.operation.pending` | Sum | 1 | operation | Disabled by default; enable via the receiver's `metrics.mysql.innodb.operation.pending` configuration. Non-monotonic cumulative sum. |
| `mysql.innodb.redo_log.checkpoint.age` | Gauge | By | - | Disabled by default; enable via the receiver's `metrics.mysql.innodb.redo_log.checkpoint.age` configuration. Only emitted for MySQL 8.0.11 and later (8.0.11 through 8.0.29 also require `BACKUP_ADMIN`); not supported on MariaDB. |
| `mysql.innodb.redo_log.lsn.checkpoint` | Gauge | By | - | Disabled by default; enable via the receiver's `metrics.mysql.innodb.redo_log.lsn.checkpoint` configuration. Only emitted for MySQL 8.0.11 and later (8.0.11 through 8.0.29 also require `BACKUP_ADMIN`); not supported on MariaDB. |
| `mysql.innodb.redo_log.lsn.current` | Gauge | By | - | Disabled by default; enable via the receiver's `metrics.mysql.innodb.redo_log.lsn.current` configuration. Only emitted for MySQL 8.0.11 and later (8.0.11 through 8.0.29 also require `BACKUP_ADMIN`); not supported on MariaDB. |
| `mysql.innodb.row_lock.wait.count` | Gauge | `{wait}` | - | Disabled by default. |
| `mysql.innodb.row_lock.wait.duration.avg` | Gauge | `s` | - | Disabled by default. |
| `mysql.innodb.row_lock.wait.duration.max` | Gauge | `s` | - | Disabled by default. |
| `mysql.innodb.transaction.active.count` | Gauge | `{transaction}` | - | Disabled by default; enable via the receiver's `metrics.mysql.innodb.transaction.active.count` configuration. |
| `mysql.innodb.transaction.active.duration.max` | Gauge | s | - | Disabled by default; enable via the receiver's `metrics.mysql.innodb.transaction.active.duration.max` configuration. |
| `mysql.joins` | Sum | 1 | kind | Disabled by default; enable via the receiver's `metrics.mysql.joins` configuration. |
| `mysql.locks` | Sum | 1 | kind | - |
| `mysql.log_operations` | Sum | 1 | operation | - |
| `mysql.max_used_connections` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.max_used_connections` configuration. |
| `mysql.myisam.key_cache.block.unused` | Gauge | `{block}` | - | Disabled by default. |
| `mysql.myisam.key_cache.block.used.max` | Gauge | `{block}` | - | Disabled by default. |
| `mysql.myisam.key_cache.disk.operation` | Sum (cumulative, monotonic) | `{operation}` | `operation` (`read` or `write`) | Disabled by default. |
| `mysql.myisam.key_cache.request` | Sum (cumulative, monotonic) | `{request}` | `operation` (`read` or `write`) | Disabled by default. |
| `mysql.mysqlx_connections` | Sum | 1 | status | - |
| `mysql.mysqlx_worker_threads` | Sum | 1 | kind | Disabled by default; enable via the receiver's `metrics.mysql.mysqlx_worker_threads` configuration. |
| `mysql.opened_resources` | Sum | 1 | kind | - |
| `mysql.operations` | Sum | 1 | operation | - |
| `mysql.page_operations` | Sum | 1 | operation | - |
| `mysql.page_size` | Sum | By | - | Disabled by default; enable via the receiver's `metrics.mysql.page_size` configuration. |
| `mysql.prepared_statements` | Sum | 1 | command | - |
| `mysql.query.client.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.query.client.count` configuration. |
| `mysql.query.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.query.count` configuration. |
| `mysql.query.execution.time` | Sum | s | - | Disabled by default; enable via the receiver's `metrics.mysql.query.execution.time` configuration. Monotonic cumulative sum (double); includes statements issued by the receiver. |
| `mysql.query.slow.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.query.slow.count` configuration. |
| `mysql.replica.sql_delay` | Sum | s | - | Disabled by default; enable via the receiver's `metrics.mysql.replica.sql_delay` configuration. |
| `mysql.replica.temp_table.open` | Gauge | `{table}` | - | Disabled by default; enable via the receiver's `metrics.mysql.replica.temp_table.open` configuration. |
| `mysql.replica.thread.running` | Gauge | 1 | mysql.replica.thread.type, mysql.replica.channel.name | Disabled by default; enable via the receiver's `metrics.mysql.replica.thread.running` configuration. Value is 1 for `Yes`, otherwise 0. |
| `mysql.replica.time_behind_source` | Sum | s | - | Disabled by default; enable via the receiver's `metrics.mysql.replica.time_behind_source` configuration. |
| `mysql.row_locks` | Sum | 1 | kind | - |
| `mysql.row_operations` | Sum | 1 | operation | - |
| `mysql.server.healthy` | Gauge | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.server.healthy` configuration. Value is 1 when the server is reachable, otherwise 0. |
| `mysql.session.active.count` | Gauge | `{session}` | - | Disabled by default; enable via the receiver's `metrics.mysql.session.active.count` configuration. Excludes idle sessions and the receiver's own query. |
| `mysql.sorts` | Sum | 1 | kind | - |
| `mysql.statement_event.count` | Sum | 1 | schema, digest, digest_text, kind | Disabled by default; enable via the receiver's `metrics.mysql.statement_event.count` configuration. |
| `mysql.statement_event.wait.time` | Sum | ns | schema, digest, digest_text | Disabled by default; enable via the receiver's `metrics.mysql.statement_event.wait.time` configuration. |
| `mysql.table.average_row_length` | Sum | By | table, schema | Disabled by default; enable via the receiver's `metrics.mysql.table.average_row_length` configuration. |
| `mysql.table.io.wait.count` | Sum | 1 | operation, table, schema | - |
| `mysql.table.io.wait.time` | Sum | ns | operation, table, schema | - |
| `mysql.table.lock_wait.read.count` | Sum | 1 | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.read.count` configuration. |
| `mysql.table.lock_wait.read.time` | Sum | ns | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.read.time` configuration. |
| `mysql.table.lock_wait.write.count` | Sum | 1 | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.write.count` configuration. |
| `mysql.table.lock_wait.write.time` | Sum | ns | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.write.time` configuration. |
| `mysql.table.open` | Gauge | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.table.open` configuration. |
| `mysql.table.rows` | Sum | 1 | table, schema | Disabled by default; enable via the receiver's `metrics.mysql.table.rows` configuration. |
| `mysql.table.size` | Sum | By | table, schema, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.size` configuration. |
| `mysql.table_open_cache` | Sum | 1 | status | Disabled by default; enable via the receiver's `metrics.mysql.table_open_cache` configuration. |
| `mysql.thread.slow_launch` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.thread.slow_launch` configuration. Monotonic cumulative sum. |
| `mysql.threads` | Sum | 1 | kind | - |
| `mysql.tmp_resources` | Sum | 1 | resource | - |
| `mysql.uptime` | Sum | s | - | - |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `db.server.query_sample` | db.system.name, mysql.threads.thread_id, user.name, db.namespace, mysql.threads.processlist_command, mysql.threads.processlist_state, db.query.text, mysql.events_statements_current.digest, mysql.query_plan, mysql.query_plan.hash, mysql.event_id, mysql.wait_type, mysql.session.status, mysql.session.id, mysql.events_statements_current.timer_wait, mysql.events_waits_current.timer_wait, client.address, client.port, network.peer.address, network.peer.port | Disabled by default; enable via the receiver's `events.db.server.query_sample` configuration. `mysql.events_waits_current.timer_wait` is populated only when the MySQL `events_waits_current` consumer is enabled; trace/span IDs are copied when the query's `@traceparent` context is valid. |
| `db.server.top_query` | db.system.name, db.query.text, mysql.query_plan, mysql.query_plan.hash, mysql.events_statements_summary_by_digest.digest, mysql.events_statements_summary_by_digest.count_star, mysql.events_statements_summary_by_digest.sum_timer_wait | Disabled by default; enable via the receiver's `events.db.server.top_query` configuration. |

## Sources

- `receiver/mysqlreceiver/metadata.yaml`
- `receiver/mysqlreceiver/internal/metadata/generated_metrics.go`
- `receiver/mysqlreceiver/internal/metadata/generated_logs.go`
- `receiver/mysqlreceiver/scraper.go`
- `receiver/mysqlreceiver/README.md`
        • v0.162.0.md 11.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/mysqlreceiver
version: v0.162.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/mysqlreceiver
commit_sha: ae8c507510f48f433ab47dd1c6b01a59d6c388b5
last_verified: 2026-10-03
---

# MySQL Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `mysql.buffer_pool.data_pages` | Sum | 1 | status | - |
| `mysql.buffer_pool.limit` | Sum | By | - | - |
| `mysql.buffer_pool.operations` | Sum | 1 | operation | - |
| `mysql.buffer_pool.page_flushes` | Sum | 1 | - | - |
| `mysql.buffer_pool.pages` | Sum | 1 | kind | - |
| `mysql.buffer_pool.usage` | Sum | By | status | - |
| `mysql.client.network.io` | Sum | By | kind | Disabled by default; enable via the receiver's `metrics.mysql.client.network.io` configuration. |
| `mysql.commands` | Sum | 1 | command | Disabled by default; enable via the receiver's `metrics.mysql.commands` configuration. v0.159.0 adds `alter_table`, `create_index`, `create_table`, and `optimize` command values. |
| `mysql.connection.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.connection.count` configuration. |
| `mysql.connection.errors` | Sum | 1 | error | Disabled by default; enable via the receiver's `metrics.mysql.connection.errors` configuration. |
| `mysql.double_writes` | Sum | 1 | kind | - |
| `mysql.file.open` | Gauge | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.file.open` configuration. |
| `mysql.handlers` | Sum | 1 | kind | - |
| `mysql.index.io.wait.count` | Sum | 1 | operation, table, schema, index | - |
| `mysql.index.io.wait.time` | Sum | ns | operation, table, schema, index | - |
| `mysql.innodb.data_file.io` | Sum | By | disk.io.direction | Disabled by default; enable via the receiver's `metrics.mysql.innodb.data_file.io` configuration. |
| `mysql.innodb.history_list.length` | Gauge | `{transactions}` | - | Disabled by default; enable via the receiver's `metrics.mysql.innodb.history_list.length` configuration. |
| `mysql.innodb.operation.pending` | Sum | 1 | operation | Disabled by default; enable via the receiver's `metrics.mysql.innodb.operation.pending` configuration. Non-monotonic cumulative sum. |
| `mysql.innodb.redo_log.checkpoint.age` | Gauge | By | - | Disabled by default; enable via the receiver's `metrics.mysql.innodb.redo_log.checkpoint.age` configuration. Only emitted for MySQL 8.0.11 and later (8.0.11 through 8.0.29 also require `BACKUP_ADMIN`); not supported on MariaDB. |
| `mysql.innodb.redo_log.lsn.checkpoint` | Gauge | By | - | Disabled by default; enable via the receiver's `metrics.mysql.innodb.redo_log.lsn.checkpoint` configuration. Only emitted for MySQL 8.0.11 and later (8.0.11 through 8.0.29 also require `BACKUP_ADMIN`); not supported on MariaDB. |
| `mysql.innodb.redo_log.lsn.current` | Gauge | By | - | Disabled by default; enable via the receiver's `metrics.mysql.innodb.redo_log.lsn.current` configuration. Only emitted for MySQL 8.0.11 and later (8.0.11 through 8.0.29 also require `BACKUP_ADMIN`); not supported on MariaDB. |
| `mysql.innodb.row_lock.wait.count` | Gauge | `{wait}` | - | Disabled by default. |
| `mysql.innodb.row_lock.wait.duration.avg` | Gauge | `s` | - | Disabled by default. |
| `mysql.innodb.row_lock.wait.duration.max` | Gauge | `s` | - | Disabled by default. |
| `mysql.innodb.transaction.active.count` | Gauge | `{transaction}` | - | Disabled by default; enable via the receiver's `metrics.mysql.innodb.transaction.active.count` configuration. |
| `mysql.innodb.transaction.active.duration.max` | Gauge | s | - | Disabled by default; enable via the receiver's `metrics.mysql.innodb.transaction.active.duration.max` configuration. |
| `mysql.joins` | Sum | 1 | kind | Disabled by default; enable via the receiver's `metrics.mysql.joins` configuration. |
| `mysql.locks` | Sum | 1 | kind | - |
| `mysql.log_operations` | Sum | 1 | operation | - |
| `mysql.max_used_connections` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.max_used_connections` configuration. |
| `mysql.myisam.key_cache.block.unused` | Gauge | `{block}` | - | Disabled by default. |
| `mysql.myisam.key_cache.block.used.max` | Gauge | `{block}` | - | Disabled by default. |
| `mysql.myisam.key_cache.disk.operation` | Sum (cumulative, monotonic) | `{operation}` | `operation` (`read` or `write`) | Disabled by default. |
| `mysql.myisam.key_cache.request` | Sum (cumulative, monotonic) | `{request}` | `operation` (`read` or `write`) | Disabled by default. |
| `mysql.mysqlx_connections` | Sum | 1 | status | - |
| `mysql.mysqlx_worker_threads` | Sum | 1 | kind | Disabled by default; enable via the receiver's `metrics.mysql.mysqlx_worker_threads` configuration. |
| `mysql.opened_resources` | Sum | 1 | kind | - |
| `mysql.operations` | Sum | 1 | operation | - |
| `mysql.page_operations` | Sum | 1 | operation | - |
| `mysql.page_size` | Sum | By | - | Disabled by default; enable via the receiver's `metrics.mysql.page_size` configuration. |
| `mysql.prepared_statements` | Sum | 1 | command | - |
| `mysql.query.client.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.query.client.count` configuration. |
| `mysql.query.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.query.count` configuration. |
| `mysql.query.execution.time` | Sum | s | - | Disabled by default; enable via the receiver's `metrics.mysql.query.execution.time` configuration. Monotonic cumulative sum (double); includes statements issued by the receiver. |
| `mysql.query.slow.count` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.query.slow.count` configuration. |
| `mysql.replica.sql_delay` | Sum | s | - | Disabled by default; enable via the receiver's `metrics.mysql.replica.sql_delay` configuration. |
| `mysql.replica.temp_table.open` | Gauge | `{table}` | - | Disabled by default; enable via the receiver's `metrics.mysql.replica.temp_table.open` configuration. |
| `mysql.replica.thread.running` | Gauge | 1 | mysql.replica.thread.type, mysql.replica.channel.name | Disabled by default; enable via the receiver's `metrics.mysql.replica.thread.running` configuration. Value is 1 for `Yes`, otherwise 0. |
| `mysql.replica.time_behind_source` | Sum | s | - | Disabled by default; enable via the receiver's `metrics.mysql.replica.time_behind_source` configuration. |
| `mysql.row_locks` | Sum | 1 | kind | - |
| `mysql.row_operations` | Sum | 1 | operation | - |
| `mysql.server.healthy` | Gauge | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.server.healthy` configuration. Value is 1 when the server is reachable, otherwise 0. |
| `mysql.session.active.count` | Gauge | `{session}` | - | Disabled by default; enable via the receiver's `metrics.mysql.session.active.count` configuration. Excludes idle sessions and the receiver's own query. |
| `mysql.sorts` | Sum | 1 | kind | - |
| `mysql.statement_event.count` | Sum | 1 | schema, digest, digest_text, kind | Disabled by default; enable via the receiver's `metrics.mysql.statement_event.count` configuration. |
| `mysql.statement_event.wait.time` | Sum | ns | schema, digest, digest_text | Disabled by default; enable via the receiver's `metrics.mysql.statement_event.wait.time` configuration. |
| `mysql.table.average_row_length` | Sum | By | table, schema | Disabled by default; enable via the receiver's `metrics.mysql.table.average_row_length` configuration. |
| `mysql.table.io.wait.count` | Sum | 1 | operation, table, schema | - |
| `mysql.table.io.wait.time` | Sum | ns | operation, table, schema | - |
| `mysql.table.lock_wait.read.count` | Sum | 1 | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.read.count` configuration. |
| `mysql.table.lock_wait.read.time` | Sum | ns | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.read.time` configuration. |
| `mysql.table.lock_wait.write.count` | Sum | 1 | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.write.count` configuration. |
| `mysql.table.lock_wait.write.time` | Sum | ns | schema, table, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.lock_wait.write.time` configuration. |
| `mysql.table.open` | Gauge | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.table.open` configuration. |
| `mysql.table.rows` | Sum | 1 | table, schema | Disabled by default; enable via the receiver's `metrics.mysql.table.rows` configuration. |
| `mysql.table.size` | Sum | By | table, schema, kind | Disabled by default; enable via the receiver's `metrics.mysql.table.size` configuration. |
| `mysql.table_open_cache` | Sum | 1 | status | Disabled by default; enable via the receiver's `metrics.mysql.table_open_cache` configuration. |
| `mysql.thread.slow_launch` | Sum | 1 | - | Disabled by default; enable via the receiver's `metrics.mysql.thread.slow_launch` configuration. Monotonic cumulative sum. |
| `mysql.threads` | Sum | 1 | kind | - |
| `mysql.tmp_resources` | Sum | 1 | resource | - |
| `mysql.uptime` | Sum | s | - | - |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `db.server.query_plan` | db.system.name, mysql.query_plan.hash, db.namespace, mysql.query_plan.source, mysql.query_plan | Disabled by default; enable via the receiver's `events.db.server.query_plan` configuration, which also requires `db.server.top_query` or `db.server.query_sample`. `mysql.query_plan.source` is `db.server.top_query` or `db.server.query_sample`; emitted only for statements with a non-empty plan, once per database and plan hash per query-sample scrape. When enabled, `mysql.query_plan` is removed from `db.server.top_query` and `db.server.query_sample` records. |
| `db.server.query_sample` | db.system.name, mysql.threads.thread_id, user.name, db.namespace, mysql.threads.processlist_command, mysql.threads.processlist_state, db.query.text, mysql.events_statements_current.digest, mysql.query_plan, mysql.query_plan.hash, mysql.event_id, mysql.wait_type, mysql.session.status, mysql.session.id, mysql.events_statements_current.timer_wait, mysql.events_waits_current.timer_wait, client.address, client.port, network.peer.address, network.peer.port | Disabled by default; enable via the receiver's `events.db.server.query_sample` configuration. `mysql.query_plan` is omitted when `db.server.query_plan` is enabled. `mysql.events_waits_current.timer_wait` is populated only when the MySQL `events_waits_current` consumer is enabled; trace/span IDs are copied when the query's `@traceparent` context is valid. |
| `db.server.top_query` | db.system.name, db.namespace, db.query.text, mysql.query_plan, mysql.query_plan.hash, mysql.events_statements_summary_by_digest.digest, mysql.events_statements_summary_by_digest.count_star, mysql.events_statements_summary_by_digest.sum_timer_wait | Disabled by default; enable via the receiver's `events.db.server.top_query` configuration. `mysql.query_plan` is omitted when `db.server.query_plan` is enabled. |

## Sources

- `receiver/mysqlreceiver/metadata.yaml`
- `receiver/mysqlreceiver/internal/metadata/generated_metrics.go`
- `receiver/mysqlreceiver/internal/metadata/generated_logs.go`
- `receiver/mysqlreceiver/scraper.go`
- `receiver/mysqlreceiver/config.go`
- `receiver/mysqlreceiver/README.md`
      • nginxreceiver
        • v0.153.0.md 1023 B 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/nginxreceiver
version: v0.153.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/nginxreceiver
commit_sha: 42f949127580c0d00088b785cd0b35842dc0ddb8
last_verified: 2026-08-11
---

# NGINX Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `nginx.connections_accepted` | Sum (cumulative, monotonic) | `connections` | - | - |
| `nginx.connections_current` | Sum (cumulative, non-monotonic) | `connections` | `state` | - |
| `nginx.connections_handled` | Sum (cumulative, monotonic) | `connections` | - | - |
| `nginx.requests` | Sum (cumulative, monotonic) | `requests` | - | - |

## Sources

- `receiver/nginxreceiver/metadata.yaml`
- `receiver/nginxreceiver/scraper.go`
- `receiver/nginxreceiver/factory.go`
- `receiver/nginxreceiver/config.go`
- `receiver/nginxreceiver/internal/metadata/generated_metrics.go`
- `receiver/nginxreceiver/internal/metadata/generated_status.go`
        • v0.154.0.md 1023 B 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/nginxreceiver
version: v0.154.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/nginxreceiver
commit_sha: 853eda0e12b3ba142552ecd2b63cec07062904f0
last_verified: 2026-08-11
---

# NGINX Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `nginx.connections_accepted` | Sum (cumulative, monotonic) | `connections` | - | - |
| `nginx.connections_current` | Sum (cumulative, non-monotonic) | `connections` | `state` | - |
| `nginx.connections_handled` | Sum (cumulative, monotonic) | `connections` | - | - |
| `nginx.requests` | Sum (cumulative, monotonic) | `requests` | - | - |

## Sources

- `receiver/nginxreceiver/metadata.yaml`
- `receiver/nginxreceiver/scraper.go`
- `receiver/nginxreceiver/factory.go`
- `receiver/nginxreceiver/config.go`
- `receiver/nginxreceiver/internal/metadata/generated_metrics.go`
- `receiver/nginxreceiver/internal/metadata/generated_status.go`
        • v0.155.0.md 1023 B 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/nginxreceiver
version: v0.155.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/nginxreceiver
commit_sha: aaf5045a24c0a6f000225c97ad5449e69aeb5835
last_verified: 2026-08-11
---

# NGINX Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `nginx.connections_accepted` | Sum (cumulative, monotonic) | `connections` | - | - |
| `nginx.connections_current` | Sum (cumulative, non-monotonic) | `connections` | `state` | - |
| `nginx.connections_handled` | Sum (cumulative, monotonic) | `connections` | - | - |
| `nginx.requests` | Sum (cumulative, monotonic) | `requests` | - | - |

## Sources

- `receiver/nginxreceiver/metadata.yaml`
- `receiver/nginxreceiver/scraper.go`
- `receiver/nginxreceiver/factory.go`
- `receiver/nginxreceiver/config.go`
- `receiver/nginxreceiver/internal/metadata/generated_metrics.go`
- `receiver/nginxreceiver/internal/metadata/generated_status.go`
        • v0.156.0.md 1023 B 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/nginxreceiver
version: v0.156.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/nginxreceiver
commit_sha: 41e24cd516dd69a5b4277465cdb2ff4ef0676f49
last_verified: 2026-08-11
---

# NGINX Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `nginx.connections_accepted` | Sum (cumulative, monotonic) | `connections` | - | - |
| `nginx.connections_current` | Sum (cumulative, non-monotonic) | `connections` | `state` | - |
| `nginx.connections_handled` | Sum (cumulative, monotonic) | `connections` | - | - |
| `nginx.requests` | Sum (cumulative, monotonic) | `requests` | - | - |

## Sources

- `receiver/nginxreceiver/metadata.yaml`
- `receiver/nginxreceiver/scraper.go`
- `receiver/nginxreceiver/factory.go`
- `receiver/nginxreceiver/config.go`
- `receiver/nginxreceiver/internal/metadata/generated_metrics.go`
- `receiver/nginxreceiver/internal/metadata/generated_status.go`
        • v0.157.0.md 1 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/nginxreceiver
version: v0.157.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/nginxreceiver
commit_sha: 89e43555904cd97c2d36605347c5d5237b1bdc8c
last_verified: 2026-08-11
---

# NGINX Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `nginx.connections_accepted` | Sum (cumulative, monotonic) | `{connections}` | - | - |
| `nginx.connections_current` | Sum (cumulative, non-monotonic) | `{connections}` | `state` | - |
| `nginx.connections_handled` | Sum (cumulative, monotonic) | `{connections}` | - | - |
| `nginx.requests` | Sum (cumulative, monotonic) | `{requests}` | - | - |

## Sources

- `receiver/nginxreceiver/metadata.yaml`
- `receiver/nginxreceiver/scraper.go`
- `receiver/nginxreceiver/factory.go`
- `receiver/nginxreceiver/config.go`
- `receiver/nginxreceiver/internal/metadata/generated_metrics.go`
- `receiver/nginxreceiver/internal/metadata/generated_status.go`
        • v0.158.0.md 1 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/nginxreceiver
version: v0.158.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/nginxreceiver
commit_sha: 821a9d9c2c1623c4a0ceba5d47b57c48879c3f84
last_verified: 2026-08-11
---

# NGINX Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `nginx.connections_accepted` | Sum (cumulative, monotonic) | `{connections}` | - | - |
| `nginx.connections_current` | Sum (cumulative, non-monotonic) | `{connections}` | `state` | - |
| `nginx.connections_handled` | Sum (cumulative, monotonic) | `{connections}` | - | - |
| `nginx.requests` | Sum (cumulative, monotonic) | `{requests}` | - | - |

## Sources

- `receiver/nginxreceiver/metadata.yaml`
- `receiver/nginxreceiver/scraper.go`
- `receiver/nginxreceiver/factory.go`
- `receiver/nginxreceiver/config.go`
- `receiver/nginxreceiver/internal/metadata/generated_metrics.go`
- `receiver/nginxreceiver/internal/metadata/generated_status.go`
        • v0.159.0.md 1 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/nginxreceiver
version: v0.159.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/nginxreceiver
commit_sha: 1120cc0714bf4d14600105e5673c3b00fe87467a
last_verified: 2026-10-14
---

# NGINX Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `nginx.connections_accepted` | Sum (cumulative, monotonic) | `{connections}` | - | - |
| `nginx.connections_current` | Sum (cumulative, non-monotonic) | `{connections}` | `state` | - |
| `nginx.connections_handled` | Sum (cumulative, monotonic) | `{connections}` | - | - |
| `nginx.requests` | Sum (cumulative, monotonic) | `{requests}` | - | - |

## Sources

- `receiver/nginxreceiver/metadata.yaml`
- `receiver/nginxreceiver/scraper.go`
- `receiver/nginxreceiver/factory.go`
- `receiver/nginxreceiver/config.go`
- `receiver/nginxreceiver/internal/metadata/generated_metrics.go`
- `receiver/nginxreceiver/internal/metadata/generated_status.go`
        • v0.160.0.md 1 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/nginxreceiver
version: v0.160.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/nginxreceiver
commit_sha: 982f20b8a8e8a2569fab3e27cf8b008e8a5080c1
last_verified: 2026-09-03
---

# NGINX Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `nginx.connections_accepted` | Sum (cumulative, monotonic) | `{connections}` | - | - |
| `nginx.connections_current` | Sum (cumulative, non-monotonic) | `{connections}` | `state` | - |
| `nginx.connections_handled` | Sum (cumulative, monotonic) | `{connections}` | - | - |
| `nginx.requests` | Sum (cumulative, monotonic) | `{requests}` | - | - |

## Sources

- `receiver/nginxreceiver/metadata.yaml`
- `receiver/nginxreceiver/scraper.go`
- `receiver/nginxreceiver/factory.go`
- `receiver/nginxreceiver/config.go`
- `receiver/nginxreceiver/internal/metadata/generated_metrics.go`
- `receiver/nginxreceiver/internal/metadata/generated_status.go`
        • v0.161.0.md 1 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/nginxreceiver
version: v0.161.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/nginxreceiver
commit_sha: 3f8455d8038a985398861171e5310bc9b4e988b2
last_verified: 2026-10-03
---

# NGINX Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `nginx.connections_accepted` | Sum (cumulative, monotonic) | `{connections}` | - | - |
| `nginx.connections_current` | Sum (cumulative, non-monotonic) | `{connections}` | `state` | - |
| `nginx.connections_handled` | Sum (cumulative, monotonic) | `{connections}` | - | - |
| `nginx.requests` | Sum (cumulative, monotonic) | `{requests}` | - | - |

## Sources

- `receiver/nginxreceiver/metadata.yaml`
- `receiver/nginxreceiver/scraper.go`
- `receiver/nginxreceiver/factory.go`
- `receiver/nginxreceiver/config.go`
- `receiver/nginxreceiver/internal/metadata/generated_metrics.go`
- `receiver/nginxreceiver/internal/metadata/generated_status.go`
        • v0.162.0.md 1 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/nginxreceiver
version: v0.162.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/nginxreceiver
commit_sha: ae8c507510f48f433ab47dd1c6b01a59d6c388b5
last_verified: 2026-10-03
---

# NGINX Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `nginx.connections_accepted` | Sum (cumulative, monotonic) | `{connections}` | - | - |
| `nginx.connections_current` | Sum (cumulative, non-monotonic) | `{connections}` | `state` | - |
| `nginx.connections_handled` | Sum (cumulative, monotonic) | `{connections}` | - | - |
| `nginx.requests` | Sum (cumulative, monotonic) | `{requests}` | - | - |

## Sources

- `receiver/nginxreceiver/metadata.yaml`
- `receiver/nginxreceiver/scraper.go`
- `receiver/nginxreceiver/factory.go`
- `receiver/nginxreceiver/config.go`
- `receiver/nginxreceiver/internal/metadata/generated_metrics.go`
- `receiver/nginxreceiver/internal/metadata/generated_status.go`
        • v0.163.0.md 1 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/nginxreceiver
version: v0.163.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/nginxreceiver
commit_sha: df849b5403c041d5e799e7846392a6f18b0b55ae
last_verified: 2026-10-14
---

# NGINX Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `nginx.connections_accepted` | Sum (cumulative, monotonic) | `{connections}` | - | - |
| `nginx.connections_current` | Sum (cumulative, non-monotonic) | `{connections}` | `state` | - |
| `nginx.connections_handled` | Sum (cumulative, monotonic) | `{connections}` | - | - |
| `nginx.requests` | Sum (cumulative, monotonic) | `{requests}` | - | - |

## Sources

- `receiver/nginxreceiver/metadata.yaml`
- `receiver/nginxreceiver/scraper.go`
- `receiver/nginxreceiver/factory.go`
- `receiver/nginxreceiver/config.go`
- `receiver/nginxreceiver/internal/metadata/generated_metrics.go`
- `receiver/nginxreceiver/internal/metadata/generated_status.go`
      • postgresqlreceiver
        • v0.153.0.md 4.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/postgresqlreceiver
version: v0.153.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/postgresqlreceiver
commit_sha: 42f949127580c0d00088b785cd0b35842dc0ddb8
last_verified: 2026-08-11
---

# PostgreSQL Receiver
## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `postgresql.backends` | Sum | 1 | - | - |
| `postgresql.bgwriter.buffers.allocated` | Sum | {buffers} | - | - |
| `postgresql.bgwriter.buffers.writes` | Sum | {buffers} | source | - |
| `postgresql.bgwriter.checkpoint.count` | Sum | {checkpoints} | type | - |
| `postgresql.bgwriter.duration` | Sum | ms | type | - |
| `postgresql.bgwriter.maxwritten` | Sum | 1 | - | - |
| `postgresql.blks_hit` | Sum | {blks_hit} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.blks_read` | Sum | {blks_read} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.blocks_read` | Sum | 1 | source | - |
| `postgresql.commits` | Sum | 1 | - | - |
| `postgresql.connection.max` | Gauge | {connections} | - | - |
| `postgresql.database.count` | Sum | {databases} | - | - |
| `postgresql.database.locks` | Gauge | {lock} | relation, mode, lock_type | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.db_size` | Sum | By | - | - |
| `postgresql.deadlocks` | Sum | {deadlock} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.function.calls` | Sum | {call} | function | Disabled by default; enable this metric in receiver.metrics. Requires track_functions=pl|all. |
| `postgresql.index.scans` | Sum | {scans} | - | - |
| `postgresql.index.size` | Gauge | By | - | - |
| `postgresql.operations` | Sum | 1 | operation | - |
| `postgresql.replication.data_delay` | Gauge | By | replication_client | Requires WAL and at least one replica. |
| `postgresql.rollbacks` | Sum | 1 | - | - |
| `postgresql.rows` | Sum | 1 | state | - |
| `postgresql.sequential_scans` | Sum | {sequential_scan} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.table.count` | Sum | {table} | - | - |
| `postgresql.table.size` | Sum | By | - | - |
| `postgresql.table.vacuum.count` | Sum | {vacuum} | - | - |
| `postgresql.temp.io` | Sum | By | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.temp_files` | Sum | {temp_file} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.tup_deleted` | Sum | {tup_deleted} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.tup_fetched` | Sum | {tup_fetched} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.tup_inserted` | Sum | {tup_inserted} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.tup_returned` | Sum | {tup_returned} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.tup_updated` | Sum | {tup_updated} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.wal.age` | Gauge | s | - | Requires WAL and at least one replica. |
| `postgresql.wal.delay` | Gauge | s | operation, replication_client | Disabled by default; enable this metric in receiver.metrics. Requires WAL and at least one replica. Emitted only when receiver.postgresql.preciselagmetrics is enabled. |
| `postgresql.wal.lag` | Gauge | s | operation, replication_client | Requires WAL and at least one replica. Emitted only when receiver.postgresql.preciselagmetrics is disabled; the precise postgresql.wal.delay metric is emitted when the gate is enabled. |


## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `db.server.query_sample` | db.system.name, db.namespace, db.query.text, user.name, postgresql.state, postgresql.pid, postgresql.application_name, network.peer.address, network.peer.port, postgresql.client_hostname, postgresql.query_start, postgresql.wait_event, postgresql.wait_event_type, postgresql.query_id, postgresql.total_exec_time | Disabled by default; enable the event in receiver.logs. Query samples may carry trace/span IDs when application_name contains a valid W3C traceparent. |
| `db.server.top_query` | db.system.name, db.namespace, db.query.text, postgresql.calls, postgresql.rows, postgresql.shared_blks_dirtied, postgresql.shared_blks_hit, postgresql.shared_blks_read, postgresql.shared_blks_written, postgresql.temp_blks_read, postgresql.temp_blks_written, postgresql.queryid, postgresql.rolname, postgresql.total_exec_time, postgresql.total_plan_time, postgresql.query_plan | Disabled by default; enable the event in receiver.logs. |

## Sources

- receiver/postgresqlreceiver/metadata.yaml
- receiver/postgresqlreceiver/scraper.go
- receiver/postgresqlreceiver/client.go
- receiver/postgresqlreceiver/factory.go
- receiver/postgresqlreceiver/internal/metadata/generated_metrics.go
- receiver/postgresqlreceiver/internal/metadata/generated_logs.go
        • v0.154.0.md 4.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/postgresqlreceiver
version: v0.154.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/postgresqlreceiver
commit_sha: 853eda0e12b3ba142552ecd2b63cec07062904f0
last_verified: 2026-08-11
---

# PostgreSQL Receiver
## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `postgresql.backends` | Sum | 1 | - | - |
| `postgresql.bgwriter.buffers.allocated` | Sum | {buffers} | - | - |
| `postgresql.bgwriter.buffers.writes` | Sum | {buffers} | source | - |
| `postgresql.bgwriter.checkpoint.count` | Sum | {checkpoints} | type | - |
| `postgresql.bgwriter.duration` | Sum | ms | type | - |
| `postgresql.bgwriter.maxwritten` | Sum | 1 | - | - |
| `postgresql.blks_hit` | Sum | {blks_hit} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.blks_read` | Sum | {blks_read} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.blocks_read` | Sum | 1 | source | - |
| `postgresql.commits` | Sum | 1 | - | - |
| `postgresql.connection.max` | Gauge | {connections} | - | - |
| `postgresql.database.count` | Sum | {databases} | - | - |
| `postgresql.database.locks` | Gauge | {lock} | relation, mode, lock_type | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.db_size` | Sum | By | - | - |
| `postgresql.deadlocks` | Sum | {deadlock} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.function.calls` | Sum | {call} | function | Disabled by default; enable this metric in receiver.metrics. Requires track_functions=pl|all. |
| `postgresql.index.scans` | Sum | {scans} | - | - |
| `postgresql.index.size` | Gauge | By | - | - |
| `postgresql.operations` | Sum | 1 | operation | - |
| `postgresql.replication.data_delay` | Gauge | By | replication_client | Requires WAL and at least one replica. |
| `postgresql.rollbacks` | Sum | 1 | - | - |
| `postgresql.rows` | Sum | 1 | state | - |
| `postgresql.sequential_scans` | Sum | {sequential_scan} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.table.count` | Sum | {table} | - | - |
| `postgresql.table.size` | Sum | By | - | - |
| `postgresql.table.vacuum.count` | Sum | {vacuum} | - | - |
| `postgresql.temp.io` | Sum | By | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.temp_files` | Sum | {temp_file} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.tup_deleted` | Sum | {tup_deleted} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.tup_fetched` | Sum | {tup_fetched} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.tup_inserted` | Sum | {tup_inserted} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.tup_returned` | Sum | {tup_returned} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.tup_updated` | Sum | {tup_updated} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.wal.age` | Gauge | s | - | Requires WAL and at least one replica. |
| `postgresql.wal.delay` | Gauge | s | operation, replication_client | Disabled by default; enable this metric in receiver.metrics. Requires WAL and at least one replica. Emitted only when receiver.postgresql.preciselagmetrics is enabled. |
| `postgresql.wal.lag` | Gauge | s | operation, replication_client | Requires WAL and at least one replica. Emitted only when receiver.postgresql.preciselagmetrics is disabled; the precise postgresql.wal.delay metric is emitted when the gate is enabled. |


## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `db.server.query_sample` | db.system.name, db.namespace, db.query.text, user.name, postgresql.state, postgresql.pid, postgresql.application_name, network.peer.address, network.peer.port, postgresql.client_hostname, postgresql.query_start, postgresql.wait_event, postgresql.wait_event_type, postgresql.query_id, postgresql.total_exec_time | Disabled by default; enable the event in receiver.logs. Query samples may carry trace/span IDs when application_name contains a valid W3C traceparent. |
| `db.server.top_query` | db.system.name, db.namespace, db.query.text, postgresql.calls, postgresql.rows, postgresql.shared_blks_dirtied, postgresql.shared_blks_hit, postgresql.shared_blks_read, postgresql.shared_blks_written, postgresql.temp_blks_read, postgresql.temp_blks_written, postgresql.queryid, postgresql.rolname, postgresql.total_exec_time, postgresql.total_plan_time, postgresql.query_plan | Disabled by default; enable the event in receiver.logs. |

## Sources

- receiver/postgresqlreceiver/metadata.yaml
- receiver/postgresqlreceiver/scraper.go
- receiver/postgresqlreceiver/client.go
- receiver/postgresqlreceiver/factory.go
- receiver/postgresqlreceiver/internal/metadata/generated_metrics.go
- receiver/postgresqlreceiver/internal/metadata/generated_logs.go
        • v0.155.0.md 4.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/postgresqlreceiver
version: v0.155.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/postgresqlreceiver
commit_sha: aaf5045a24c0a6f000225c97ad5449e69aeb5835
last_verified: 2026-08-11
---

# PostgreSQL Receiver
## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `postgresql.backends` | Sum | 1 | - | - |
| `postgresql.bgwriter.buffers.allocated` | Sum | {buffers} | - | - |
| `postgresql.bgwriter.buffers.writes` | Sum | {buffers} | source | - |
| `postgresql.bgwriter.checkpoint.count` | Sum | {checkpoints} | type | - |
| `postgresql.bgwriter.duration` | Sum | ms | type | - |
| `postgresql.bgwriter.maxwritten` | Sum | 1 | - | - |
| `postgresql.blks_hit` | Sum | {blks_hit} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.blks_read` | Sum | {blks_read} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.blocks_read` | Sum | 1 | source | - |
| `postgresql.commits` | Sum | 1 | - | - |
| `postgresql.connection.max` | Gauge | {connections} | - | - |
| `postgresql.database.count` | Sum | {databases} | - | - |
| `postgresql.database.locks` | Gauge | {lock} | relation, mode, lock_type | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.db_size` | Sum | By | - | - |
| `postgresql.deadlocks` | Sum | {deadlock} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.function.calls` | Sum | {call} | function | Disabled by default; enable this metric in receiver.metrics. Requires track_functions=pl|all. |
| `postgresql.index.scans` | Sum | {scans} | - | - |
| `postgresql.index.size` | Gauge | By | - | - |
| `postgresql.operations` | Sum | 1 | operation | - |
| `postgresql.replication.data_delay` | Gauge | By | replication_client | Requires WAL and at least one replica. |
| `postgresql.rollbacks` | Sum | 1 | - | - |
| `postgresql.rows` | Sum | 1 | state | - |
| `postgresql.sequential_scans` | Sum | {sequential_scan} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.table.count` | Sum | {table} | - | - |
| `postgresql.table.size` | Sum | By | - | - |
| `postgresql.table.vacuum.count` | Sum | {vacuum} | - | - |
| `postgresql.temp.io` | Sum | By | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.temp_files` | Sum | {temp_file} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.tup_deleted` | Sum | {tup_deleted} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.tup_fetched` | Sum | {tup_fetched} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.tup_inserted` | Sum | {tup_inserted} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.tup_returned` | Sum | {tup_returned} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.tup_updated` | Sum | {tup_updated} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.wal.age` | Gauge | s | - | Requires WAL and at least one replica. |
| `postgresql.wal.delay` | Gauge | s | operation, replication_client | Disabled by default; enable this metric in receiver.metrics. Requires WAL and at least one replica. Emitted only when receiver.postgresql.preciselagmetrics is enabled. |
| `postgresql.wal.lag` | Gauge | s | operation, replication_client | Requires WAL and at least one replica. Emitted only when receiver.postgresql.preciselagmetrics is disabled; the precise postgresql.wal.delay metric is emitted when the gate is enabled. |


## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `db.server.query_sample` | db.system.name, db.namespace, db.query.text, user.name, postgresql.state, postgresql.pid, postgresql.application_name, network.peer.address, network.peer.port, postgresql.client_hostname, postgresql.query_start, postgresql.wait_event, postgresql.wait_event_type, postgresql.query_id, postgresql.total_exec_time | Disabled by default; enable the event in receiver.logs. Query samples may carry trace/span IDs when application_name contains a valid W3C traceparent. |
| `db.server.top_query` | db.system.name, db.namespace, db.query.text, postgresql.calls, postgresql.rows, postgresql.shared_blks_dirtied, postgresql.shared_blks_hit, postgresql.shared_blks_read, postgresql.shared_blks_written, postgresql.temp_blks_read, postgresql.temp_blks_written, postgresql.queryid, postgresql.rolname, postgresql.total_exec_time, postgresql.total_plan_time, postgresql.query_plan | Disabled by default; enable the event in receiver.logs. |

## Sources

- receiver/postgresqlreceiver/metadata.yaml
- receiver/postgresqlreceiver/scraper.go
- receiver/postgresqlreceiver/client.go
- receiver/postgresqlreceiver/factory.go
- receiver/postgresqlreceiver/internal/metadata/generated_metrics.go
- receiver/postgresqlreceiver/internal/metadata/generated_logs.go
        • v0.156.0.md 5.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/postgresqlreceiver
version: v0.156.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/postgresqlreceiver
commit_sha: 41e24cd516dd69a5b4277465cdb2ff4ef0676f49
last_verified: 2026-08-06
---

# PostgreSQL Receiver
## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `postgresql.backends` | Sum | 1 | - | - |
| `postgresql.bgwriter.buffers.allocated` | Sum | {buffers} | - | - |
| `postgresql.bgwriter.buffers.writes` | Sum | {buffers} | source | - |
| `postgresql.bgwriter.checkpoint.count` | Sum | {checkpoints} | type | - |
| `postgresql.bgwriter.duration` | Sum | ms | type | - |
| `postgresql.bgwriter.maxwritten` | Sum | 1 | - | - |
| `postgresql.blks_hit` | Sum | {blks_hit} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.blks_read` | Sum | {blks_read} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.blocks_read` | Sum | 1 | source | - |
| `postgresql.commits` | Sum | 1 | - | - |
| `postgresql.connection.max` | Gauge | {connections} | - | - |
| `postgresql.database.count` | Sum | {databases} | - | - |
| `postgresql.database.locks` | Gauge | {lock} | relation, mode, lock_type | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.db_size` | Sum | By | - | - |
| `postgresql.deadlocks` | Sum | {deadlock} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.function.calls` | Sum | {call} | function | Disabled by default; enable this metric in receiver.metrics. Requires track_functions=pl|all. |
| `postgresql.index.scans` | Sum | {scans} | - | - |
| `postgresql.index.size` | Gauge | By | - | - |
| `postgresql.operations` | Sum | 1 | operation | - |
| `postgresql.replication.data_delay` | Gauge | By | replication_client | Requires WAL and at least one replica. |
| `postgresql.rollbacks` | Sum | 1 | - | - |
| `postgresql.rows` | Sum | 1 | state | - |
| `postgresql.sequential_scans` | Sum | {sequential_scan} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.table.count` | Sum | {table} | - | - |
| `postgresql.table.size` | Sum | By | - | - |
| `postgresql.table.vacuum.count` | Sum | {vacuum} | - | - |
| `postgresql.temp.io` | Sum | By | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.temp_files` | Sum | {temp_file} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.tup_deleted` | Sum | {tup_deleted} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.tup_fetched` | Sum | {tup_fetched} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.tup_inserted` | Sum | {tup_inserted} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.tup_returned` | Sum | {tup_returned} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.tup_updated` | Sum | {tup_updated} | - | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.wal.age` | Gauge | s | - | Requires WAL and at least one replica. |
| `postgresql.wal.delay` | Gauge | s | operation, replication_client | Disabled by default; enable this metric in receiver.metrics. Requires WAL and at least one replica. Emitted only when receiver.postgresql.preciselagmetrics is enabled. |
| `postgresql.wal.lag` | Gauge | s | operation, replication_client | Requires WAL and at least one replica. Emitted only when receiver.postgresql.preciselagmetrics is disabled; the precise postgresql.wal.delay metric is emitted when the gate is enabled. |


## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `db.server.query_sample` | db.system.name, db.namespace, db.query.text, user.name, postgresql.state, postgresql.pid, postgresql.application_name, network.peer.address, network.peer.port, postgresql.client_hostname, postgresql.query_start, postgresql.wait_event, postgresql.wait_event_type, postgresql.query_id, postgresql.total_exec_time, postgresql.blocking.pids, postgresql.blocking.start_time, postgresql.blocking.wait_duration, postgresql.blocking.lock.mode, postgresql.blocking.lock.type, postgresql.blocking.lock.relation, postgresql.blocking.transaction.start_time | Disabled by default; enable the event in receiver.logs. Query samples may carry trace/span IDs when application_name contains a valid W3C traceparent. |
| `db.server.top_query` | db.system.name, db.namespace, db.query.text, postgresql.calls, postgresql.rows, postgresql.shared_blks_dirtied, postgresql.shared_blks_hit, postgresql.shared_blks_read, postgresql.shared_blks_written, postgresql.temp_blks_read, postgresql.temp_blks_written, postgresql.queryid, postgresql.rolname, postgresql.total_exec_time, postgresql.total_plan_time, postgresql.query_plan | Disabled by default; enable the event in receiver.logs. |

## Sources

- receiver/postgresqlreceiver/metadata.yaml
- receiver/postgresqlreceiver/scraper.go
- receiver/postgresqlreceiver/client.go
- receiver/postgresqlreceiver/factory.go
- receiver/postgresqlreceiver/internal/metadata/generated_metrics.go
- receiver/postgresqlreceiver/internal/metadata/generated_logs.go
        • v0.157.0.md 9.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/postgresqlreceiver
version: v0.157.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/postgresqlreceiver
commit_sha: 89e43555904cd97c2d36605347c5d5237b1bdc8c
last_verified: 2026-08-06
---

# PostgreSQL Receiver
## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `postgresql.backends` | Sum | 1 | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.bgwriter.buffers.allocated` | Sum | {buffers} | - | - |
| `postgresql.bgwriter.buffers.writes` | Sum | {buffers} | source | - |
| `postgresql.bgwriter.checkpoint.count` | Sum | {checkpoints} | type | - |
| `postgresql.bgwriter.duration` | Sum | ms | type | - |
| `postgresql.bgwriter.maxwritten` | Sum | 1 | - | - |
| `postgresql.blks_hit` | Sum | {blks_hit} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.blks_read` | Sum | {blks_read} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.blocks_read` | Sum | 1 | source, db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.commits` | Sum | 1 | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.connection.max` | Gauge | {connections} | - | - |
| `postgresql.database.count` | Sum | {databases} | - | - |
| `postgresql.database.locks` | Gauge | {lock} | relation, mode, lock_type | Disabled by default; enable this metric in receiver.metrics. |
| `postgresql.db_size` | Sum | By | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.deadlocks` | Sum | {deadlock} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.function.calls` | Sum | {call} | function, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires track_functions=pl|all. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.index.scans` | Sum | {scans} | db.namespace, db.collection.name, postgresql.index.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.index.size` | Gauge | By | db.namespace, db.collection.name, postgresql.index.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.operations` | Sum | 1 | operation, db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.query.conflicts` | Sum | {query} | postgresql.conflict.type, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires standby recovery statistics; otherwise may be zero. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.replication.data_delay` | Gauge | By | replication_client | Requires WAL and at least one replica. |
| `postgresql.rollbacks` | Sum | 1 | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.rows` | Sum | 1 | state, db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.sequential_scans` | Sum | {sequential_scan} | db.namespace, db.collection.name | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.table.count` | Sum | {table} | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.table.size` | Sum | By | db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.table.vacuum.count` | Sum | {vacuum} | db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.temp.io` | Sum | By | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.temp_files` | Sum | {temp_file} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_deleted` | Sum | {tup_deleted} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_fetched` | Sum | {tup_fetched} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_inserted` | Sum | {tup_inserted} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_returned` | Sum | {tup_returned} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_updated` | Sum | {tup_updated} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.wal.age` | Gauge | s | - | Requires WAL and at least one replica. |
| `postgresql.wal.delay` | Gauge | s | operation, replication_client | Disabled by default; enable this metric in receiver.metrics. Requires WAL and at least one replica. Emitted only when receiver.postgresql.preciselagmetrics is enabled. |
| `postgresql.wal.lag` | Gauge | s | operation, replication_client | Requires WAL and at least one replica. Emitted only when receiver.postgresql.preciselagmetrics is disabled; the precise postgresql.wal.delay metric is emitted when the gate is enabled. |


## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `db.server.query_sample` | db.system.name, db.namespace, db.query.text, user.name, postgresql.state, postgresql.pid, postgresql.application_name, network.peer.address, network.peer.port, postgresql.client_hostname, postgresql.query_start, postgresql.wait_event, postgresql.wait_event_type, postgresql.query_id, postgresql.total_exec_time, postgresql.blocking.pids, postgresql.blocking.start_time, postgresql.blocking.wait_duration, postgresql.blocking.lock.mode, postgresql.blocking.lock.type, postgresql.blocking.lock.relation, postgresql.blocking.transaction.start_time | Disabled by default; enable the event in receiver.logs. Query samples may carry trace/span IDs when application_name contains a valid W3C traceparent. |
| `db.server.top_query` | db.system.name, db.namespace, db.query.text, postgresql.calls, postgresql.rows, postgresql.shared_blks_dirtied, postgresql.shared_blks_hit, postgresql.shared_blks_read, postgresql.shared_blks_written, postgresql.temp_blks_read, postgresql.temp_blks_written, postgresql.queryid, postgresql.rolname, postgresql.total_exec_time, postgresql.total_plan_time, postgresql.query_plan | Disabled by default; enable the event in receiver.logs. |

## Sources

- receiver/postgresqlreceiver/metadata.yaml
- receiver/postgresqlreceiver/scraper.go
- receiver/postgresqlreceiver/client.go
- receiver/postgresqlreceiver/factory.go
- receiver/postgresqlreceiver/internal/metadata/generated_metrics.go
- receiver/postgresqlreceiver/internal/metadata/generated_logs.go
        • v0.158.0.md 11.7 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/postgresqlreceiver
version: v0.158.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/postgresqlreceiver
commit_sha: 821a9d9c2c1623c4a0ceba5d47b57c48879c3f84
last_verified: 2026-08-06
---

# PostgreSQL Receiver
## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `postgresql.backends` | Sum | 1 | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.bgwriter.buffers.allocated` | Sum | {buffers} | - | - |
| `postgresql.bgwriter.buffers.writes` | Sum | {buffers} | source | - |
| `postgresql.bgwriter.checkpoint.count` | Sum | {checkpoints} | type | - |
| `postgresql.bgwriter.duration` | Sum | ms | type | - |
| `postgresql.bgwriter.maxwritten` | Sum | 1 | - | - |
| `postgresql.blks_hit` | Sum | {blks_hit} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.blks_read` | Sum | {blks_read} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.blocks_read` | Sum | 1 | source, db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.commits` | Sum | 1 | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.connection.max` | Gauge | {connections} | - | - |
| `postgresql.database.count` | Sum | {databases} | - | - |
| `postgresql.database.locks` | Gauge | {lock} | relation, mode, lock_type, db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.db_size` | Sum | By | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.deadlocks` | Sum | {deadlock} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.function.calls` | Sum | {call} | function, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires track_functions=pl|all. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.index.scans` | Sum | {scans} | db.namespace, db.collection.name, postgresql.index.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.index.size` | Gauge | By | db.namespace, db.collection.name, postgresql.index.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.operations` | Sum | 1 | operation, db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.query.conflicts` | Sum | {query} | postgresql.conflict.type, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires standby recovery statistics; otherwise may be zero. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.query.execution.time` | Sum | s | db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.replication.data_delay` | Gauge | By | replication_client | Requires WAL and at least one replica. |
| `postgresql.rollbacks` | Sum | 1 | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.rows` | Sum | 1 | state, db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.sequential_scans` | Sum | {sequential_scan} | db.namespace, db.collection.name | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.table.count` | Sum | {table} | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.table.size` | Sum | By | db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.table.vacuum.count` | Sum | {vacuum} | db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.temp.io` | Sum | By | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.temp_files` | Sum | {temp_file} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_deleted` | Sum | {tup_deleted} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_fetched` | Sum | {tup_fetched} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_inserted` | Sum | {tup_inserted} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_returned` | Sum | {tup_returned} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_updated` | Sum | {tup_updated} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.vector.insert.duration` | Sum | s | db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Requires pgvector and pg_stat_statements; PostgreSQL 13+. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.vector.insert.rows` | Sum | {vectors} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Requires pgvector and pg_stat_statements; PostgreSQL 13+. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.vector.search.calls` | Sum | {search} | postgresql.distance.function.name, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Requires pgvector and pg_stat_statements; PostgreSQL 13+. Vector metrics are opt-in via receiver.metrics; distance classification depends on pgvector query syntax. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.vector.search.duration` | Sum | s | postgresql.distance.function.name, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Requires pgvector and pg_stat_statements; PostgreSQL 13+. Vector metrics are opt-in via receiver.metrics; distance classification depends on pgvector query syntax. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.vector.search.rows_returned` | Sum | {rows} | postgresql.distance.function.name, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Requires pgvector and pg_stat_statements; PostgreSQL 13+. Vector metrics are opt-in via receiver.metrics; distance classification depends on pgvector query syntax. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.wal.age` | Gauge | s | - | Requires WAL and at least one replica. |
| `postgresql.wal.delay` | Gauge | s | operation, replication_client | Disabled by default; enable this metric in receiver.metrics. Requires WAL and at least one replica. Emitted only when receiver.postgresql.preciselagmetrics is enabled. |
| `postgresql.wal.lag` | Gauge | s | operation, replication_client | Requires WAL and at least one replica. Emitted only when receiver.postgresql.preciselagmetrics is disabled; the precise postgresql.wal.delay metric is emitted when the gate is enabled. |


## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `db.server.query_sample` | db.system.name, db.namespace, db.query.text, user.name, postgresql.state, postgresql.pid, postgresql.application_name, network.peer.address, network.peer.port, postgresql.client_hostname, postgresql.query_start, postgresql.wait_event, postgresql.wait_event_type, postgresql.query_id, postgresql.total_exec_time, postgresql.blocking.pids, postgresql.blocking.start_time, postgresql.blocking.wait_duration, postgresql.blocking.lock.mode, postgresql.blocking.lock.type, postgresql.blocking.lock.relation, postgresql.blocking.transaction.start_time | Disabled by default; enable the event in receiver.logs. Query samples may carry trace/span IDs when application_name contains a valid W3C traceparent. |
| `db.server.top_query` | db.system.name, db.namespace, db.query.text, postgresql.calls, postgresql.rows, postgresql.shared_blks_dirtied, postgresql.shared_blks_hit, postgresql.shared_blks_read, postgresql.shared_blks_written, postgresql.temp_blks_read, postgresql.temp_blks_written, postgresql.queryid, postgresql.rolname, postgresql.total_exec_time, postgresql.total_plan_time, postgresql.query_plan | Disabled by default; enable the event in receiver.logs. |

## Sources

- receiver/postgresqlreceiver/metadata.yaml
- receiver/postgresqlreceiver/scraper.go
- receiver/postgresqlreceiver/client.go
- receiver/postgresqlreceiver/factory.go
- receiver/postgresqlreceiver/internal/metadata/generated_metrics.go
- receiver/postgresqlreceiver/internal/metadata/generated_logs.go
        • v0.159.0.md 11.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/postgresqlreceiver
version: v0.159.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/postgresqlreceiver
commit_sha: 1120cc0714bf4d14600105e5673c3b00fe87467a
last_verified: 2026-08-26
---

# PostgreSQL Receiver
## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `postgresql.backends` | Sum | 1 | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.bgwriter.buffers.allocated` | Sum | {buffers} | - | - |
| `postgresql.bgwriter.buffers.writes` | Sum | {buffers} | source | - |
| `postgresql.bgwriter.checkpoint.count` | Sum | {checkpoints} | type | - |
| `postgresql.bgwriter.duration` | Sum | ms | type | - |
| `postgresql.bgwriter.maxwritten` | Sum | 1 | - | - |
| `postgresql.blks_hit` | Sum | {blks_hit} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.blks_read` | Sum | {blks_read} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.blocks_read` | Sum | 1 | source, db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.commits` | Sum | 1 | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.connection.max` | Gauge | {connections} | - | - |
| `postgresql.database.count` | Sum | {databases} | - | - |
| `postgresql.database.locks` | Gauge | {lock} | relation, mode, lock_type, db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.db_size` | Sum | By | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.deadlocks` | Sum | {deadlock} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.function.calls` | Sum | {call} | function, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires track_functions=pl|all. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.index.scans` | Sum | {scans} | db.namespace, db.collection.name, postgresql.index.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.index.size` | Gauge | By | db.namespace, db.collection.name, postgresql.index.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.operations` | Sum | 1 | operation, db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.query.conflicts` | Sum | {query} | postgresql.conflict.type, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires standby recovery statistics; otherwise may be zero. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.query.execution.time` | Sum | s | db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.replication.data_delay` | Gauge | By | replication_client | Requires WAL and at least one replica. |
| `postgresql.rollbacks` | Sum | 1 | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.rows` | Sum | 1 | state, db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.sequential_scans` | Sum | {sequential_scan} | db.namespace, db.collection.name | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.table.count` | Sum | {table} | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.table.size` | Sum | By | db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.table.vacuum.count` | Sum | {vacuum} | db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.temp.io` | Sum | By | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.temp_files` | Sum | {temp_file} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_deleted` | Sum | {tup_deleted} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_fetched` | Sum | {tup_fetched} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_inserted` | Sum | {tup_inserted} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_returned` | Sum | {tup_returned} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_updated` | Sum | {tup_updated} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.vector.insert.duration` | Sum | s | db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Requires pgvector and pg_stat_statements; PostgreSQL 13+. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.vector.insert.rows` | Sum | {vectors} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Requires pgvector and pg_stat_statements; PostgreSQL 13+. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.vector.search.calls` | Sum | {search} | postgresql.distance.function.name, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Requires pgvector and pg_stat_statements; PostgreSQL 13+. Vector metrics are opt-in via receiver.metrics; distance classification depends on pgvector query syntax. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.vector.search.duration` | Sum | s | postgresql.distance.function.name, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Requires pgvector and pg_stat_statements; PostgreSQL 13+. Vector metrics are opt-in via receiver.metrics; distance classification depends on pgvector query syntax. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.vector.search.rows_returned` | Sum | {rows} | postgresql.distance.function.name, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Requires pgvector and pg_stat_statements; PostgreSQL 13+. Vector metrics are opt-in via receiver.metrics; distance classification depends on pgvector query syntax. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.wal.age` | Gauge | s | - | Requires WAL and at least one replica. |
| `postgresql.wal.delay` | Gauge | s | operation, replication_client | Disabled by default; enable this metric in receiver.metrics. Requires WAL and at least one replica. Emitted only when receiver.postgresql.preciselagmetrics is enabled. |
| `postgresql.wal.lag` | Gauge | s | operation, replication_client | Requires WAL and at least one replica. Emitted only when receiver.postgresql.preciselagmetrics is disabled; the precise postgresql.wal.delay metric is emitted when the gate is enabled. |


## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `db.server.query_sample` | db.system.name, db.namespace, db.query.text, user.name, postgresql.state, postgresql.pid, postgresql.application_name, network.peer.address, network.peer.port, postgresql.client_hostname, postgresql.query_start, postgresql.wait_event, postgresql.wait_event_type, postgresql.query_id, postgresql.total_exec_time, postgresql.blocking.pids, postgresql.blocking.start_time, postgresql.blocking.wait_duration, postgresql.blocking.lock.mode, postgresql.blocking.lock.type, postgresql.blocking.lock.relation, postgresql.blocking.transaction.start_time | Disabled by default; enable the event in receiver.logs. `postgresql.total_exec_time` is expressed in seconds. Query samples may carry trace/span IDs when application_name contains a valid W3C traceparent. |
| `db.server.top_query` | db.system.name, db.namespace, db.query.text, postgresql.calls, postgresql.rows, postgresql.shared_blks_dirtied, postgresql.shared_blks_hit, postgresql.shared_blks_read, postgresql.shared_blks_written, postgresql.temp_blks_read, postgresql.temp_blks_written, postgresql.queryid, postgresql.rolname, postgresql.total_exec_time, postgresql.total_plan_time, postgresql.query_plan | Disabled by default; enable the event in receiver.logs. `postgresql.total_exec_time` and `postgresql.total_plan_time` are expressed in seconds. |

## Sources

- receiver/postgresqlreceiver/metadata.yaml
- receiver/postgresqlreceiver/scraper.go
- receiver/postgresqlreceiver/client.go
- receiver/postgresqlreceiver/factory.go
- receiver/postgresqlreceiver/internal/metadata/generated_metrics.go
- receiver/postgresqlreceiver/internal/metadata/generated_logs.go
        • v0.160.0.md 11.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/postgresqlreceiver
version: v0.160.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/postgresqlreceiver
commit_sha: 982f20b8a8e8a2569fab3e27cf8b008e8a5080c1
last_verified: 2026-09-03
---

# PostgreSQL Receiver
## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `postgresql.backends` | Sum | 1 | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.bgwriter.buffers.allocated` | Sum | {buffers} | - | - |
| `postgresql.bgwriter.buffers.writes` | Sum | {buffers} | source | - |
| `postgresql.bgwriter.checkpoint.count` | Sum | {checkpoints} | type | - |
| `postgresql.bgwriter.duration` | Sum | ms | type | - |
| `postgresql.bgwriter.maxwritten` | Sum | 1 | - | - |
| `postgresql.blks_hit` | Sum | {blks_hit} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.blks_read` | Sum | {blks_read} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.blocks_read` | Sum | 1 | source, db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.commits` | Sum | 1 | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.connection.max` | Gauge | {connections} | - | - |
| `postgresql.database.count` | Sum | {databases} | - | - |
| `postgresql.database.locks` | Gauge | {lock} | relation, mode, lock_type, db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.db_size` | Sum | By | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.deadlocks` | Sum | {deadlock} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.function.calls` | Sum | {call} | function, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires track_functions=pl|all. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.index.scans` | Sum | {scans} | db.namespace, db.collection.name, postgresql.index.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.index.size` | Gauge | By | db.namespace, db.collection.name, postgresql.index.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.operations` | Sum | 1 | operation, db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.query.conflicts` | Sum | {query} | postgresql.conflict.type, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires standby recovery statistics; otherwise may be zero. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.query.execution.time` | Sum | s | db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.replication.data_delay` | Gauge | By | replication_client | Requires WAL and at least one replica. |
| `postgresql.rollbacks` | Sum | 1 | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.rows` | Sum | 1 | state, db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.sequential_scans` | Sum | {sequential_scan} | db.namespace, db.collection.name | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.table.count` | Sum | {table} | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.table.size` | Sum | By | db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.table.vacuum.count` | Sum | {vacuum} | db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.temp.io` | Sum | By | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.temp_files` | Sum | {temp_file} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_deleted` | Sum | {tup_deleted} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_fetched` | Sum | {tup_fetched} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_inserted` | Sum | {tup_inserted} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_returned` | Sum | {tup_returned} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_updated` | Sum | {tup_updated} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.vector.insert.duration` | Sum | s | db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Requires pgvector and pg_stat_statements; PostgreSQL 13+. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.vector.insert.rows` | Sum | {vectors} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Requires pgvector and pg_stat_statements; PostgreSQL 13+. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.vector.search.calls` | Sum | {search} | postgresql.distance.function.name, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Requires pgvector and pg_stat_statements; PostgreSQL 13+. Vector metrics are opt-in via receiver.metrics; distance classification depends on pgvector query syntax. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.vector.search.duration` | Sum | s | postgresql.distance.function.name, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Requires pgvector and pg_stat_statements; PostgreSQL 13+. Vector metrics are opt-in via receiver.metrics; distance classification depends on pgvector query syntax. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.vector.search.rows_returned` | Sum | {rows} | postgresql.distance.function.name, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Requires pgvector and pg_stat_statements; PostgreSQL 13+. Vector metrics are opt-in via receiver.metrics; distance classification depends on pgvector query syntax. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.wal.age` | Gauge | s | - | Requires WAL and at least one replica. |
| `postgresql.wal.delay` | Gauge | s | operation, replication_client | Disabled by default; enable this metric in receiver.metrics. Requires WAL and at least one replica. Emitted only when receiver.postgresql.preciselagmetrics is enabled. |
| `postgresql.wal.lag` | Gauge | s | operation, replication_client | Requires WAL and at least one replica. Emitted only when receiver.postgresql.preciselagmetrics is disabled; the precise postgresql.wal.delay metric is emitted when the gate is enabled. |


## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `db.server.query_sample` | db.system.name, db.namespace, db.query.text, user.name, postgresql.state, postgresql.pid, postgresql.application_name, network.peer.address, network.peer.port, postgresql.client_hostname, postgresql.query_start, postgresql.wait_event, postgresql.wait_event_type, postgresql.query_id, postgresql.total_exec_time, postgresql.blocking.pids, postgresql.blocking.start_time, postgresql.blocking.wait_duration, postgresql.blocking.lock.mode, postgresql.blocking.lock.type, postgresql.blocking.lock.relation, postgresql.blocking.transaction.start_time | Disabled by default; enable the event in receiver.logs. `postgresql.total_exec_time` is expressed in seconds. Query samples may carry trace/span IDs when application_name contains a valid W3C traceparent. |
| `db.server.top_query` | db.system.name, db.namespace, db.query.text, postgresql.calls, postgresql.rows, postgresql.shared_blks_dirtied, postgresql.shared_blks_hit, postgresql.shared_blks_read, postgresql.shared_blks_written, postgresql.temp_blks_read, postgresql.temp_blks_written, postgresql.queryid, postgresql.rolname, postgresql.total_exec_time, postgresql.total_plan_time, postgresql.query_plan | Disabled by default; enable the event in receiver.logs. `postgresql.total_exec_time` and `postgresql.total_plan_time` are expressed in seconds. |

## Sources

- receiver/postgresqlreceiver/metadata.yaml
- receiver/postgresqlreceiver/scraper.go
- receiver/postgresqlreceiver/client.go
- receiver/postgresqlreceiver/factory.go
- receiver/postgresqlreceiver/internal/metadata/generated_metrics.go
- receiver/postgresqlreceiver/internal/metadata/generated_logs.go
        • v0.161.0.md 12.4 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/postgresqlreceiver
version: v0.161.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/postgresqlreceiver
commit_sha: 3f8455d8038a985398861171e5310bc9b4e988b2
last_verified: 2026-10-03
---

# PostgreSQL Receiver
## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `postgresql.backends` | Sum | 1 | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.bgwriter.buffers.allocated` | Sum | {buffers} | - | - |
| `postgresql.bgwriter.buffers.writes` | Sum | {buffers} | source | - |
| `postgresql.bgwriter.checkpoint.count` | Sum | {checkpoints} | type | - |
| `postgresql.bgwriter.duration` | Sum | ms | type | - |
| `postgresql.bgwriter.maxwritten` | Sum | 1 | - | - |
| `postgresql.blks_hit` | Sum | {blks_hit} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.blks_read` | Sum | {blks_read} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.blocks_read` | Sum | 1 | source, db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.commits` | Sum | 1 | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.connection.max` | Gauge | {connections} | - | - |
| `postgresql.database.count` | Sum | {databases} | - | - |
| `postgresql.database.locks` | Gauge | {lock} | relation, mode, lock_type, db.namespace | Disabled by default; enable this metric in receiver.metrics. `relation` is the relation name, or empty for locks not targeting a relation; counts include non-relation and server-scoped locks and locks held by the receiver's own connections. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.db_size` | Sum | By | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.deadlocks` | Sum | {deadlock} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.function.calls` | Sum | {call} | function, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires track_functions=pl\|all. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.index.scans` | Sum | {scans} | db.namespace, db.collection.name, postgresql.index.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.index.size` | Gauge | By | db.namespace, db.collection.name, postgresql.index.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.operations` | Sum | 1 | operation, db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.query.conflicts` | Sum | {query} | postgresql.conflict.type, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires standby recovery statistics; otherwise may be zero. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.query.execution.time` | Sum | s | db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.replication.data_delay` | Gauge | By | replication_client | Requires WAL and at least one replica. |
| `postgresql.rollbacks` | Sum | 1 | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.rows` | Sum | 1 | state, db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.sequential_scans` | Sum | {sequential_scan} | db.namespace, db.collection.name | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.table.count` | Sum | {table} | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.table.size` | Sum | By | db.namespace, db.collection.name | Total size including indexes and TOAST data (`pg_total_relation_size`). Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.table.vacuum.count` | Sum | {vacuum} | db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.temp.io` | Sum | By | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.temp_files` | Sum | {temp_file} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_deleted` | Sum | {tup_deleted} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_fetched` | Sum | {tup_fetched} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_inserted` | Sum | {tup_inserted} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_returned` | Sum | {tup_returned} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_updated` | Sum | {tup_updated} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.vector.insert.duration` | Sum | s | db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Requires pgvector and pg_stat_statements; PostgreSQL 13+. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.vector.insert.rows` | Sum | {vectors} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Requires pgvector and pg_stat_statements; PostgreSQL 13+. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.vector.search.calls` | Sum | {search} | postgresql.distance.function.name, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Requires pgvector and pg_stat_statements; PostgreSQL 13+. Vector metrics are opt-in via receiver.metrics; distance classification depends on pgvector query syntax. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.vector.search.duration` | Sum | s | postgresql.distance.function.name, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Requires pgvector and pg_stat_statements; PostgreSQL 13+. Vector metrics are opt-in via receiver.metrics; distance classification depends on pgvector query syntax. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.vector.search.rows_returned` | Sum | {rows} | postgresql.distance.function.name, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Requires pgvector and pg_stat_statements; PostgreSQL 13+. Vector metrics are opt-in via receiver.metrics; distance classification depends on pgvector query syntax. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.wal.age` | Gauge | s | - | Requires WAL and at least one replica. |
| `postgresql.wal.delay` | Gauge | s | operation, replication_client | Disabled by default; enable this metric in receiver.metrics. Requires WAL and at least one replica. Emitted only when receiver.postgresql.preciselagmetrics is enabled (beta, enabled by default). |
| `postgresql.wal.lag` | Gauge | s | operation, replication_client | Requires WAL and at least one replica. Emitted only when receiver.postgresql.preciselagmetrics is disabled; the gate is beta and enabled by default, so this metric is not emitted unless the gate is turned off. The precise postgresql.wal.delay metric is emitted when the gate is enabled. |


## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `db.server.query_sample` | db.system.name, db.namespace, db.query.text, user.name, postgresql.state, postgresql.pid, postgresql.application_name, network.peer.address, network.peer.port, postgresql.client_hostname, postgresql.query_start, postgresql.wait_event, postgresql.wait_event_type, postgresql.query_id, postgresql.total_exec_time, postgresql.blocking.pids, postgresql.blocking.start_time, postgresql.blocking.wait_duration, postgresql.blocking.lock.mode, postgresql.blocking.lock.type, postgresql.blocking.lock.relation, postgresql.blocking.transaction.start_time | Disabled by default; enable the event in receiver.logs. `postgresql.total_exec_time` is expressed in seconds. Query samples may carry trace/span IDs when application_name contains a valid W3C traceparent. |
| `db.server.top_query` | db.system.name, db.namespace, db.query.text, postgresql.calls, postgresql.rows, postgresql.shared_blks_dirtied, postgresql.shared_blks_hit, postgresql.shared_blks_read, postgresql.shared_blks_written, postgresql.temp_blks_read, postgresql.temp_blks_written, postgresql.queryid, postgresql.rolname, postgresql.total_exec_time, postgresql.total_plan_time, postgresql.query_plan | Disabled by default; enable the event in receiver.logs. `postgresql.total_exec_time` and `postgresql.total_plan_time` are expressed in seconds. Statements whose database no longer exists are skipped. |

## Sources

- receiver/postgresqlreceiver/metadata.yaml
- receiver/postgresqlreceiver/scraper.go
- receiver/postgresqlreceiver/client.go
- receiver/postgresqlreceiver/factory.go
- receiver/postgresqlreceiver/templates/topQueryTemplate.tmpl
- receiver/postgresqlreceiver/internal/metadata/generated_metrics.go
- receiver/postgresqlreceiver/internal/metadata/generated_logs.go
        • v0.162.0.md 13 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/postgresqlreceiver
version: v0.162.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/postgresqlreceiver
commit_sha: ae8c507510f48f433ab47dd1c6b01a59d6c388b5
last_verified: 2026-10-03
---

# PostgreSQL Receiver
## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `postgresql.backends` | Sum | 1 | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.bgwriter.buffers.allocated` | Sum | {buffers} | - | - |
| `postgresql.bgwriter.buffers.writes` | Sum | {buffers} | source | - |
| `postgresql.bgwriter.checkpoint.count` | Sum | {checkpoints} | type | - |
| `postgresql.bgwriter.duration` | Sum | ms | type | - |
| `postgresql.bgwriter.maxwritten` | Sum | 1 | - | - |
| `postgresql.blks_hit` | Sum | {blks_hit} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.blks_read` | Sum | {blks_read} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.blocks_read` | Sum | 1 | source, db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.commits` | Sum | 1 | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.connection.max` | Gauge | {connections} | - | - |
| `postgresql.database.count` | Sum | {databases} | - | - |
| `postgresql.database.locks` | Gauge | {lock} | relation, mode, lock_type, db.namespace | Disabled by default; enable this metric in receiver.metrics. `relation` is the relation name, or empty for locks not targeting a relation; counts include non-relation and server-scoped locks and locks held by the receiver's own connections. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.db_size` | Sum | By | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.deadlocks` | Sum | {deadlock} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.function.calls` | Sum | {call} | function, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires track_functions=pl\|all. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.index.scans` | Sum | {scans} | db.namespace, db.collection.name, postgresql.index.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.index.size` | Gauge | By | db.namespace, db.collection.name, postgresql.index.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.operations` | Sum | 1 | operation, db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.query.conflicts` | Sum | {query} | postgresql.conflict.type, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires standby recovery statistics; otherwise may be zero. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.query.execution.time` | Sum | s | db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.replication.data_delay` | Gauge | By | replication_client | Requires WAL and at least one replica. |
| `postgresql.rollbacks` | Sum | 1 | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.rows` | Sum | 1 | state, db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.sequential_scans` | Sum | {sequential_scan} | db.namespace, db.collection.name | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.table.count` | Sum | {table} | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.table.size` | Sum | By | db.namespace, db.collection.name | Total size including indexes and TOAST data (`pg_total_relation_size`). Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.table.vacuum.count` | Sum | {vacuum} | db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.temp.io` | Sum | By | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.temp_files` | Sum | {temp_file} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_deleted` | Sum | {tup_deleted} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_fetched` | Sum | {tup_fetched} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_inserted` | Sum | {tup_inserted} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_returned` | Sum | {tup_returned} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_updated` | Sum | {tup_updated} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.vector.insert.duration` | Sum | s | db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Requires pgvector and pg_stat_statements; PostgreSQL 13+. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.vector.insert.rows` | Sum | {vectors} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Requires pgvector and pg_stat_statements; PostgreSQL 13+. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.vector.search.calls` | Sum | {search} | postgresql.distance.function.name, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Requires pgvector and pg_stat_statements; PostgreSQL 13+. Vector metrics are opt-in via receiver.metrics; distance classification depends on pgvector query syntax. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.vector.search.duration` | Sum | s | postgresql.distance.function.name, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Requires pgvector and pg_stat_statements; PostgreSQL 13+. Vector metrics are opt-in via receiver.metrics; distance classification depends on pgvector query syntax. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.vector.search.rows_returned` | Sum | {rows} | postgresql.distance.function.name, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Requires pgvector and pg_stat_statements; PostgreSQL 13+. Vector metrics are opt-in via receiver.metrics; distance classification depends on pgvector query syntax. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.wal.age` | Gauge | s | - | Requires WAL and at least one replica. |
| `postgresql.wal.delay` | Gauge | s | operation, replication_client | Disabled by default; enable this metric in receiver.metrics. Requires WAL and at least one replica. Emitted only when receiver.postgresql.preciselagmetrics is enabled (beta, enabled by default). |
| `postgresql.wal.lag` | Gauge | s | operation, replication_client | Requires WAL and at least one replica. Emitted only when receiver.postgresql.preciselagmetrics is disabled; the gate is beta and enabled by default, so this metric is not emitted unless the gate is turned off. The precise postgresql.wal.delay metric is emitted when the gate is enabled. |


## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `db.server.query_plan` | db.system.name, postgresql.queryid, db.namespace, postgresql.rolname, postgresql.query_plan | Disabled by default; enable the event in receiver.logs. Requires `db.server.top_query` to be enabled; emitted during top query collection only for queries with a non-empty plan. When enabled, `postgresql.query_plan` is removed from `db.server.top_query` records. |
| `db.server.query_sample` | db.system.name, db.namespace, db.query.text, user.name, postgresql.state, postgresql.pid, postgresql.backend.connection.start, postgresql.application_name, network.peer.address, network.peer.port, postgresql.client_hostname, postgresql.query_start, postgresql.wait_event, postgresql.wait_event_type, postgresql.query_id, postgresql.total_exec_time, postgresql.blocking.pids, postgresql.blocking.start_time, postgresql.blocking.wait_duration, postgresql.blocking.lock.mode, postgresql.blocking.lock.type, postgresql.blocking.lock.relation, postgresql.blocking.transaction.start_time | Disabled by default; enable the event in receiver.logs. `postgresql.total_exec_time` is expressed in seconds. `postgresql.backend.connection.start` is an RFC3339 UTC timestamp. Query samples may carry trace/span IDs when application_name contains a valid W3C traceparent. |
| `db.server.top_query` | db.system.name, db.namespace, db.query.text, postgresql.calls, postgresql.rows, postgresql.shared_blks_dirtied, postgresql.shared_blks_hit, postgresql.shared_blks_read, postgresql.shared_blks_written, postgresql.temp_blks_read, postgresql.temp_blks_written, postgresql.queryid, postgresql.rolname, postgresql.total_exec_time, postgresql.total_plan_time, postgresql.query_plan | Disabled by default; enable the event in receiver.logs. `postgresql.total_exec_time` and `postgresql.total_plan_time` are expressed in seconds. Statements whose database no longer exists are skipped. `postgresql.query_plan` is omitted when `db.server.query_plan` is enabled. |

## Sources

- receiver/postgresqlreceiver/metadata.yaml
- receiver/postgresqlreceiver/scraper.go
- receiver/postgresqlreceiver/client.go
- receiver/postgresqlreceiver/factory.go
- receiver/postgresqlreceiver/config.go
- receiver/postgresqlreceiver/templates/querySampleTemplate.tmpl
- receiver/postgresqlreceiver/internal/metadata/generated_metrics.go
- receiver/postgresqlreceiver/internal/metadata/generated_logs.go
        • v0.163.0.md 13 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/postgresqlreceiver
version: v0.163.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/postgresqlreceiver
commit_sha: df849b5403c041d5e799e7846392a6f18b0b55ae
last_verified: null
---

# PostgreSQL Receiver
## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `postgresql.backends` | Sum | 1 | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.bgwriter.buffers.allocated` | Sum | {buffers} | - | - |
| `postgresql.bgwriter.buffers.writes` | Sum | {buffers} | source | - |
| `postgresql.bgwriter.checkpoint.count` | Sum | {checkpoints} | type | - |
| `postgresql.bgwriter.duration` | Sum | ms | type | - |
| `postgresql.bgwriter.maxwritten` | Sum | 1 | - | - |
| `postgresql.blks_hit` | Sum | {blks_hit} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.blks_read` | Sum | {blks_read} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.blocks_read` | Sum | 1 | source, db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.commits` | Sum | 1 | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.connection.max` | Gauge | {connections} | - | - |
| `postgresql.database.count` | Sum | {databases} | - | - |
| `postgresql.database.locks` | Gauge | {lock} | relation, mode, lock_type, db.namespace | Disabled by default; enable this metric in receiver.metrics. `relation` is the relation name, or empty for locks not targeting a relation; counts include non-relation and server-scoped locks and locks held by the receiver's own connections. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.db_size` | Sum | By | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.deadlocks` | Sum | {deadlock} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.function.calls` | Sum | {call} | function, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires track_functions=pl\|all. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.index.scans` | Sum | {scans} | db.namespace, db.collection.name, postgresql.index.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.index.size` | Gauge | By | db.namespace, db.collection.name, postgresql.index.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.operations` | Sum | 1 | operation, db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.query.conflicts` | Sum | {query} | postgresql.conflict.type, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires standby recovery statistics; otherwise may be zero. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.query.execution.time` | Sum | s | db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.replication.data_delay` | Gauge | By | replication_client | Requires WAL and at least one replica. |
| `postgresql.rollbacks` | Sum | 1 | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.rows` | Sum | 1 | state, db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.sequential_scans` | Sum | {sequential_scan} | db.namespace, db.collection.name | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.table.count` | Sum | {table} | db.namespace | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.table.size` | Sum | By | db.namespace, db.collection.name | Total size including indexes and TOAST data (`pg_total_relation_size`). Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.table.vacuum.count` | Sum | {vacuum} | db.namespace, db.collection.name | Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.temp.io` | Sum | By | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.temp_files` | Sum | {temp_file} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_deleted` | Sum | {tup_deleted} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_fetched` | Sum | {tup_fetched} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_inserted` | Sum | {tup_inserted} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_returned` | Sum | {tup_returned} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.tup_updated` | Sum | {tup_updated} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.vector.insert.duration` | Sum | s | db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Requires pgvector and pg_stat_statements; PostgreSQL 13+. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.vector.insert.rows` | Sum | {vectors} | db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Requires pgvector and pg_stat_statements; PostgreSQL 13+. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.vector.search.calls` | Sum | {search} | postgresql.distance.function.name, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Requires pgvector and pg_stat_statements; PostgreSQL 13+. Vector metrics are opt-in via receiver.metrics; distance classification depends on pgvector query syntax. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.vector.search.duration` | Sum | s | postgresql.distance.function.name, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Requires pgvector and pg_stat_statements; PostgreSQL 13+. Vector metrics are opt-in via receiver.metrics; distance classification depends on pgvector query syntax. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.vector.search.rows_returned` | Sum | {rows} | postgresql.distance.function.name, db.namespace | Disabled by default; enable this metric in receiver.metrics. Requires pg_stat_statements. Requires pgvector and pg_stat_statements; PostgreSQL 13+. Vector metrics are opt-in via receiver.metrics; distance classification depends on pgvector query syntax. Metric-level semantic attributes are available with receiver.postgresql.useOTelSemconv; legacy mode uses per-entity resource attributes. |
| `postgresql.wal.age` | Gauge | s | - | Requires WAL and at least one replica. |
| `postgresql.wal.delay` | Gauge | s | operation, replication_client | Disabled by default; enable this metric in receiver.metrics. Requires WAL and at least one replica. Emitted only when receiver.postgresql.preciselagmetrics is enabled (beta, enabled by default). |
| `postgresql.wal.lag` | Gauge | s | operation, replication_client | Requires WAL and at least one replica. Emitted only when receiver.postgresql.preciselagmetrics is disabled; the gate is beta and enabled by default, so this metric is not emitted unless the gate is turned off. The precise postgresql.wal.delay metric is emitted when the gate is enabled. |


## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `db.server.query_plan` | db.system.name, postgresql.queryid, db.namespace, postgresql.rolname, postgresql.query_plan | Disabled by default; enable the event in receiver.logs. Requires `db.server.top_query` to be enabled; emitted during top query collection only for queries with a non-empty plan. When enabled, `postgresql.query_plan` is removed from `db.server.top_query` records. |
| `db.server.query_sample` | db.system.name, db.namespace, db.query.text, user.name, postgresql.state, postgresql.pid, postgresql.backend.connection.start, postgresql.application_name, network.peer.address, network.peer.port, postgresql.client_hostname, postgresql.query_start, postgresql.wait_event, postgresql.wait_event_type, postgresql.query_id, postgresql.total_exec_time, postgresql.blocking.pids, postgresql.blocking.start_time, postgresql.blocking.wait_duration, postgresql.blocking.lock.mode, postgresql.blocking.lock.type, postgresql.blocking.lock.relation, postgresql.blocking.transaction.start_time | Disabled by default; enable the event in receiver.logs. `postgresql.total_exec_time` is expressed in seconds. `postgresql.backend.connection.start` is an RFC3339 UTC timestamp. Query samples may carry trace/span IDs when application_name contains a valid W3C traceparent. |
| `db.server.top_query` | db.system.name, db.namespace, db.query.text, postgresql.calls, postgresql.rows, postgresql.shared_blks_dirtied, postgresql.shared_blks_hit, postgresql.shared_blks_read, postgresql.shared_blks_written, postgresql.temp_blks_read, postgresql.temp_blks_written, postgresql.queryid, postgresql.rolname, postgresql.total_exec_time, postgresql.total_plan_time, postgresql.query_plan | Disabled by default; enable the event in receiver.logs. `postgresql.total_exec_time` and `postgresql.total_plan_time` are expressed in seconds. Statements whose database no longer exists are skipped. `postgresql.query_plan` is omitted when `db.server.query_plan` is enabled. |

## Sources

- receiver/postgresqlreceiver/metadata.yaml
- receiver/postgresqlreceiver/scraper.go
- receiver/postgresqlreceiver/client.go
- receiver/postgresqlreceiver/factory.go
- receiver/postgresqlreceiver/config.go
- receiver/postgresqlreceiver/templates/querySampleTemplate.tmpl
- receiver/postgresqlreceiver/internal/metadata/generated_metrics.go
- receiver/postgresqlreceiver/internal/metadata/generated_logs.go
      • prometheusreceiver
        • v0.153.0.md 3.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/prometheusreceiver
version: v0.153.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/prometheusreceiver
commit_sha: 42f949127580c0d00088b785cd0b35842dc0ddb8
last_verified: 2026-08-11
---

# Prometheus Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `<Prometheus gauge or unknown family>` | Gauge | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Scraped gauge and untyped families; name, description, and unit come from scrape metadata. |
| `<Prometheus counter family>` | Sum (cumulative, monotonic) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Created-timestamp-zero injection is gated by `receiver.prometheusreceiver.EnableCreatedTimestampZeroIngestion`. |
| `<Prometheus info or stateset family>` | Sum (cumulative, non-monotonic) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Prometheus info and stateset types are represented as non-monotonic sums. |
| `<Prometheus classic histogram family>` | Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, `le`, and `otel_scope_*` | Bucket, sum, and count series are combined. |
| `<Prometheus native histogram family>` | Exponential Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Native histograms are converted to OTLP exponential histograms. |
| `<Prometheus native histogram custom-bucket family>` | Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Native custom-bucket schema (`-53`) is converted to an OTLP histogram. |
| `<Prometheus summary family>` | Summary | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, `quantile`, and `otel_scope_*` | Quantile, sum, and count series are combined. |
| `up` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in scrape health metric. |
| `scrape_duration_seconds` | Gauge | `s` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in scrape metric. |
| `scrape_samples_scraped` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in scrape metric. |
| `scrape_series_added` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in scrape metric. |
| `scrape_samples_post_metric_relabeling` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in scrape metric. |
| `otel_scope_info` | Gauge | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, and `metrics_path` | Emitted only with feature gate `receiver.prometheusreceiver.IgnoreScopeInfoMetric`; otherwise converted to scope data. |

## Sources

- `receiver/prometheusreceiver/metadata.yaml`
- `receiver/prometheusreceiver/internal/metadata.go`
- `receiver/prometheusreceiver/internal/metricfamily.go`
- `receiver/prometheusreceiver/internal/prom_to_otlp.go`
- `receiver/prometheusreceiver/internal/transaction.go`
- `receiver/prometheusreceiver/internal/util.go`
- `receiver/prometheusreceiver/metrics_receiver.go`
        • v0.154.0.md 3.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/prometheusreceiver
version: v0.154.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/prometheusreceiver
commit_sha: 853eda0e12b3ba142552ecd2b63cec07062904f0
last_verified: 2026-08-11
---

# Prometheus Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `<Prometheus gauge or unknown family>` | Gauge | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Scraped gauge and untyped families; name, description, and unit come from scrape metadata. |
| `<Prometheus counter family>` | Sum (cumulative, monotonic) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Created-timestamp-zero injection is gated by `receiver.prometheusreceiver.EnableCreatedTimestampZeroIngestion`. |
| `<Prometheus info or stateset family>` | Sum (cumulative, non-monotonic) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Prometheus info and stateset types are represented as non-monotonic sums. |
| `<Prometheus classic histogram family>` | Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, `le`, and `otel_scope_*` | Bucket, sum, and count series are combined. |
| `<Prometheus native histogram family>` | Exponential Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Native histograms are converted to OTLP exponential histograms. |
| `<Prometheus native histogram custom-bucket family>` | Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Native custom-bucket schema (`-53`) is converted to an OTLP histogram. |
| `<Prometheus summary family>` | Summary | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, `quantile`, and `otel_scope_*` | Quantile, sum, and count series are combined. |
| `up` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in scrape health metric. |
| `scrape_duration_seconds` | Gauge | `s` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in scrape metric. |
| `scrape_samples_scraped` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in scrape metric. |
| `scrape_series_added` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in scrape metric. |
| `scrape_samples_post_metric_relabeling` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in scrape metric. |
| `otel_scope_info` | Gauge | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, and `metrics_path` | Emitted only with feature gate `receiver.prometheusreceiver.IgnoreScopeInfoMetric`; otherwise converted to scope data. |

## Sources

- `receiver/prometheusreceiver/metadata.yaml`
- `receiver/prometheusreceiver/internal/metadata.go`
- `receiver/prometheusreceiver/internal/metricfamily.go`
- `receiver/prometheusreceiver/internal/prom_to_otlp.go`
- `receiver/prometheusreceiver/internal/transaction.go`
- `receiver/prometheusreceiver/internal/util.go`
- `receiver/prometheusreceiver/metrics_receiver.go`
        • v0.155.0.md 3.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/prometheusreceiver
version: v0.155.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/prometheusreceiver
commit_sha: aaf5045a24c0a6f000225c97ad5449e69aeb5835
last_verified: 2026-08-11
---

# Prometheus Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `<Prometheus gauge or unknown family>` | Gauge | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Scraped gauge and untyped families; name, description, and unit come from scrape metadata. |
| `<Prometheus counter family>` | Sum (cumulative, monotonic) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Created-timestamp-zero injection is gated by `receiver.prometheusreceiver.EnableCreatedTimestampZeroIngestion`. |
| `<Prometheus info or stateset family>` | Sum (cumulative, non-monotonic) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Prometheus info and stateset types are represented as non-monotonic sums. |
| `<Prometheus classic histogram family>` | Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, `le`, and `otel_scope_*` | Bucket, sum, and count series are combined. |
| `<Prometheus native histogram family>` | Exponential Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Native histograms are converted to OTLP exponential histograms. |
| `<Prometheus native histogram custom-bucket family>` | Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Native custom-bucket schema (`-53`) is converted to an OTLP histogram. |
| `<Prometheus summary family>` | Summary | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, `quantile`, and `otel_scope_*` | Quantile, sum, and count series are combined. |
| `up` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in scrape health metric. |
| `scrape_duration_seconds` | Gauge | `s` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in scrape metric. |
| `scrape_samples_scraped` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in scrape metric. |
| `scrape_series_added` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in scrape metric. |
| `scrape_samples_post_metric_relabeling` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in scrape metric. |
| `otel_scope_info` | Gauge | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, and `metrics_path` | Emitted only with feature gate `receiver.prometheusreceiver.IgnoreScopeInfoMetric`; otherwise converted to scope data. |

## Sources

- `receiver/prometheusreceiver/metadata.yaml`
- `receiver/prometheusreceiver/internal/metadata.go`
- `receiver/prometheusreceiver/internal/metricfamily.go`
- `receiver/prometheusreceiver/internal/prom_to_otlp.go`
- `receiver/prometheusreceiver/internal/transaction.go`
- `receiver/prometheusreceiver/internal/util.go`
- `receiver/prometheusreceiver/metrics_receiver.go`
        • v0.156.0.md 3.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/prometheusreceiver
version: v0.156.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/prometheusreceiver
commit_sha: 41e24cd516dd69a5b4277465cdb2ff4ef0676f49
last_verified: 2026-08-11
---

# Prometheus Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `<Prometheus gauge family>` | Gauge | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Any scraped gauge or unknown-typed family; name, description, and unit come from scrape metadata. |
| `<Prometheus counter family>` | Sum (cumulative, monotonic) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Created-timestamp-zero injection is gated by `receiver.prometheusreceiver.EnableCreatedTimestampZeroIngestion`. |
| `<Prometheus info or stateset family>` | Sum (cumulative, non-monotonic) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Prometheus info and stateset types are represented as non-monotonic sums. |
| `<Prometheus classic histogram family>` | Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, `le`, and `otel_scope_*` | Bucket, sum, and count series are combined. |
| `<Prometheus native histogram family>` | Exponential Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Native histograms are converted to OTLP exponential histograms. |
| `<Prometheus native histogram custom-bucket family>` | Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Native custom-bucket schema (`-53`) is converted to an OTLP histogram. |
| `<Prometheus summary family>` | Summary | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, `quantile`, and `otel_scope_*` | Quantile, sum, and count series are combined. |
| `up` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in scrape health metric. |
| `scrape_duration_seconds` | Gauge | `s` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in scrape metric. |
| `scrape_samples_scraped` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in scrape metric. |
| `scrape_series_added` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in scrape metric. |
| `scrape_samples_post_metric_relabeling` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in scrape metric. |
| `otel_scope_info` | Gauge | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Emitted only with feature gate `receiver.prometheusreceiver.IgnoreScopeInfoMetric`; otherwise converted to scope data. |

## Sources

- `receiver/prometheusreceiver/metadata.yaml`
- `receiver/prometheusreceiver/internal/metadata.go`
- `receiver/prometheusreceiver/internal/metricfamily.go`
- `receiver/prometheusreceiver/internal/prom_to_otlp.go`
- `receiver/prometheusreceiver/internal/transaction.go`
- `receiver/prometheusreceiver/internal/util.go`
- `receiver/prometheusreceiver/metrics_receiver.go`
        • v0.157.0.md 4 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/prometheusreceiver
version: v0.157.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/prometheusreceiver
commit_sha: 89e43555904cd97c2d36605347c5d5237b1bdc8c
last_verified: 2026-08-11
---

# Prometheus Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `<Prometheus gauge family>` | Gauge | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Any scraped gauge or unknown-typed family; metric name, description, and unit come from scrape metadata. |
| `<Prometheus counter family>` | Sum (cumulative, monotonic) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Scraped counter families; created timestamps are used when present. Zero-valued created samples require feature gate `receiver.prometheusreceiver.EnableCreatedTimestampZeroIngestion`. |
| `<Prometheus info or stateset family>` | Sum (cumulative, non-monotonic) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Prometheus info and stateset types are represented as non-monotonic sums. |
| `<Prometheus classic histogram family>` | Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, `le`, and `otel_scope_*` | Bucket, sum, and count series are combined. |
| `<Prometheus native histogram family>` | Exponential Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Native histograms are converted to OTLP exponential histograms. |
| `<Prometheus native histogram custom-bucket family>` | Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Native custom-bucket schema (`-53`) is converted to an OTLP histogram. |
| `<Prometheus summary family>` | Summary | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, `quantile`, and `otel_scope_*` | Quantile, sum, and count series are combined. |
| `up` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in scrape health metric. |
| `scrape_duration_seconds` | Gauge | `s` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in scrape metric. |
| `scrape_samples_scraped` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in scrape metric. |
| `scrape_series_added` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in scrape metric. |
| `scrape_samples_post_metric_relabeling` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in scrape metric. |
| `otel_scope_info` | Gauge | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Emitted only with feature gate `receiver.prometheusreceiver.IgnoreScopeInfoMetric`; otherwise converted to scope data. |

## Sources

- `receiver/prometheusreceiver/metadata.yaml`
- `receiver/prometheusreceiver/internal/metadata.go`
- `receiver/prometheusreceiver/internal/metricfamily.go`
- `receiver/prometheusreceiver/internal/prom_to_otlp.go`
- `receiver/prometheusreceiver/internal/transaction.go`
- `receiver/prometheusreceiver/internal/util.go`
- `receiver/prometheusreceiver/metrics_receiver.go`
        • v0.158.0.md 4.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/prometheusreceiver
version: v0.158.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/prometheusreceiver
commit_sha: 821a9d9c2c1623c4a0ceba5d47b57c48879c3f84
last_verified: 2026-08-11
---

# Prometheus Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `<Prometheus gauge family>` | Gauge | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Any scraped gauge or unknown-typed family; metric name, description, and unit come from the scrape payload metadata. |
| `<Prometheus counter family>` | Sum (cumulative, monotonic) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Scraped counter families. Created timestamps are used when present; zero-valued created samples are injected when feature gate `receiver.prometheusreceiver.EnableCreatedTimestampZeroIngestion` is enabled. |
| `<Prometheus info or stateset family>` | Sum (cumulative, non-monotonic) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Prometheus info and stateset types are represented as non-monotonic sums. |
| `<Prometheus classic histogram family>` | Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, `le`, and `otel_scope_*` | Classic Prometheus histogram bucket, sum, and count series are combined into one OTLP histogram. |
| `<Prometheus native histogram family>` | Exponential Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Prometheus native histograms are converted to OTLP exponential histograms. |
| `<Prometheus native histogram custom-bucket family>` | Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Native histogram custom-bucket schema (`-53`) is converted to an OTLP histogram. |
| `<Prometheus summary family>` | Summary | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, `quantile`, and `otel_scope_*` | Prometheus summary quantile, sum, and count series are combined into one OTLP summary. |
| `up` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in Prometheus scrape health metric. |
| `scrape_duration_seconds` | Gauge | `s` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in Prometheus scrape metric. |
| `scrape_samples_scraped` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in Prometheus scrape metric. |
| `scrape_series_added` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in Prometheus scrape metric. |
| `scrape_samples_post_metric_relabeling` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in Prometheus scrape metric. |
| `otel_scope_info` | Gauge | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Only emitted as a metric when feature gate `receiver.prometheusreceiver.IgnoreScopeInfoMetric` is enabled; otherwise converted into scope name, version, schema URL, and attributes. |

## Sources

- `receiver/prometheusreceiver/metadata.yaml`
- `receiver/prometheusreceiver/internal/metadata.go`
- `receiver/prometheusreceiver/internal/metricfamily.go`
- `receiver/prometheusreceiver/internal/prom_to_otlp.go`
- `receiver/prometheusreceiver/internal/transaction.go`
- `receiver/prometheusreceiver/internal/util.go`
- `receiver/prometheusreceiver/metrics_receiver.go`
        • v0.159.0.md 4.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/prometheusreceiver
version: v0.159.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/prometheusreceiver
commit_sha: 1120cc0714bf4d14600105e5673c3b00fe87467a
last_verified: 2026-08-24
---

# Prometheus Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `<Prometheus gauge family>` | Gauge | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Any scraped gauge or unknown-typed family; metric name, description, and unit come from the scrape payload metadata. |
| `<Prometheus counter family>` | Sum (cumulative, monotonic) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Scraped counter families. Created timestamps are used when present; zero-valued created samples are injected when feature gate `receiver.prometheusreceiver.EnableCreatedTimestampZeroIngestion` is enabled. |
| `<Prometheus info or stateset family>` | Sum (cumulative, non-monotonic) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Prometheus info and stateset types are represented as non-monotonic sums. |
| `<Prometheus classic histogram family>` | Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, `le`, and `otel_scope_*` | Classic Prometheus histogram bucket, sum, and count series are combined into one OTLP histogram. |
| `<Prometheus native histogram family>` | Exponential Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Prometheus native histograms are converted to OTLP exponential histograms. |
| `<Prometheus native histogram custom-bucket family>` | Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Native histogram custom-bucket schema (`-53`) is converted to an OTLP histogram. |
| `<Prometheus summary family>` | Summary | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, `quantile`, and `otel_scope_*` | Prometheus summary quantile, sum, and count series are combined into one OTLP summary. |
| `up` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in Prometheus scrape health metric. |
| `scrape_duration_seconds` | Gauge | `s` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in Prometheus scrape metric. |
| `scrape_samples_scraped` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in Prometheus scrape metric. |
| `scrape_series_added` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in Prometheus scrape metric. |
| `scrape_samples_post_metric_relabeling` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in Prometheus scrape metric. |
| `otel_scope_info` | Gauge | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Only emitted as a metric when feature gate `receiver.prometheusreceiver.IgnoreScopeInfoMetric` is enabled; otherwise converted into scope name, version, schema URL, and attributes. |

## Sources

- `receiver/prometheusreceiver/metadata.yaml`
- `receiver/prometheusreceiver/internal/metadata.go`
- `receiver/prometheusreceiver/internal/metricfamily.go`
- `receiver/prometheusreceiver/internal/prom_to_otlp.go`
- `receiver/prometheusreceiver/internal/transaction.go`
- `receiver/prometheusreceiver/internal/util.go`
- `receiver/prometheusreceiver/metrics_receiver.go`
        • v0.160.0.md 4.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/prometheusreceiver
version: v0.160.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/prometheusreceiver
commit_sha: 982f20b8a8e8a2569fab3e27cf8b008e8a5080c1
last_verified: 2026-09-03
---

# Prometheus Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `<Prometheus gauge family>` | Gauge | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Any scraped gauge or unknown-typed family; metric name, description, and unit come from the scrape payload metadata. |
| `<Prometheus counter family>` | Sum (cumulative, monotonic) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Scraped counter families. Created timestamps are used when present; zero-valued created samples are injected when feature gate `receiver.prometheusreceiver.EnableCreatedTimestampZeroIngestion` is enabled. |
| `<Prometheus info or stateset family>` | Sum (cumulative, non-monotonic) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Prometheus info and stateset types are represented as non-monotonic sums. |
| `<Prometheus classic histogram family>` | Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, `le`, and `otel_scope_*` | Classic Prometheus histogram bucket, sum, and count series are combined into one OTLP histogram. |
| `<Prometheus native histogram family>` | Exponential Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Prometheus native histograms are converted to OTLP exponential histograms. |
| `<Prometheus native histogram custom-bucket family>` | Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Native histogram custom-bucket schema (`-53`) is converted to an OTLP histogram. |
| `<Prometheus summary family>` | Summary | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, `quantile`, and `otel_scope_*` | Prometheus summary quantile, sum, and count series are combined into one OTLP summary. |
| `up` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in Prometheus scrape health metric. |
| `scrape_duration_seconds` | Gauge | `s` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in Prometheus scrape metric. |
| `scrape_samples_scraped` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in Prometheus scrape metric. |
| `scrape_series_added` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in Prometheus scrape metric. |
| `scrape_samples_post_metric_relabeling` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in Prometheus scrape metric. |
| `otel_scope_info` | Gauge | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Only emitted as a metric when feature gate `receiver.prometheusreceiver.IgnoreScopeInfoMetric` is enabled; otherwise converted into scope name, version, schema URL, and attributes. |

## Sources

- `receiver/prometheusreceiver/metadata.yaml`
- `receiver/prometheusreceiver/internal/metadata.go`
- `receiver/prometheusreceiver/internal/metricfamily.go`
- `receiver/prometheusreceiver/internal/prom_to_otlp.go`
- `receiver/prometheusreceiver/internal/transaction.go`
- `receiver/prometheusreceiver/internal/util.go`
- `receiver/prometheusreceiver/metrics_receiver.go`
        • v0.161.0.md 4.3 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/prometheusreceiver
version: v0.161.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/prometheusreceiver
commit_sha: 3f8455d8038a985398861171e5310bc9b4e988b2
last_verified: 2026-10-03
---

# Prometheus Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `<Prometheus gauge family>` | Gauge | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Any scraped gauge or unknown-typed family; metric name, description, and unit come from the scrape payload metadata. |
| `<Prometheus counter family>` | Sum (cumulative, monotonic) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Scraped counter families. Created timestamps are used when present; zero-valued created samples are injected when feature gate `receiver.prometheusreceiver.EnableCreatedTimestampZeroIngestion` is enabled. |
| `<Prometheus info or stateset family>` | Sum (cumulative, non-monotonic) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Prometheus info and stateset types are represented as non-monotonic sums. |
| `<Prometheus classic histogram family>` | Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, `le`, and `otel_scope_*` | Classic Prometheus histogram bucket, sum, and count series are combined into one OTLP histogram. |
| `<Prometheus native histogram family>` | Exponential Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Prometheus native histograms are converted to OTLP exponential histograms. |
| `<Prometheus native histogram custom-bucket family>` | Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Native histogram custom-bucket schema (`-53`) is converted to an OTLP histogram. |
| `<Prometheus summary family>` | Summary | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, `quantile`, and `otel_scope_*` | Prometheus summary quantile, sum, and count series are combined into one OTLP summary. |
| `up` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in Prometheus scrape health metric. |
| `scrape_duration_seconds` | Gauge | `s` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in Prometheus scrape metric. |
| `scrape_samples_scraped` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in Prometheus scrape metric. |
| `scrape_series_added` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in Prometheus scrape metric. |
| `scrape_samples_post_metric_relabeling` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in Prometheus scrape metric. |
| `otel_scope_info` | Gauge | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Only emitted as a metric when feature gate `receiver.prometheusreceiver.IgnoreScopeInfoMetric` is enabled (beta, enabled by default); when the gate is disabled, converted into scope name, version, schema URL, and attributes. |

## Sources

- `receiver/prometheusreceiver/metadata.yaml`
- `receiver/prometheusreceiver/internal/metadata.go`
- `receiver/prometheusreceiver/internal/metricfamily.go`
- `receiver/prometheusreceiver/internal/prom_to_otlp.go`
- `receiver/prometheusreceiver/internal/transaction.go`
- `receiver/prometheusreceiver/internal/util.go`
- `receiver/prometheusreceiver/metrics_receiver.go`
        • v0.162.0.md 4.4 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/prometheusreceiver
version: v0.162.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/prometheusreceiver
commit_sha: ae8c507510f48f433ab47dd1c6b01a59d6c388b5
last_verified: 2026-10-03
---

# Prometheus Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `<Prometheus gauge family>` | Gauge | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Any scraped gauge or unknown-typed family; metric name, description, and unit come from the scrape payload metadata. |
| `<Prometheus counter family>` | Sum (cumulative, monotonic) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Scraped counter families. Created timestamps are used when present; zero-valued created samples are injected when feature gate `receiver.prometheusreceiver.EnableCreatedTimestampZeroIngestion` is enabled. |
| `<Prometheus info or stateset family>` | Sum (cumulative, non-monotonic) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Prometheus info and stateset types are represented as non-monotonic sums. |
| `<Prometheus classic histogram family>` | Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, `le`, and `otel_scope_*` | Classic Prometheus histogram bucket, sum, and count series are combined into one OTLP histogram. |
| `<Prometheus native histogram family>` | Exponential Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Prometheus native histograms are converted to OTLP exponential histograms. |
| `<Prometheus native histogram custom-bucket family>` | Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Native histogram custom-bucket schema (`-53`) is converted to an OTLP histogram. |
| `<Prometheus summary family>` | Summary | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, `quantile`, and `otel_scope_*` | Prometheus summary quantile, sum, and count series are combined into one OTLP summary. |
| `up` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in Prometheus scrape health metric. |
| `scrape_duration_seconds` | Gauge | `s` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in Prometheus scrape metric. |
| `scrape_samples_scraped` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in Prometheus scrape metric. |
| `scrape_series_added` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in Prometheus scrape metric. |
| `scrape_samples_post_metric_relabeling` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in Prometheus scrape metric. |
| `otel_scope_info` | Gauge | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Always emitted and converted like any other metric: feature gate `receiver.prometheusreceiver.IgnoreScopeInfoMetric` is stable (cannot be disabled; removal planned for v0.164.0). Scope name, version, schema URL, and attributes come only from `otel_scope_*` labels on each series. |

## Sources

- `receiver/prometheusreceiver/metadata.yaml`
- `receiver/prometheusreceiver/internal/metadata.go`
- `receiver/prometheusreceiver/internal/metadata/generated_feature_gates.go`
- `receiver/prometheusreceiver/internal/metricfamily.go`
- `receiver/prometheusreceiver/internal/prom_to_otlp.go`
- `receiver/prometheusreceiver/internal/transaction.go`
- `receiver/prometheusreceiver/internal/util.go`
- `receiver/prometheusreceiver/metrics_receiver.go`
        • v0.163.0.md 4.4 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/prometheusreceiver
version: v0.163.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/prometheusreceiver
commit_sha: df849b5403c041d5e799e7846392a6f18b0b55ae
last_verified: 2026-10-14
---

# Prometheus Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `<Prometheus gauge family>` | Gauge | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Any scraped gauge or unknown-typed family; metric name, description, and unit come from the scrape payload metadata. |
| `<Prometheus counter family>` | Sum (cumulative, monotonic) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Scraped counter families. Created timestamps are used when present; zero-valued created samples are injected when feature gate `receiver.prometheusreceiver.EnableCreatedTimestampZeroIngestion` is enabled. |
| `<Prometheus info or stateset family>` | Sum (cumulative, non-monotonic) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Prometheus info and stateset types are represented as non-monotonic sums. |
| `<Prometheus classic histogram family>` | Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, `le`, and `otel_scope_*` | Classic Prometheus histogram bucket, sum, and count series are combined into one OTLP histogram. |
| `<Prometheus native histogram family>` | Exponential Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Prometheus native histograms are converted to OTLP exponential histograms. |
| `<Prometheus native histogram custom-bucket family>` | Histogram (cumulative) | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Native histogram custom-bucket schema (`-53`) is converted to an OTLP histogram. |
| `<Prometheus summary family>` | Summary | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, `quantile`, and `otel_scope_*` | Prometheus summary quantile, sum, and count series are combined into one OTLP summary. |
| `up` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in Prometheus scrape health metric. |
| `scrape_duration_seconds` | Gauge | `s` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in Prometheus scrape metric. |
| `scrape_samples_scraped` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in Prometheus scrape metric. |
| `scrape_series_added` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in Prometheus scrape metric. |
| `scrape_samples_post_metric_relabeling` | Gauge | `1` | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Built-in Prometheus scrape metric. |
| `otel_scope_info` | Gauge | Prometheus metadata unit, converted to UCUM | Prometheus labels except `__name__`, `job`, `instance`, `scheme`, `metrics_path`, and `otel_scope_*` | Always emitted and converted like any other metric: feature gate `receiver.prometheusreceiver.IgnoreScopeInfoMetric` is stable (cannot be disabled; removal planned for v0.164.0). Scope name, version, schema URL, and attributes come only from `otel_scope_*` labels on each series. |

## Sources

- `receiver/prometheusreceiver/metadata.yaml`
- `receiver/prometheusreceiver/internal/metadata.go`
- `receiver/prometheusreceiver/internal/metadata/generated_feature_gates.go`
- `receiver/prometheusreceiver/internal/metricfamily.go`
- `receiver/prometheusreceiver/internal/prom_to_otlp.go`
- `receiver/prometheusreceiver/internal/transaction.go`
- `receiver/prometheusreceiver/internal/util.go`
- `receiver/prometheusreceiver/metrics_receiver.go`
      • rabbitmqreceiver
        • v0.153.0.md 16.1 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/rabbitmqreceiver
version: v0.153.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/rabbitmqreceiver
commit_sha: 42f949127580c0d00088b785cd0b35842dc0ddb8
last_verified: 2026-08-11
---

# RabbitMQ Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `rabbitmq.consumer.count` | Sum (cumulative, non-monotonic) | `{consumers}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.acknowledged` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.current` | Sum (cumulative, non-monotonic) | `{messages}` | `state` | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.delivered` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.dropped` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.published` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.node.channel_closed` | Sum (cumulative, non-monotonic) | `{channels}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.channel_closed_details.rate` | Sum (cumulative, non-monotonic) | `{channels}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.channel_created` | Sum (cumulative, non-monotonic) | `{channels}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.channel_created_details.rate` | Sum (cumulative, non-monotonic) | `{channels}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_closed` | Sum (cumulative, non-monotonic) | `{connections}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_closed_details.rate` | Sum (cumulative, non-monotonic) | `{connections}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_created` | Sum (cumulative, non-monotonic) | `{connections}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_created_details.rate` | Sum (cumulative, non-monotonic) | `{connections}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.context_switches` | Sum (cumulative, non-monotonic) | `{switches}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.context_switches_details.rate` | Sum (cumulative, non-monotonic) | `{switches}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free_alarm` | Sum (cumulative, non-monotonic) | `{status}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free_limit` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.fd_total` | Sum (cumulative, non-monotonic) | `{fd}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.fd_used` | Sum (cumulative, non-monotonic) | `{fd}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.fd_used_details.rate` | Sum (cumulative, non-monotonic) | `{fd}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_bytes_reclaimed` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_bytes_reclaimed_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_num` | Sum (cumulative, non-monotonic) | `{collections}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_num_details.rate` | Sum (cumulative, non-monotonic) | `{collections}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_bytes` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_bytes_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_reopen_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_reopen_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_bytes` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_bytes_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_alarm` | Sum (cumulative, non-monotonic) | `{status}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_limit` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_used` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_used_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_disk_tx_count` | Sum (cumulative, non-monotonic) | `{tx}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_disk_tx_count_details.rate` | Sum (cumulative, non-monotonic) | `{tx}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_ram_tx_count` | Sum (cumulative, non-monotonic) | `{tx}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_ram_tx_count_details.rate` | Sum (cumulative, non-monotonic) | `{tx}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_read_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_read_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_write_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_write_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.proc_total` | Sum (cumulative, non-monotonic) | `{processes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.proc_used` | Sum (cumulative, non-monotonic) | `{processes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.proc_used_details.rate` | Sum (cumulative, non-monotonic) | `{processes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.processors` | Sum (cumulative, non-monotonic) | `{processors}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_created` | Sum (cumulative, non-monotonic) | `{queues}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_created_details.rate` | Sum (cumulative, non-monotonic) | `{queues}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_declared` | Sum (cumulative, non-monotonic) | `{queues}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_declared_details.rate` | Sum (cumulative, non-monotonic) | `{queues}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_deleted` | Sum (cumulative, non-monotonic) | `{queues}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_deleted_details.rate` | Sum (cumulative, non-monotonic) | `{queues}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_read_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_read_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_write_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_write_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.run_queue` | Sum (cumulative, non-monotonic) | `{threads}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.sockets_total` | Sum (cumulative, non-monotonic) | `{sockets}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.sockets_used` | Sum (cumulative, non-monotonic) | `{sockets}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.sockets_used_details.rate` | Sum (cumulative, non-monotonic) | `{sockets}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.uptime` | Sum (cumulative, non-monotonic) | `ms` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |

## Sources

- receiver/rabbitmqreceiver/metadata.yaml
- receiver/rabbitmqreceiver/scraper.go
- receiver/rabbitmqreceiver/factory.go
- receiver/rabbitmqreceiver/client.go
- receiver/rabbitmqreceiver/internal/metadata/generated_metrics.go
- receiver/rabbitmqreceiver/internal/metadata/generated_resource.go
        • v0.154.0.md 16.1 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/rabbitmqreceiver
version: v0.154.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/rabbitmqreceiver
commit_sha: 853eda0e12b3ba142552ecd2b63cec07062904f0
last_verified: 2026-08-11
---

# RabbitMQ Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `rabbitmq.consumer.count` | Sum (cumulative, non-monotonic) | `{consumers}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.acknowledged` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.current` | Sum (cumulative, non-monotonic) | `{messages}` | `state` | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.delivered` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.dropped` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.published` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.node.channel_closed` | Sum (cumulative, non-monotonic) | `{channels}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.channel_closed_details.rate` | Sum (cumulative, non-monotonic) | `{channels}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.channel_created` | Sum (cumulative, non-monotonic) | `{channels}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.channel_created_details.rate` | Sum (cumulative, non-monotonic) | `{channels}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_closed` | Sum (cumulative, non-monotonic) | `{connections}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_closed_details.rate` | Sum (cumulative, non-monotonic) | `{connections}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_created` | Sum (cumulative, non-monotonic) | `{connections}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_created_details.rate` | Sum (cumulative, non-monotonic) | `{connections}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.context_switches` | Sum (cumulative, non-monotonic) | `{switches}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.context_switches_details.rate` | Sum (cumulative, non-monotonic) | `{switches}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free_alarm` | Sum (cumulative, non-monotonic) | `{status}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free_limit` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.fd_total` | Sum (cumulative, non-monotonic) | `{fd}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.fd_used` | Sum (cumulative, non-monotonic) | `{fd}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.fd_used_details.rate` | Sum (cumulative, non-monotonic) | `{fd}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_bytes_reclaimed` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_bytes_reclaimed_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_num` | Sum (cumulative, non-monotonic) | `{collections}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_num_details.rate` | Sum (cumulative, non-monotonic) | `{collections}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_bytes` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_bytes_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_reopen_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_reopen_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_bytes` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_bytes_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_alarm` | Sum (cumulative, non-monotonic) | `{status}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_limit` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_used` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_used_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_disk_tx_count` | Sum (cumulative, non-monotonic) | `{tx}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_disk_tx_count_details.rate` | Sum (cumulative, non-monotonic) | `{tx}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_ram_tx_count` | Sum (cumulative, non-monotonic) | `{tx}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_ram_tx_count_details.rate` | Sum (cumulative, non-monotonic) | `{tx}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_read_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_read_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_write_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_write_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.proc_total` | Sum (cumulative, non-monotonic) | `{processes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.proc_used` | Sum (cumulative, non-monotonic) | `{processes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.proc_used_details.rate` | Sum (cumulative, non-monotonic) | `{processes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.processors` | Sum (cumulative, non-monotonic) | `{processors}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_created` | Sum (cumulative, non-monotonic) | `{queues}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_created_details.rate` | Sum (cumulative, non-monotonic) | `{queues}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_declared` | Sum (cumulative, non-monotonic) | `{queues}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_declared_details.rate` | Sum (cumulative, non-monotonic) | `{queues}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_deleted` | Sum (cumulative, non-monotonic) | `{queues}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_deleted_details.rate` | Sum (cumulative, non-monotonic) | `{queues}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_read_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_read_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_write_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_write_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.run_queue` | Sum (cumulative, non-monotonic) | `{threads}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.sockets_total` | Sum (cumulative, non-monotonic) | `{sockets}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.sockets_used` | Sum (cumulative, non-monotonic) | `{sockets}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.sockets_used_details.rate` | Sum (cumulative, non-monotonic) | `{sockets}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.uptime` | Sum (cumulative, non-monotonic) | `ms` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |

## Sources

- receiver/rabbitmqreceiver/metadata.yaml
- receiver/rabbitmqreceiver/scraper.go
- receiver/rabbitmqreceiver/factory.go
- receiver/rabbitmqreceiver/client.go
- receiver/rabbitmqreceiver/internal/metadata/generated_metrics.go
- receiver/rabbitmqreceiver/internal/metadata/generated_resource.go
        • v0.155.0.md 16.1 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/rabbitmqreceiver
version: v0.155.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/rabbitmqreceiver
commit_sha: aaf5045a24c0a6f000225c97ad5449e69aeb5835
last_verified: 2026-08-11
---

# RabbitMQ Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `rabbitmq.consumer.count` | Sum (cumulative, non-monotonic) | `{consumers}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.acknowledged` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.current` | Sum (cumulative, non-monotonic) | `{messages}` | `state` | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.delivered` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.dropped` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.published` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.node.channel_closed` | Sum (cumulative, non-monotonic) | `{channels}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.channel_closed_details.rate` | Sum (cumulative, non-monotonic) | `{channels}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.channel_created` | Sum (cumulative, non-monotonic) | `{channels}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.channel_created_details.rate` | Sum (cumulative, non-monotonic) | `{channels}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_closed` | Sum (cumulative, non-monotonic) | `{connections}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_closed_details.rate` | Sum (cumulative, non-monotonic) | `{connections}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_created` | Sum (cumulative, non-monotonic) | `{connections}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_created_details.rate` | Sum (cumulative, non-monotonic) | `{connections}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.context_switches` | Sum (cumulative, non-monotonic) | `{switches}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.context_switches_details.rate` | Sum (cumulative, non-monotonic) | `{switches}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free_alarm` | Sum (cumulative, non-monotonic) | `{status}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free_limit` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.fd_total` | Sum (cumulative, non-monotonic) | `{fd}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.fd_used` | Sum (cumulative, non-monotonic) | `{fd}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.fd_used_details.rate` | Sum (cumulative, non-monotonic) | `{fd}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_bytes_reclaimed` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_bytes_reclaimed_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_num` | Sum (cumulative, non-monotonic) | `{collections}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_num_details.rate` | Sum (cumulative, non-monotonic) | `{collections}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_bytes` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_bytes_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_reopen_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_reopen_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_bytes` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_bytes_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_alarm` | Sum (cumulative, non-monotonic) | `{status}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_limit` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_used` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_used_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_disk_tx_count` | Sum (cumulative, non-monotonic) | `{tx}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_disk_tx_count_details.rate` | Sum (cumulative, non-monotonic) | `{tx}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_ram_tx_count` | Sum (cumulative, non-monotonic) | `{tx}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_ram_tx_count_details.rate` | Sum (cumulative, non-monotonic) | `{tx}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_read_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_read_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_write_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_write_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.proc_total` | Sum (cumulative, non-monotonic) | `{processes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.proc_used` | Sum (cumulative, non-monotonic) | `{processes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.proc_used_details.rate` | Sum (cumulative, non-monotonic) | `{processes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.processors` | Sum (cumulative, non-monotonic) | `{processors}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_created` | Sum (cumulative, non-monotonic) | `{queues}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_created_details.rate` | Sum (cumulative, non-monotonic) | `{queues}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_declared` | Sum (cumulative, non-monotonic) | `{queues}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_declared_details.rate` | Sum (cumulative, non-monotonic) | `{queues}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_deleted` | Sum (cumulative, non-monotonic) | `{queues}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_deleted_details.rate` | Sum (cumulative, non-monotonic) | `{queues}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_read_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_read_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_write_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_write_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.run_queue` | Sum (cumulative, non-monotonic) | `{threads}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.sockets_total` | Sum (cumulative, non-monotonic) | `{sockets}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.sockets_used` | Sum (cumulative, non-monotonic) | `{sockets}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.sockets_used_details.rate` | Sum (cumulative, non-monotonic) | `{sockets}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.uptime` | Sum (cumulative, non-monotonic) | `ms` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |

## Sources

- receiver/rabbitmqreceiver/metadata.yaml
- receiver/rabbitmqreceiver/scraper.go
- receiver/rabbitmqreceiver/factory.go
- receiver/rabbitmqreceiver/client.go
- receiver/rabbitmqreceiver/internal/metadata/generated_metrics.go
- receiver/rabbitmqreceiver/internal/metadata/generated_resource.go
        • v0.156.0.md 16.1 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/rabbitmqreceiver
version: v0.156.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/rabbitmqreceiver
commit_sha: 41e24cd516dd69a5b4277465cdb2ff4ef0676f49
last_verified: 2026-08-11
---

# RabbitMQ Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `rabbitmq.consumer.count` | Sum (cumulative, non-monotonic) | `{consumers}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.acknowledged` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.current` | Sum (cumulative, non-monotonic) | `{messages}` | `state` | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.delivered` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.dropped` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.published` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.node.channel_closed` | Sum (cumulative, non-monotonic) | `{channels}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.channel_closed_details.rate` | Sum (cumulative, non-monotonic) | `{channels}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.channel_created` | Sum (cumulative, non-monotonic) | `{channels}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.channel_created_details.rate` | Sum (cumulative, non-monotonic) | `{channels}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_closed` | Sum (cumulative, non-monotonic) | `{connections}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_closed_details.rate` | Sum (cumulative, non-monotonic) | `{connections}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_created` | Sum (cumulative, non-monotonic) | `{connections}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_created_details.rate` | Sum (cumulative, non-monotonic) | `{connections}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.context_switches` | Sum (cumulative, non-monotonic) | `{switches}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.context_switches_details.rate` | Sum (cumulative, non-monotonic) | `{switches}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free_alarm` | Sum (cumulative, non-monotonic) | `{status}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free_limit` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.fd_total` | Sum (cumulative, non-monotonic) | `{fd}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.fd_used` | Sum (cumulative, non-monotonic) | `{fd}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.fd_used_details.rate` | Sum (cumulative, non-monotonic) | `{fd}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_bytes_reclaimed` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_bytes_reclaimed_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_num` | Sum (cumulative, non-monotonic) | `{collections}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_num_details.rate` | Sum (cumulative, non-monotonic) | `{collections}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_bytes` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_bytes_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_reopen_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_reopen_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_bytes` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_bytes_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_alarm` | Sum (cumulative, non-monotonic) | `{status}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_limit` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_used` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_used_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_disk_tx_count` | Sum (cumulative, non-monotonic) | `{tx}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_disk_tx_count_details.rate` | Sum (cumulative, non-monotonic) | `{tx}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_ram_tx_count` | Sum (cumulative, non-monotonic) | `{tx}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_ram_tx_count_details.rate` | Sum (cumulative, non-monotonic) | `{tx}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_read_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_read_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_write_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_write_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.proc_total` | Sum (cumulative, non-monotonic) | `{processes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.proc_used` | Sum (cumulative, non-monotonic) | `{processes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.proc_used_details.rate` | Sum (cumulative, non-monotonic) | `{processes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.processors` | Sum (cumulative, non-monotonic) | `{processors}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_created` | Sum (cumulative, non-monotonic) | `{queues}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_created_details.rate` | Sum (cumulative, non-monotonic) | `{queues}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_declared` | Sum (cumulative, non-monotonic) | `{queues}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_declared_details.rate` | Sum (cumulative, non-monotonic) | `{queues}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_deleted` | Sum (cumulative, non-monotonic) | `{queues}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_deleted_details.rate` | Sum (cumulative, non-monotonic) | `{queues}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_read_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_read_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_write_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_write_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.run_queue` | Sum (cumulative, non-monotonic) | `{threads}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.sockets_total` | Sum (cumulative, non-monotonic) | `{sockets}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.sockets_used` | Sum (cumulative, non-monotonic) | `{sockets}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.sockets_used_details.rate` | Sum (cumulative, non-monotonic) | `{sockets}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.uptime` | Sum (cumulative, non-monotonic) | `ms` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |

## Sources

- receiver/rabbitmqreceiver/metadata.yaml
- receiver/rabbitmqreceiver/scraper.go
- receiver/rabbitmqreceiver/factory.go
- receiver/rabbitmqreceiver/client.go
- receiver/rabbitmqreceiver/internal/metadata/generated_metrics.go
- receiver/rabbitmqreceiver/internal/metadata/generated_resource.go
        • v0.157.0.md 16.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/rabbitmqreceiver
version: v0.157.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/rabbitmqreceiver
commit_sha: 89e43555904cd97c2d36605347c5d5237b1bdc8c
last_verified: 2026-08-11
---

# RabbitMQ Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `rabbitmq.consumer.count` | Sum (cumulative, non-monotonic) | `{consumers}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.exchange.messages.published_in` | Sum (cumulative, monotonic) | `{messages}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.exchange.name`, `rabbitmq.exchange.type`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.exchange.messages.published_out` | Sum (cumulative, monotonic) | `{messages}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.exchange.name`, `rabbitmq.exchange.type`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.acknowledged` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.current` | Sum (cumulative, non-monotonic) | `{messages}` | `state` | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.delivered` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.dropped` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.published` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.node.channel_closed` | Sum (cumulative, non-monotonic) | `{channels}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.channel_closed_details.rate` | Sum (cumulative, non-monotonic) | `{channels}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.channel_created` | Sum (cumulative, non-monotonic) | `{channels}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.channel_created_details.rate` | Sum (cumulative, non-monotonic) | `{channels}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_closed` | Sum (cumulative, non-monotonic) | `{connections}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_closed_details.rate` | Sum (cumulative, non-monotonic) | `{connections}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_created` | Sum (cumulative, non-monotonic) | `{connections}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_created_details.rate` | Sum (cumulative, non-monotonic) | `{connections}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.context_switches` | Sum (cumulative, non-monotonic) | `{switches}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.context_switches_details.rate` | Sum (cumulative, non-monotonic) | `{switches}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free_alarm` | Sum (cumulative, non-monotonic) | `{status}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free_limit` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.fd_total` | Sum (cumulative, non-monotonic) | `{fd}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.fd_used` | Sum (cumulative, non-monotonic) | `{fd}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.fd_used_details.rate` | Sum (cumulative, non-monotonic) | `{fd}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_bytes_reclaimed` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_bytes_reclaimed_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_num` | Sum (cumulative, non-monotonic) | `{collections}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_num_details.rate` | Sum (cumulative, non-monotonic) | `{collections}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_bytes` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_bytes_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_reopen_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_reopen_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_bytes` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_bytes_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_alarm` | Sum (cumulative, non-monotonic) | `{status}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_limit` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_used` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_used_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_disk_tx_count` | Sum (cumulative, non-monotonic) | `{tx}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_disk_tx_count_details.rate` | Sum (cumulative, non-monotonic) | `{tx}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_ram_tx_count` | Sum (cumulative, non-monotonic) | `{tx}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_ram_tx_count_details.rate` | Sum (cumulative, non-monotonic) | `{tx}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_read_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_read_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_write_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_write_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.proc_total` | Sum (cumulative, non-monotonic) | `{processes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.proc_used` | Sum (cumulative, non-monotonic) | `{processes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.proc_used_details.rate` | Sum (cumulative, non-monotonic) | `{processes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.processors` | Sum (cumulative, non-monotonic) | `{processors}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_created` | Sum (cumulative, non-monotonic) | `{queues}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_created_details.rate` | Sum (cumulative, non-monotonic) | `{queues}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_declared` | Sum (cumulative, non-monotonic) | `{queues}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_declared_details.rate` | Sum (cumulative, non-monotonic) | `{queues}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_deleted` | Sum (cumulative, non-monotonic) | `{queues}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_deleted_details.rate` | Sum (cumulative, non-monotonic) | `{queues}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_read_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_read_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_write_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_write_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.run_queue` | Sum (cumulative, non-monotonic) | `{threads}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.sockets_total` | Sum (cumulative, non-monotonic) | `{sockets}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.sockets_used` | Sum (cumulative, non-monotonic) | `{sockets}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.sockets_used_details.rate` | Sum (cumulative, non-monotonic) | `{sockets}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.uptime` | Sum (cumulative, non-monotonic) | `ms` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |

## Sources

- receiver/rabbitmqreceiver/metadata.yaml
- receiver/rabbitmqreceiver/scraper.go
- receiver/rabbitmqreceiver/factory.go
- receiver/rabbitmqreceiver/client.go
- receiver/rabbitmqreceiver/internal/metadata/generated_metrics.go
- receiver/rabbitmqreceiver/internal/metadata/generated_resource.go
        • v0.158.0.md 16.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/rabbitmqreceiver
version: v0.158.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/rabbitmqreceiver
commit_sha: 821a9d9c2c1623c4a0ceba5d47b57c48879c3f84
last_verified: 2026-08-11
---

# RabbitMQ Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `rabbitmq.consumer.count` | Sum (cumulative, non-monotonic) | `{consumers}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.exchange.messages.published_in` | Sum (cumulative, monotonic) | `{messages}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.exchange.name`, `rabbitmq.exchange.type`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.exchange.messages.published_out` | Sum (cumulative, monotonic) | `{messages}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.exchange.name`, `rabbitmq.exchange.type`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.acknowledged` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.current` | Sum (cumulative, non-monotonic) | `{messages}` | `state` | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.delivered` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.dropped` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.published` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.node.channel_closed` | Sum (cumulative, non-monotonic) | `{channels}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.channel_closed_details.rate` | Sum (cumulative, non-monotonic) | `{channels}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.channel_created` | Sum (cumulative, non-monotonic) | `{channels}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.channel_created_details.rate` | Sum (cumulative, non-monotonic) | `{channels}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_closed` | Sum (cumulative, non-monotonic) | `{connections}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_closed_details.rate` | Sum (cumulative, non-monotonic) | `{connections}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_created` | Sum (cumulative, non-monotonic) | `{connections}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_created_details.rate` | Sum (cumulative, non-monotonic) | `{connections}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.context_switches` | Sum (cumulative, non-monotonic) | `{switches}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.context_switches_details.rate` | Sum (cumulative, non-monotonic) | `{switches}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free_alarm` | Sum (cumulative, non-monotonic) | `{status}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free_limit` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.fd_total` | Sum (cumulative, non-monotonic) | `{fd}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.fd_used` | Sum (cumulative, non-monotonic) | `{fd}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.fd_used_details.rate` | Sum (cumulative, non-monotonic) | `{fd}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_bytes_reclaimed` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_bytes_reclaimed_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_num` | Sum (cumulative, non-monotonic) | `{collections}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_num_details.rate` | Sum (cumulative, non-monotonic) | `{collections}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_bytes` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_bytes_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_reopen_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_reopen_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_bytes` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_bytes_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_alarm` | Sum (cumulative, non-monotonic) | `{status}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_limit` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_used` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_used_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_disk_tx_count` | Sum (cumulative, non-monotonic) | `{tx}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_disk_tx_count_details.rate` | Sum (cumulative, non-monotonic) | `{tx}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_ram_tx_count` | Sum (cumulative, non-monotonic) | `{tx}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_ram_tx_count_details.rate` | Sum (cumulative, non-monotonic) | `{tx}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_read_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_read_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_write_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_write_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.proc_total` | Sum (cumulative, non-monotonic) | `{processes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.proc_used` | Sum (cumulative, non-monotonic) | `{processes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.proc_used_details.rate` | Sum (cumulative, non-monotonic) | `{processes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.processors` | Sum (cumulative, non-monotonic) | `{processors}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_created` | Sum (cumulative, non-monotonic) | `{queues}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_created_details.rate` | Sum (cumulative, non-monotonic) | `{queues}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_declared` | Sum (cumulative, non-monotonic) | `{queues}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_declared_details.rate` | Sum (cumulative, non-monotonic) | `{queues}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_deleted` | Sum (cumulative, non-monotonic) | `{queues}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_deleted_details.rate` | Sum (cumulative, non-monotonic) | `{queues}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_read_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_read_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_write_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_write_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.run_queue` | Sum (cumulative, non-monotonic) | `{threads}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.sockets_total` | Sum (cumulative, non-monotonic) | `{sockets}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.sockets_used` | Sum (cumulative, non-monotonic) | `{sockets}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.sockets_used_details.rate` | Sum (cumulative, non-monotonic) | `{sockets}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.uptime` | Sum (cumulative, non-monotonic) | `ms` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |

## Sources

- receiver/rabbitmqreceiver/metadata.yaml
- receiver/rabbitmqreceiver/scraper.go
- receiver/rabbitmqreceiver/factory.go
- receiver/rabbitmqreceiver/client.go
- receiver/rabbitmqreceiver/internal/metadata/generated_metrics.go
- receiver/rabbitmqreceiver/internal/metadata/generated_resource.go
        • v0.159.0.md 7.4 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/rabbitmqreceiver
version: v0.159.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/rabbitmqreceiver
commit_sha: 1120cc0714bf4d14600105e5673c3b00fe87467a
last_verified: 2026-10-14
---

# RabbitMQ Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| rabbitmq.exchange.messages_published | Sum | `{messages}` | `rabbitmq.exchange.name`, `rabbitmq.exchange.type`, `rabbitmq.vhost.name` | - |
| rabbitmq.node.channel_closed | Sum | `{channels}` | `rabbitmq.node.name` | - |
| rabbitmq.node.channel_closed_details.rate | Sum | `{channels}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.channel_created | Sum | `{channels}` | `rabbitmq.node.name` | - |
| rabbitmq.node.channel_created_details.rate | Sum | `{channels}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.connection_closed | Sum | `{connections}` | `rabbitmq.node.name` | - |
| rabbitmq.node.connection_closed_details.rate | Sum | `{connections}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.connection_created | Sum | `{connections}` | `rabbitmq.node.name` | - |
| rabbitmq.node.connection_created_details.rate | Sum | `{connections}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.context_switches | Sum | `{switches}` | `rabbitmq.node.name` | - |
| rabbitmq.node.context_switches_details.rate | Sum | `{switches}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.disk_free | Sum | `{bytes}` | `rabbitmq.node.name` | - |
| rabbitmq.node.disk_free_alarm | Sum | `{status}` | `rabbitmq.node.name` | - |
| rabbitmq.node.disk_free_details.rate | Sum | `{bytes}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.disk_free_limit | Sum | `{bytes}` | `rabbitmq.node.name` | - |
| rabbitmq.node.fd_total | Sum | `{fd}` | `rabbitmq.node.name` | - |
| rabbitmq.node.fd_used | Sum | `{fd}` | `rabbitmq.node.name` | - |
| rabbitmq.node.fd_used_details.rate | Sum | `{fd}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.gc_bytes_reclaimed | Sum | `{bytes}` | `rabbitmq.node.name` | - |
| rabbitmq.node.gc_bytes_reclaimed_details.rate | Sum | `{bytes}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.gc_num | Sum | `{collections}` | `rabbitmq.node.name` | - |
| rabbitmq.node.gc_num_details.rate | Sum | `{collections}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_read_avg_time | Sum | `ms` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_read_avg_time_details.rate | Sum | `ms/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_read_bytes | Sum | `{bytes}` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_read_bytes_details.rate | Sum | `{bytes}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_read_count | Sum | `{operations}` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_read_count_details.rate | Sum | `{operations}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_reopen_count | Sum | `{operations}` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_reopen_count_details.rate | Sum | `{operations}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_seek_avg_time | Sum | `ms` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_seek_avg_time_details.rate | Sum | `ms/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_seek_count | Sum | `{operations}` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_seek_count_details.rate | Sum | `{operations}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_sync_avg_time | Sum | `ms` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_sync_avg_time_details.rate | Sum | `ms/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_sync_count | Sum | `{operations}` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_sync_count_details.rate | Sum | `{operations}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_write_avg_time | Sum | `ms` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_write_avg_time_details.rate | Sum | `ms/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_write_bytes | Sum | `{bytes}` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_write_bytes_details.rate | Sum | `{bytes}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_write_count | Sum | `{operations}` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_write_count_details.rate | Sum | `{operations}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.mem_alarm | Sum | `{status}` | `rabbitmq.node.name` | - |
| rabbitmq.node.mem_limit | Sum | `{bytes}` | `rabbitmq.node.name` | - |
| rabbitmq.node.mem_used | Sum | `{bytes}` | `rabbitmq.node.name` | - |
| rabbitmq.node.mem_used_details.rate | Sum | `{bytes}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.mnesia_disk_tx_count | Sum | `{transactions}` | `rabbitmq.node.name` | - |
| rabbitmq.node.mnesia_disk_tx_count_details.rate | Sum | `{transactions}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.mnesia_ram_tx_count | Sum | `{transactions}` | `rabbitmq.node.name` | - |
| rabbitmq.node.mnesia_ram_tx_count_details.rate | Sum | `{transactions}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.msg_store_read_count | Sum | `{operations}` | `rabbitmq.node.name` | - |
| rabbitmq.node.msg_store_read_count_details.rate | Sum | `{operations}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.msg_store_write_count | Sum | `{operations}` | `rabbitmq.node.name` | - |
| rabbitmq.node.msg_store_write_count_details.rate | Sum | `{operations}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.processors | Sum | `{processors}` | `rabbitmq.node.name` | - |
| rabbitmq.node.proc_total | Sum | `{processes}` | `rabbitmq.node.name` | - |
| rabbitmq.node.proc_used | Sum | `{processes}` | `rabbitmq.node.name` | - |
| rabbitmq.node.proc_used_details.rate | Sum | `{processes}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.queue_created | Sum | `{queues}` | `rabbitmq.node.name` | - |
| rabbitmq.node.queue_created_details.rate | Sum | `{queues}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.queue_declared | Sum | `{queues}` | `rabbitmq.node.name` | - |
| rabbitmq.node.queue_declared_details.rate | Sum | `{queues}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.queue_deleted | Sum | `{queues}` | `rabbitmq.node.name` | - |
| rabbitmq.node.queue_deleted_details.rate | Sum | `{queues}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.queue_index_read_count | Sum | `{operations}` | `rabbitmq.node.name` | - |
| rabbitmq.node.queue_index_read_count_details.rate | Sum | `{operations}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.queue_index_write_count | Sum | `{operations}` | `rabbitmq.node.name` | - |
| rabbitmq.node.queue_index_write_count_details.rate | Sum | `{operations}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.run_queue | Sum | `{processes}` | `rabbitmq.node.name` | - |
| rabbitmq.node.sockets_total | Sum | `{sockets}` | `rabbitmq.node.name` | - |
| rabbitmq.node.sockets_used | Sum | `{sockets}` | `rabbitmq.node.name` | - |
| rabbitmq.node.sockets_used_details.rate | Sum | `{sockets}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.uptime | Sum | `ms` | `rabbitmq.node.name` | - |
| rabbitmq.queue.consumer_count | Sum | `{consumers}` | `rabbitmq.queue.name`, `rabbitmq.vhost.name` | - |
| rabbitmq.queue.messages | Sum | `{messages}` | `rabbitmq.queue.name`, `rabbitmq.vhost.name` | - |
| rabbitmq.queue.messages_ready | Sum | `{messages}` | `rabbitmq.queue.name`, `rabbitmq.vhost.name` | - |
| rabbitmq.queue.messages_unacknowledged | Sum | `{messages}` | `rabbitmq.queue.name`, `rabbitmq.vhost.name` | - |

## Sources

- `receiver/rabbitmqreceiver/metadata.yaml`
- `receiver/rabbitmqreceiver/scraper.go`
- `receiver/rabbitmqreceiver/internal/metadata/generated_metrics.go`
        • v0.160.0.md 16.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/rabbitmqreceiver
version: v0.160.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/rabbitmqreceiver
commit_sha: 982f20b8a8e8a2569fab3e27cf8b008e8a5080c1
last_verified: 2026-09-03
---

# RabbitMQ Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `rabbitmq.consumer.count` | Sum (cumulative, non-monotonic) | `{consumers}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.exchange.messages.published_in` | Sum (cumulative, monotonic) | `{messages}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.exchange.name`, `rabbitmq.exchange.type`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.exchange.messages.published_out` | Sum (cumulative, monotonic) | `{messages}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.exchange.name`, `rabbitmq.exchange.type`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.acknowledged` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.current` | Sum (cumulative, non-monotonic) | `{messages}` | `state` | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.delivered` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.dropped` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.published` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.node.channel_closed` | Sum (cumulative, non-monotonic) | `{channels}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.channel_closed_details.rate` | Sum (cumulative, non-monotonic) | `{channels}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.channel_created` | Sum (cumulative, non-monotonic) | `{channels}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.channel_created_details.rate` | Sum (cumulative, non-monotonic) | `{channels}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_closed` | Sum (cumulative, non-monotonic) | `{connections}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_closed_details.rate` | Sum (cumulative, non-monotonic) | `{connections}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_created` | Sum (cumulative, non-monotonic) | `{connections}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_created_details.rate` | Sum (cumulative, non-monotonic) | `{connections}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.context_switches` | Sum (cumulative, non-monotonic) | `{switches}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.context_switches_details.rate` | Sum (cumulative, non-monotonic) | `{switches}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free_alarm` | Sum (cumulative, non-monotonic) | `{status}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free_limit` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.fd_total` | Sum (cumulative, non-monotonic) | `{fd}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.fd_used` | Sum (cumulative, non-monotonic) | `{fd}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.fd_used_details.rate` | Sum (cumulative, non-monotonic) | `{fd}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_bytes_reclaimed` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_bytes_reclaimed_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_num` | Sum (cumulative, non-monotonic) | `{collections}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_num_details.rate` | Sum (cumulative, non-monotonic) | `{collections}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_bytes` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_bytes_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_reopen_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_reopen_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_bytes` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_bytes_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_alarm` | Sum (cumulative, non-monotonic) | `{status}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_limit` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_used` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_used_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_disk_tx_count` | Sum (cumulative, non-monotonic) | `{tx}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_disk_tx_count_details.rate` | Sum (cumulative, non-monotonic) | `{tx}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_ram_tx_count` | Sum (cumulative, non-monotonic) | `{tx}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_ram_tx_count_details.rate` | Sum (cumulative, non-monotonic) | `{tx}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_read_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_read_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_write_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_write_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.proc_total` | Sum (cumulative, non-monotonic) | `{processes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.proc_used` | Sum (cumulative, non-monotonic) | `{processes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.proc_used_details.rate` | Sum (cumulative, non-monotonic) | `{processes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.processors` | Sum (cumulative, non-monotonic) | `{processors}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_created` | Sum (cumulative, non-monotonic) | `{queues}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_created_details.rate` | Sum (cumulative, non-monotonic) | `{queues}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_declared` | Sum (cumulative, non-monotonic) | `{queues}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_declared_details.rate` | Sum (cumulative, non-monotonic) | `{queues}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_deleted` | Sum (cumulative, non-monotonic) | `{queues}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_deleted_details.rate` | Sum (cumulative, non-monotonic) | `{queues}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_read_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_read_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_write_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_write_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.run_queue` | Sum (cumulative, non-monotonic) | `{threads}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.sockets_total` | Sum (cumulative, non-monotonic) | `{sockets}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.sockets_used` | Sum (cumulative, non-monotonic) | `{sockets}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.sockets_used_details.rate` | Sum (cumulative, non-monotonic) | `{sockets}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.uptime` | Sum (cumulative, non-monotonic) | `ms` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |

## Sources

- receiver/rabbitmqreceiver/metadata.yaml
- receiver/rabbitmqreceiver/scraper.go
- receiver/rabbitmqreceiver/factory.go
- receiver/rabbitmqreceiver/client.go
- receiver/rabbitmqreceiver/internal/metadata/generated_metrics.go
- receiver/rabbitmqreceiver/internal/metadata/generated_resource.go
        • v0.161.0.md 16.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/rabbitmqreceiver
version: v0.161.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/rabbitmqreceiver
commit_sha: 3f8455d8038a985398861171e5310bc9b4e988b2
last_verified: 2026-10-03
---

# RabbitMQ Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `rabbitmq.consumer.count` | Sum (cumulative, non-monotonic) | `{consumers}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.exchange.messages.published_in` | Sum (cumulative, monotonic) | `{messages}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.exchange.name`, `rabbitmq.exchange.type`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.exchange.messages.published_out` | Sum (cumulative, monotonic) | `{messages}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.exchange.name`, `rabbitmq.exchange.type`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.acknowledged` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.current` | Sum (cumulative, non-monotonic) | `{messages}` | `state` | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.delivered` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.dropped` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.published` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.node.channel_closed` | Sum (cumulative, non-monotonic) | `{channels}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.channel_closed_details.rate` | Sum (cumulative, non-monotonic) | `{channels}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.channel_created` | Sum (cumulative, non-monotonic) | `{channels}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.channel_created_details.rate` | Sum (cumulative, non-monotonic) | `{channels}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_closed` | Sum (cumulative, non-monotonic) | `{connections}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_closed_details.rate` | Sum (cumulative, non-monotonic) | `{connections}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_created` | Sum (cumulative, non-monotonic) | `{connections}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_created_details.rate` | Sum (cumulative, non-monotonic) | `{connections}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.context_switches` | Sum (cumulative, non-monotonic) | `{switches}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.context_switches_details.rate` | Sum (cumulative, non-monotonic) | `{switches}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free_alarm` | Sum (cumulative, non-monotonic) | `{status}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free_limit` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.fd_total` | Sum (cumulative, non-monotonic) | `{fd}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.fd_used` | Sum (cumulative, non-monotonic) | `{fd}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.fd_used_details.rate` | Sum (cumulative, non-monotonic) | `{fd}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_bytes_reclaimed` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_bytes_reclaimed_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_num` | Sum (cumulative, non-monotonic) | `{collections}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_num_details.rate` | Sum (cumulative, non-monotonic) | `{collections}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_bytes` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_bytes_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_reopen_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_reopen_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_bytes` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_bytes_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_alarm` | Sum (cumulative, non-monotonic) | `{status}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_limit` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_used` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_used_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_disk_tx_count` | Sum (cumulative, non-monotonic) | `{tx}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_disk_tx_count_details.rate` | Sum (cumulative, non-monotonic) | `{tx}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_ram_tx_count` | Sum (cumulative, non-monotonic) | `{tx}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_ram_tx_count_details.rate` | Sum (cumulative, non-monotonic) | `{tx}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_read_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_read_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_write_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_write_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.proc_total` | Sum (cumulative, non-monotonic) | `{processes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.proc_used` | Sum (cumulative, non-monotonic) | `{processes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.proc_used_details.rate` | Sum (cumulative, non-monotonic) | `{processes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.processors` | Sum (cumulative, non-monotonic) | `{processors}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_created` | Sum (cumulative, non-monotonic) | `{queues}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_created_details.rate` | Sum (cumulative, non-monotonic) | `{queues}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_declared` | Sum (cumulative, non-monotonic) | `{queues}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_declared_details.rate` | Sum (cumulative, non-monotonic) | `{queues}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_deleted` | Sum (cumulative, non-monotonic) | `{queues}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_deleted_details.rate` | Sum (cumulative, non-monotonic) | `{queues}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_read_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_read_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_write_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_write_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.run_queue` | Sum (cumulative, non-monotonic) | `{threads}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.sockets_total` | Sum (cumulative, non-monotonic) | `{sockets}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.sockets_used` | Sum (cumulative, non-monotonic) | `{sockets}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.sockets_used_details.rate` | Sum (cumulative, non-monotonic) | `{sockets}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.uptime` | Sum (cumulative, non-monotonic) | `ms` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |

## Sources

- receiver/rabbitmqreceiver/metadata.yaml
- receiver/rabbitmqreceiver/scraper.go
- receiver/rabbitmqreceiver/factory.go
- receiver/rabbitmqreceiver/client.go
- receiver/rabbitmqreceiver/internal/metadata/generated_metrics.go
- receiver/rabbitmqreceiver/internal/metadata/generated_resource.go
        • v0.162.0.md 16.8 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/rabbitmqreceiver
version: v0.162.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/rabbitmqreceiver
commit_sha: ae8c507510f48f433ab47dd1c6b01a59d6c388b5
last_verified: 2026-10-03
---

# RabbitMQ Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `rabbitmq.consumer.count` | Sum (cumulative, non-monotonic) | `{consumers}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.exchange.messages.published_in` | Sum (cumulative, monotonic) | `{messages}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.exchange.name`, `rabbitmq.exchange.type`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.exchange.messages.published_out` | Sum (cumulative, monotonic) | `{messages}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.exchange.name`, `rabbitmq.exchange.type`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.acknowledged` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.current` | Sum (cumulative, non-monotonic) | `{messages}` | `state` | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.delivered` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.dropped` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.message.published` | Sum (cumulative, monotonic) | `{messages}` | - | Enabled by default. `rabbitmq.queue.name`, `rabbitmq.node.name`, and `rabbitmq.vhost.name` resource attributes. |
| `rabbitmq.node.channel_closed` | Sum (cumulative, non-monotonic) | `{channels}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.channel_closed_details.rate` | Sum (cumulative, non-monotonic) | `{channels}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.channel_created` | Sum (cumulative, non-monotonic) | `{channels}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.channel_created_details.rate` | Sum (cumulative, non-monotonic) | `{channels}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_closed` | Sum (cumulative, non-monotonic) | `{connections}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_closed_details.rate` | Sum (cumulative, non-monotonic) | `{connections}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_created` | Sum (cumulative, non-monotonic) | `{connections}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.connection_created_details.rate` | Sum (cumulative, non-monotonic) | `{connections}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.context_switches` | Sum (cumulative, non-monotonic) | `{switches}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.context_switches_details.rate` | Sum (cumulative, non-monotonic) | `{switches}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free_alarm` | Sum (cumulative, non-monotonic) | `{status}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.disk_free_limit` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.fd_total` | Sum (cumulative, non-monotonic) | `{fd}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.fd_used` | Sum (cumulative, non-monotonic) | `{fd}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.fd_used_details.rate` | Sum (cumulative, non-monotonic) | `{fd}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_bytes_reclaimed` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_bytes_reclaimed_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_num` | Sum (cumulative, non-monotonic) | `{collections}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.gc_num_details.rate` | Sum (cumulative, non-monotonic) | `{collections}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_bytes` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_bytes_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_read_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_reopen_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_reopen_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_seek_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_sync_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_avg_time` | Sum (cumulative, non-monotonic) | `{microseconds}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_avg_time_details.rate` | Sum (cumulative, non-monotonic) | `{microseconds}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_bytes` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_bytes_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.io_write_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_alarm` | Sum (cumulative, non-monotonic) | `{status}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_limit` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_used` | Sum (cumulative, non-monotonic) | `{bytes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mem_used_details.rate` | Sum (cumulative, non-monotonic) | `{bytes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_disk_tx_count` | Sum (cumulative, non-monotonic) | `{tx}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_disk_tx_count_details.rate` | Sum (cumulative, non-monotonic) | `{tx}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_ram_tx_count` | Sum (cumulative, non-monotonic) | `{tx}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.mnesia_ram_tx_count_details.rate` | Sum (cumulative, non-monotonic) | `{tx}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_read_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_read_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_write_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.msg_store_write_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.proc_total` | Sum (cumulative, non-monotonic) | `{processes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.proc_used` | Sum (cumulative, non-monotonic) | `{processes}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.proc_used_details.rate` | Sum (cumulative, non-monotonic) | `{processes}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.processors` | Sum (cumulative, non-monotonic) | `{processors}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_created` | Sum (cumulative, non-monotonic) | `{queues}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_created_details.rate` | Sum (cumulative, non-monotonic) | `{queues}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_declared` | Sum (cumulative, non-monotonic) | `{queues}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_declared_details.rate` | Sum (cumulative, non-monotonic) | `{queues}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_deleted` | Sum (cumulative, non-monotonic) | `{queues}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_deleted_details.rate` | Sum (cumulative, non-monotonic) | `{queues}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_read_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_read_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_write_count` | Sum (cumulative, non-monotonic) | `{ops}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.queue_index_write_count_details.rate` | Sum (cumulative, non-monotonic) | `{ops}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.run_queue` | Sum (cumulative, non-monotonic) | `{threads}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.sockets_total` | Sum (cumulative, non-monotonic) | `{sockets}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.sockets_used` | Sum (cumulative, non-monotonic) | `{sockets}` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.sockets_used_details.rate` | Sum (cumulative, non-monotonic) | `{sockets}/s` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |
| `rabbitmq.node.uptime` | Sum (cumulative, non-monotonic) | `ms` | - | Disabled by default; enable this metric in receiver.metrics. `rabbitmq.node.name` resource attribute. |

Optional resource attribute `rabbitmq.cluster.name` (disabled by default; enable with `resource_attributes.rabbitmq.cluster.name.enabled`) is added to every queue, node, and exchange resource; its value comes from `/api/cluster-name`, fetched once per scrape.

## Sources

- receiver/rabbitmqreceiver/metadata.yaml
- receiver/rabbitmqreceiver/scraper.go
- receiver/rabbitmqreceiver/factory.go
- receiver/rabbitmqreceiver/client.go
- receiver/rabbitmqreceiver/internal/metadata/generated_metrics.go
- receiver/rabbitmqreceiver/internal/metadata/generated_resource.go
        • v0.163.0.md 7.4 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/rabbitmqreceiver
version: v0.163.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/rabbitmqreceiver
commit_sha: df849b5403c041d5e799e7846392a6f18b0b55ae
last_verified: 2026-10-14
---

# RabbitMQ Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| rabbitmq.exchange.messages_published | Sum | `{messages}` | `rabbitmq.exchange.name`, `rabbitmq.exchange.type`, `rabbitmq.vhost.name` | - |
| rabbitmq.node.channel_closed | Sum | `{channels}` | `rabbitmq.node.name` | - |
| rabbitmq.node.channel_closed_details.rate | Sum | `{channels}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.channel_created | Sum | `{channels}` | `rabbitmq.node.name` | - |
| rabbitmq.node.channel_created_details.rate | Sum | `{channels}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.connection_closed | Sum | `{connections}` | `rabbitmq.node.name` | - |
| rabbitmq.node.connection_closed_details.rate | Sum | `{connections}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.connection_created | Sum | `{connections}` | `rabbitmq.node.name` | - |
| rabbitmq.node.connection_created_details.rate | Sum | `{connections}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.context_switches | Sum | `{switches}` | `rabbitmq.node.name` | - |
| rabbitmq.node.context_switches_details.rate | Sum | `{switches}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.disk_free | Sum | `{bytes}` | `rabbitmq.node.name` | - |
| rabbitmq.node.disk_free_alarm | Sum | `{status}` | `rabbitmq.node.name` | - |
| rabbitmq.node.disk_free_details.rate | Sum | `{bytes}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.disk_free_limit | Sum | `{bytes}` | `rabbitmq.node.name` | - |
| rabbitmq.node.fd_total | Sum | `{fd}` | `rabbitmq.node.name` | - |
| rabbitmq.node.fd_used | Sum | `{fd}` | `rabbitmq.node.name` | - |
| rabbitmq.node.fd_used_details.rate | Sum | `{fd}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.gc_bytes_reclaimed | Sum | `{bytes}` | `rabbitmq.node.name` | - |
| rabbitmq.node.gc_bytes_reclaimed_details.rate | Sum | `{bytes}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.gc_num | Sum | `{collections}` | `rabbitmq.node.name` | - |
| rabbitmq.node.gc_num_details.rate | Sum | `{collections}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_read_avg_time | Sum | `ms` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_read_avg_time_details.rate | Sum | `ms/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_read_bytes | Sum | `{bytes}` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_read_bytes_details.rate | Sum | `{bytes}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_read_count | Sum | `{operations}` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_read_count_details.rate | Sum | `{operations}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_reopen_count | Sum | `{operations}` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_reopen_count_details.rate | Sum | `{operations}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_seek_avg_time | Sum | `ms` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_seek_avg_time_details.rate | Sum | `ms/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_seek_count | Sum | `{operations}` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_seek_count_details.rate | Sum | `{operations}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_sync_avg_time | Sum | `ms` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_sync_avg_time_details.rate | Sum | `ms/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_sync_count | Sum | `{operations}` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_sync_count_details.rate | Sum | `{operations}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_write_avg_time | Sum | `ms` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_write_avg_time_details.rate | Sum | `ms/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_write_bytes | Sum | `{bytes}` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_write_bytes_details.rate | Sum | `{bytes}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_write_count | Sum | `{operations}` | `rabbitmq.node.name` | - |
| rabbitmq.node.io_write_count_details.rate | Sum | `{operations}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.mem_alarm | Sum | `{status}` | `rabbitmq.node.name` | - |
| rabbitmq.node.mem_limit | Sum | `{bytes}` | `rabbitmq.node.name` | - |
| rabbitmq.node.mem_used | Sum | `{bytes}` | `rabbitmq.node.name` | - |
| rabbitmq.node.mem_used_details.rate | Sum | `{bytes}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.mnesia_disk_tx_count | Sum | `{transactions}` | `rabbitmq.node.name` | - |
| rabbitmq.node.mnesia_disk_tx_count_details.rate | Sum | `{transactions}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.mnesia_ram_tx_count | Sum | `{transactions}` | `rabbitmq.node.name` | - |
| rabbitmq.node.mnesia_ram_tx_count_details.rate | Sum | `{transactions}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.msg_store_read_count | Sum | `{operations}` | `rabbitmq.node.name` | - |
| rabbitmq.node.msg_store_read_count_details.rate | Sum | `{operations}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.msg_store_write_count | Sum | `{operations}` | `rabbitmq.node.name` | - |
| rabbitmq.node.msg_store_write_count_details.rate | Sum | `{operations}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.processors | Sum | `{processors}` | `rabbitmq.node.name` | - |
| rabbitmq.node.proc_total | Sum | `{processes}` | `rabbitmq.node.name` | - |
| rabbitmq.node.proc_used | Sum | `{processes}` | `rabbitmq.node.name` | - |
| rabbitmq.node.proc_used_details.rate | Sum | `{processes}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.queue_created | Sum | `{queues}` | `rabbitmq.node.name` | - |
| rabbitmq.node.queue_created_details.rate | Sum | `{queues}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.queue_declared | Sum | `{queues}` | `rabbitmq.node.name` | - |
| rabbitmq.node.queue_declared_details.rate | Sum | `{queues}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.queue_deleted | Sum | `{queues}` | `rabbitmq.node.name` | - |
| rabbitmq.node.queue_deleted_details.rate | Sum | `{queues}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.queue_index_read_count | Sum | `{operations}` | `rabbitmq.node.name` | - |
| rabbitmq.node.queue_index_read_count_details.rate | Sum | `{operations}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.queue_index_write_count | Sum | `{operations}` | `rabbitmq.node.name` | - |
| rabbitmq.node.queue_index_write_count_details.rate | Sum | `{operations}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.run_queue | Sum | `{processes}` | `rabbitmq.node.name` | - |
| rabbitmq.node.sockets_total | Sum | `{sockets}` | `rabbitmq.node.name` | - |
| rabbitmq.node.sockets_used | Sum | `{sockets}` | `rabbitmq.node.name` | - |
| rabbitmq.node.sockets_used_details.rate | Sum | `{sockets}/s` | `rabbitmq.node.name` | - |
| rabbitmq.node.uptime | Sum | `ms` | `rabbitmq.node.name` | - |
| rabbitmq.queue.consumer_count | Sum | `{consumers}` | `rabbitmq.queue.name`, `rabbitmq.vhost.name` | - |
| rabbitmq.queue.messages | Sum | `{messages}` | `rabbitmq.queue.name`, `rabbitmq.vhost.name` | - |
| rabbitmq.queue.messages_ready | Sum | `{messages}` | `rabbitmq.queue.name`, `rabbitmq.vhost.name` | - |
| rabbitmq.queue.messages_unacknowledged | Sum | `{messages}` | `rabbitmq.queue.name`, `rabbitmq.vhost.name` | - |

## Sources

- `receiver/rabbitmqreceiver/metadata.yaml`
- `receiver/rabbitmqreceiver/scraper.go`
- `receiver/rabbitmqreceiver/internal/metadata/generated_metrics.go`
      • redisreceiver
        • v0.153.0.md 6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/redisreceiver
version: v0.153.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/redisreceiver
commit_sha: 42f949127580c0d00088b785cd0b35842dc0ddb8
last_verified: 2026-08-11
---

# Redis Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `redis.clients.blocked` | Sum (int) | `{client}` | - | - |
| `redis.clients.connected` | Sum (int) | `{client}` | - | - |
| `redis.clients.max_input_buffer` | Gauge (int) | `By` | - | - |
| `redis.clients.max_output_buffer` | Gauge (int) | `By` | - | - |
| `redis.cluster.cluster_enabled` | Gauge (int) | `1` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.known_nodes` | Gauge (int) | `{node}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.links_buffer_limit_exceeded.count` | Sum (int) | `{count}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.node.count` | Gauge (int) | `{node}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.node.uptime` | Gauge (int) | `s` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_assigned` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_fail` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_ok` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_pfail` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.state` | Gauge (int) | `{state}` | cluster_state | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.stats_messages_received` | Sum (int) | `{message}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.stats_messages_sent` | Sum (int) | `{message}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.uptime` | Gauge (int) | `s` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cmd.calls` | Sum (int) | `{call}` | cmd | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cmd.latency` | Gauge (double) | `s` | cmd, percentile | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cmd.usec` | Sum (int) | `us` | cmd | Disabled by default; enable via the receiver metrics configuration. |
| `redis.commands` | Gauge (int) | `{ops}/s` | - | - |
| `redis.commands.processed` | Sum (int) | `{command}` | - | - |
| `redis.connections.received` | Sum (int) | `{connection}` | - | - |
| `redis.connections.rejected` | Sum (int) | `{connection}` | - | - |
| `redis.cpu.time` | Sum (double) | `s` | state | - |
| `redis.db.avg_ttl` | Gauge (int) | `ms` | db | - |
| `redis.db.expires` | Gauge (int) | `{key}` | db | - |
| `redis.db.keys` | Gauge (int) | `{key}` | db | - |
| `redis.keys.evicted` | Sum (int) | `{key}` | - | - |
| `redis.keys.expired` | Sum (int) | `{event}` | - | - |
| `redis.keyspace.hits` | Sum (int) | `{hit}` | - | - |
| `redis.keyspace.misses` | Sum (int) | `{miss}` | - | - |
| `redis.latest_fork` | Gauge (int) | `us` | - | - |
| `redis.maxmemory` | Gauge (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.memory.fragmentation_ratio` | Gauge (double) | `1` | - | - |
| `redis.memory.lua` | Gauge (int) | `By` | - | - |
| `redis.memory.peak` | Gauge (int) | `By` | - | - |
| `redis.memory.rss` | Gauge (int) | `By` | - | - |
| `redis.memory.used` | Gauge (int) | `By` | - | - |
| `redis.memory.used_memory_overhead` | Sum (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.memory.used_memory_startup` | Sum (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.mode` | Gauge (int) | `{mode}` | mode | Disabled by default; enable via the receiver metrics configuration. |
| `redis.net.input` | Sum (int) | `By` | - | - |
| `redis.net.output` | Sum (int) | `By` | - | - |
| `redis.rdb.changes_since_last_save` | Sum (int) | `{change}` | - | - |
| `redis.replication.backlog_first_byte_offset` | Gauge (int) | `By` | - | - |
| `redis.replication.offset` | Gauge (int) | `By` | - | - |
| `redis.replication.replica_offset` | Gauge (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.role` | Sum (int) | `{role}` | role | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.masters` | Gauge (int) | `{master}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.running_scripts` | Gauge (int) | `{script}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.scripts_queue_length` | Gauge (int) | `{script}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.simulate_failure_flags` | Gauge (int) | `{flag}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.tilt_since_seconds` | Gauge (int) | `s` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.total_tilt` | Sum (int) | `{event}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.slaves.connected` | Sum (int) | `{replica}` | - | - |
| `redis.tracking_total_keys` | Sum (int) | `{key}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.uptime` | Sum (int) | `s` | - | - |

## Sources

- receiver/redisreceiver/metadata.yaml
- receiver/redisreceiver/redis_scraper.go
- receiver/redisreceiver/metric_functions.go
- receiver/redisreceiver/keyspace.go
- receiver/redisreceiver/latencystats.go
- receiver/redisreceiver/config.go
        • v0.154.0.md 6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/redisreceiver
version: v0.154.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/redisreceiver
commit_sha: 853eda0e12b3ba142552ecd2b63cec07062904f0
last_verified: 2026-08-11
---

# Redis Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `redis.clients.blocked` | Sum (int) | `{client}` | - | - |
| `redis.clients.connected` | Sum (int) | `{client}` | - | - |
| `redis.clients.max_input_buffer` | Gauge (int) | `By` | - | - |
| `redis.clients.max_output_buffer` | Gauge (int) | `By` | - | - |
| `redis.cluster.cluster_enabled` | Gauge (int) | `1` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.known_nodes` | Gauge (int) | `{node}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.links_buffer_limit_exceeded.count` | Sum (int) | `{count}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.node.count` | Gauge (int) | `{node}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.node.uptime` | Gauge (int) | `s` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_assigned` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_fail` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_ok` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_pfail` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.state` | Gauge (int) | `{state}` | cluster_state | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.stats_messages_received` | Sum (int) | `{message}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.stats_messages_sent` | Sum (int) | `{message}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.uptime` | Gauge (int) | `s` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cmd.calls` | Sum (int) | `{call}` | cmd | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cmd.latency` | Gauge (double) | `s` | cmd, percentile | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cmd.usec` | Sum (int) | `us` | cmd | Disabled by default; enable via the receiver metrics configuration. |
| `redis.commands` | Gauge (int) | `{ops}/s` | - | - |
| `redis.commands.processed` | Sum (int) | `{command}` | - | - |
| `redis.connections.received` | Sum (int) | `{connection}` | - | - |
| `redis.connections.rejected` | Sum (int) | `{connection}` | - | - |
| `redis.cpu.time` | Sum (double) | `s` | state | - |
| `redis.db.avg_ttl` | Gauge (int) | `ms` | db | - |
| `redis.db.expires` | Gauge (int) | `{key}` | db | - |
| `redis.db.keys` | Gauge (int) | `{key}` | db | - |
| `redis.keys.evicted` | Sum (int) | `{key}` | - | - |
| `redis.keys.expired` | Sum (int) | `{event}` | - | - |
| `redis.keyspace.hits` | Sum (int) | `{hit}` | - | - |
| `redis.keyspace.misses` | Sum (int) | `{miss}` | - | - |
| `redis.latest_fork` | Gauge (int) | `us` | - | - |
| `redis.maxmemory` | Gauge (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.memory.fragmentation_ratio` | Gauge (double) | `1` | - | - |
| `redis.memory.lua` | Gauge (int) | `By` | - | - |
| `redis.memory.peak` | Gauge (int) | `By` | - | - |
| `redis.memory.rss` | Gauge (int) | `By` | - | - |
| `redis.memory.used` | Gauge (int) | `By` | - | - |
| `redis.memory.used_memory_overhead` | Sum (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.memory.used_memory_startup` | Sum (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.mode` | Gauge (int) | `{mode}` | mode | Disabled by default; enable via the receiver metrics configuration. |
| `redis.net.input` | Sum (int) | `By` | - | - |
| `redis.net.output` | Sum (int) | `By` | - | - |
| `redis.rdb.changes_since_last_save` | Sum (int) | `{change}` | - | - |
| `redis.replication.backlog_first_byte_offset` | Gauge (int) | `By` | - | - |
| `redis.replication.offset` | Gauge (int) | `By` | - | - |
| `redis.replication.replica_offset` | Gauge (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.role` | Sum (int) | `{role}` | role | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.masters` | Gauge (int) | `{master}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.running_scripts` | Gauge (int) | `{script}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.scripts_queue_length` | Gauge (int) | `{script}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.simulate_failure_flags` | Gauge (int) | `{flag}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.tilt_since_seconds` | Gauge (int) | `s` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.total_tilt` | Sum (int) | `{event}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.slaves.connected` | Sum (int) | `{replica}` | - | - |
| `redis.tracking_total_keys` | Sum (int) | `{key}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.uptime` | Sum (int) | `s` | - | - |

## Sources

- receiver/redisreceiver/metadata.yaml
- receiver/redisreceiver/redis_scraper.go
- receiver/redisreceiver/metric_functions.go
- receiver/redisreceiver/keyspace.go
- receiver/redisreceiver/latencystats.go
- receiver/redisreceiver/config.go
        • v0.155.0.md 6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/redisreceiver
version: v0.155.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/redisreceiver
commit_sha: aaf5045a24c0a6f000225c97ad5449e69aeb5835
last_verified: 2026-08-11
---

# Redis Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `redis.clients.blocked` | Sum (int) | `{client}` | - | - |
| `redis.clients.connected` | Sum (int) | `{client}` | - | - |
| `redis.clients.max_input_buffer` | Gauge (int) | `By` | - | - |
| `redis.clients.max_output_buffer` | Gauge (int) | `By` | - | - |
| `redis.cluster.cluster_enabled` | Gauge (int) | `1` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.known_nodes` | Gauge (int) | `{node}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.links_buffer_limit_exceeded.count` | Sum (int) | `{count}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.node.count` | Gauge (int) | `{node}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.node.uptime` | Gauge (int) | `s` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_assigned` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_fail` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_ok` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_pfail` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.state` | Gauge (int) | `{state}` | cluster_state | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.stats_messages_received` | Sum (int) | `{message}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.stats_messages_sent` | Sum (int) | `{message}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.uptime` | Gauge (int) | `s` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cmd.calls` | Sum (int) | `{call}` | cmd | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cmd.latency` | Gauge (double) | `s` | cmd, percentile | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cmd.usec` | Sum (int) | `us` | cmd | Disabled by default; enable via the receiver metrics configuration. |
| `redis.commands` | Gauge (int) | `{ops}/s` | - | - |
| `redis.commands.processed` | Sum (int) | `{command}` | - | - |
| `redis.connections.received` | Sum (int) | `{connection}` | - | - |
| `redis.connections.rejected` | Sum (int) | `{connection}` | - | - |
| `redis.cpu.time` | Sum (double) | `s` | state | - |
| `redis.db.avg_ttl` | Gauge (int) | `ms` | db | - |
| `redis.db.expires` | Gauge (int) | `{key}` | db | - |
| `redis.db.keys` | Gauge (int) | `{key}` | db | - |
| `redis.keys.evicted` | Sum (int) | `{key}` | - | - |
| `redis.keys.expired` | Sum (int) | `{event}` | - | - |
| `redis.keyspace.hits` | Sum (int) | `{hit}` | - | - |
| `redis.keyspace.misses` | Sum (int) | `{miss}` | - | - |
| `redis.latest_fork` | Gauge (int) | `us` | - | - |
| `redis.maxmemory` | Gauge (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.memory.fragmentation_ratio` | Gauge (double) | `1` | - | - |
| `redis.memory.lua` | Gauge (int) | `By` | - | - |
| `redis.memory.peak` | Gauge (int) | `By` | - | - |
| `redis.memory.rss` | Gauge (int) | `By` | - | - |
| `redis.memory.used` | Gauge (int) | `By` | - | - |
| `redis.memory.used_memory_overhead` | Sum (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.memory.used_memory_startup` | Sum (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.mode` | Gauge (int) | `{mode}` | mode | Disabled by default; enable via the receiver metrics configuration. |
| `redis.net.input` | Sum (int) | `By` | - | - |
| `redis.net.output` | Sum (int) | `By` | - | - |
| `redis.rdb.changes_since_last_save` | Sum (int) | `{change}` | - | - |
| `redis.replication.backlog_first_byte_offset` | Gauge (int) | `By` | - | - |
| `redis.replication.offset` | Gauge (int) | `By` | - | - |
| `redis.replication.replica_offset` | Gauge (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.role` | Sum (int) | `{role}` | role | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.masters` | Gauge (int) | `{master}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.running_scripts` | Gauge (int) | `{script}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.scripts_queue_length` | Gauge (int) | `{script}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.simulate_failure_flags` | Gauge (int) | `{flag}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.tilt_since_seconds` | Gauge (int) | `s` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.total_tilt` | Sum (int) | `{event}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.slaves.connected` | Sum (int) | `{replica}` | - | - |
| `redis.tracking_total_keys` | Sum (int) | `{key}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.uptime` | Sum (int) | `s` | - | - |

## Sources

- receiver/redisreceiver/metadata.yaml
- receiver/redisreceiver/redis_scraper.go
- receiver/redisreceiver/metric_functions.go
- receiver/redisreceiver/keyspace.go
- receiver/redisreceiver/latencystats.go
- receiver/redisreceiver/config.go
        • v0.156.0.md 6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/redisreceiver
version: v0.156.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/redisreceiver
commit_sha: 41e24cd516dd69a5b4277465cdb2ff4ef0676f49
last_verified: 2026-08-06
---

# Redis Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `redis.clients.blocked` | Sum (int) | `{client}` | - | - |
| `redis.clients.connected` | Sum (int) | `{client}` | - | - |
| `redis.clients.max_input_buffer` | Gauge (int) | `By` | - | - |
| `redis.clients.max_output_buffer` | Gauge (int) | `By` | - | - |
| `redis.cluster.cluster_enabled` | Gauge (int) | `1` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.known_nodes` | Gauge (int) | `{node}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.links_buffer_limit_exceeded.count` | Sum (int) | `{count}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.node.count` | Gauge (int) | `{node}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.node.uptime` | Gauge (int) | `s` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_assigned` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_fail` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_ok` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_pfail` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.state` | Gauge (int) | `{state}` | cluster_state | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.stats_messages_received` | Sum (int) | `{message}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.stats_messages_sent` | Sum (int) | `{message}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.uptime` | Gauge (int) | `s` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cmd.calls` | Sum (int) | `{call}` | cmd | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cmd.latency` | Gauge (double) | `s` | cmd, percentile | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cmd.usec` | Sum (int) | `us` | cmd | Disabled by default; enable via the receiver metrics configuration. |
| `redis.commands` | Gauge (int) | `{ops}/s` | - | - |
| `redis.commands.processed` | Sum (int) | `{command}` | - | - |
| `redis.connections.received` | Sum (int) | `{connection}` | - | - |
| `redis.connections.rejected` | Sum (int) | `{connection}` | - | - |
| `redis.cpu.time` | Sum (double) | `s` | state | - |
| `redis.db.avg_ttl` | Gauge (int) | `ms` | db | - |
| `redis.db.expires` | Gauge (int) | `{key}` | db | - |
| `redis.db.keys` | Gauge (int) | `{key}` | db | - |
| `redis.keys.evicted` | Sum (int) | `{key}` | - | - |
| `redis.keys.expired` | Sum (int) | `{event}` | - | - |
| `redis.keyspace.hits` | Sum (int) | `{hit}` | - | - |
| `redis.keyspace.misses` | Sum (int) | `{miss}` | - | - |
| `redis.latest_fork` | Gauge (int) | `us` | - | - |
| `redis.maxmemory` | Gauge (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.memory.fragmentation_ratio` | Gauge (double) | `1` | - | - |
| `redis.memory.lua` | Gauge (int) | `By` | - | - |
| `redis.memory.peak` | Gauge (int) | `By` | - | - |
| `redis.memory.rss` | Gauge (int) | `By` | - | - |
| `redis.memory.used` | Gauge (int) | `By` | - | - |
| `redis.memory.used_memory_overhead` | Sum (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.memory.used_memory_startup` | Sum (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.mode` | Gauge (int) | `{mode}` | mode | Disabled by default; enable via the receiver metrics configuration. |
| `redis.net.input` | Sum (int) | `By` | - | - |
| `redis.net.output` | Sum (int) | `By` | - | - |
| `redis.rdb.changes_since_last_save` | Sum (int) | `{change}` | - | - |
| `redis.replication.backlog_first_byte_offset` | Gauge (int) | `By` | - | - |
| `redis.replication.offset` | Gauge (int) | `By` | - | - |
| `redis.replication.replica_offset` | Gauge (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.role` | Sum (int) | `{role}` | role | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.masters` | Gauge (int) | `{master}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.running_scripts` | Gauge (int) | `{script}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.scripts_queue_length` | Gauge (int) | `{script}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.simulate_failure_flags` | Gauge (int) | `{flag}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.tilt_since_seconds` | Gauge (int) | `s` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.total_tilt` | Sum (int) | `{event}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.slaves.connected` | Sum (int) | `{replica}` | - | - |
| `redis.tracking_total_keys` | Sum (int) | `{key}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.uptime` | Sum (int) | `s` | - | - |

## Sources

- receiver/redisreceiver/metadata.yaml
- receiver/redisreceiver/redis_scraper.go
- receiver/redisreceiver/metric_functions.go
- receiver/redisreceiver/keyspace.go
- receiver/redisreceiver/latencystats.go
- receiver/redisreceiver/config.go
        • v0.157.0.md 6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/redisreceiver
version: v0.157.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/redisreceiver
commit_sha: 89e43555904cd97c2d36605347c5d5237b1bdc8c
last_verified: 2026-08-06
---

# Redis Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `redis.clients.blocked` | Sum (int) | `{client}` | - | - |
| `redis.clients.connected` | Sum (int) | `{client}` | - | - |
| `redis.clients.max_input_buffer` | Gauge (int) | `By` | - | - |
| `redis.clients.max_output_buffer` | Gauge (int) | `By` | - | - |
| `redis.cluster.cluster_enabled` | Gauge (int) | `1` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.known_nodes` | Gauge (int) | `{node}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.links_buffer_limit_exceeded.count` | Sum (int) | `{count}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.node.count` | Gauge (int) | `{node}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.node.uptime` | Gauge (int) | `s` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_assigned` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_fail` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_ok` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_pfail` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.state` | Gauge (int) | `{state}` | cluster_state | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.stats_messages_received` | Sum (int) | `{message}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.stats_messages_sent` | Sum (int) | `{message}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.uptime` | Gauge (int) | `s` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cmd.calls` | Sum (int) | `{call}` | cmd | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cmd.latency` | Gauge (double) | `s` | cmd, percentile | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cmd.usec` | Sum (int) | `us` | cmd | Disabled by default; enable via the receiver metrics configuration. |
| `redis.commands` | Gauge (int) | `{ops}/s` | - | - |
| `redis.commands.processed` | Sum (int) | `{command}` | - | - |
| `redis.connections.received` | Sum (int) | `{connection}` | - | - |
| `redis.connections.rejected` | Sum (int) | `{connection}` | - | - |
| `redis.cpu.time` | Sum (double) | `s` | state | - |
| `redis.db.avg_ttl` | Gauge (int) | `ms` | db | - |
| `redis.db.expires` | Gauge (int) | `{key}` | db | - |
| `redis.db.keys` | Gauge (int) | `{key}` | db | - |
| `redis.keys.evicted` | Sum (int) | `{key}` | - | - |
| `redis.keys.expired` | Sum (int) | `{event}` | - | - |
| `redis.keyspace.hits` | Sum (int) | `{hit}` | - | - |
| `redis.keyspace.misses` | Sum (int) | `{miss}` | - | - |
| `redis.latest_fork` | Gauge (int) | `us` | - | - |
| `redis.maxmemory` | Gauge (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.memory.fragmentation_ratio` | Gauge (double) | `1` | - | - |
| `redis.memory.lua` | Gauge (int) | `By` | - | - |
| `redis.memory.peak` | Gauge (int) | `By` | - | - |
| `redis.memory.rss` | Gauge (int) | `By` | - | - |
| `redis.memory.used` | Gauge (int) | `By` | - | - |
| `redis.memory.used_memory_overhead` | Sum (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.memory.used_memory_startup` | Sum (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.mode` | Gauge (int) | `{mode}` | mode | Disabled by default; enable via the receiver metrics configuration. |
| `redis.net.input` | Sum (int) | `By` | - | - |
| `redis.net.output` | Sum (int) | `By` | - | - |
| `redis.rdb.changes_since_last_save` | Sum (int) | `{change}` | - | - |
| `redis.replication.backlog_first_byte_offset` | Gauge (int) | `By` | - | - |
| `redis.replication.offset` | Gauge (int) | `By` | - | - |
| `redis.replication.replica_offset` | Gauge (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.role` | Sum (int) | `{role}` | role | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.masters` | Gauge (int) | `{master}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.running_scripts` | Gauge (int) | `{script}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.scripts_queue_length` | Gauge (int) | `{script}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.simulate_failure_flags` | Gauge (int) | `{flag}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.tilt_since_seconds` | Gauge (int) | `s` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.total_tilt` | Sum (int) | `{event}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.slaves.connected` | Sum (int) | `{replica}` | - | - |
| `redis.tracking_total_keys` | Sum (int) | `{key}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.uptime` | Sum (int) | `s` | - | - |

## Sources

- receiver/redisreceiver/metadata.yaml
- receiver/redisreceiver/redis_scraper.go
- receiver/redisreceiver/metric_functions.go
- receiver/redisreceiver/keyspace.go
- receiver/redisreceiver/latencystats.go
- receiver/redisreceiver/config.go
        • v0.158.0.md 6.5 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/redisreceiver
version: v0.158.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/redisreceiver
commit_sha: 821a9d9c2c1623c4a0ceba5d47b57c48879c3f84
last_verified: 2026-08-06
---

# Redis Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `redis.clients.blocked` | Sum (int) | `{client}` | - | - |
| `redis.clients.connected` | Sum (int) | `{client}` | - | - |
| `redis.clients.max_input_buffer` | Gauge (int) | `By` | - | - |
| `redis.clients.max_output_buffer` | Gauge (int) | `By` | - | - |
| `redis.cluster.cluster_enabled` | Gauge (int) | `1` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.known_nodes` | Gauge (int) | `{node}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.links_buffer_limit_exceeded.count` | Sum (int) | `{count}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.node.count` | Gauge (int) | `{node}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.node.uptime` | Gauge (int) | `s` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_assigned` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_fail` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_ok` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_pfail` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.state` | Gauge (int) | `{state}` | cluster_state | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.stats_messages_received` | Sum (int) | `{message}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.stats_messages_sent` | Sum (int) | `{message}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.uptime` | Gauge (int) | `s` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cmd.calls` | Sum (int) | `{call}` | cmd | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cmd.latency` | Gauge (double) | `s` | cmd, percentile | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cmd.usec` | Sum (int) | `us` | cmd | Disabled by default; enable via the receiver metrics configuration. |
| `redis.commands` | Gauge (int) | `{ops}/s` | - | - |
| `redis.commands.processed` | Sum (int) | `{command}` | - | - |
| `redis.connections.received` | Sum (int) | `{connection}` | - | - |
| `redis.connections.rejected` | Sum (int) | `{connection}` | - | - |
| `redis.cpu.time` | Sum (double) | `s` | state | - |
| `redis.db.avg_ttl` | Gauge (int) | `ms` | db | - |
| `redis.db.expires` | Gauge (int) | `{key}` | db | - |
| `redis.db.keys` | Gauge (int) | `{key}` | db | - |
| `redis.keys.evicted` | Sum (int) | `{key}` | - | - |
| `redis.keys.expired` | Sum (int) | `{event}` | - | - |
| `redis.keyspace.hits` | Sum (int) | `{hit}` | - | - |
| `redis.keyspace.misses` | Sum (int) | `{miss}` | - | - |
| `redis.latest_fork` | Gauge (int) | `us` | - | - |
| `redis.maxmemory` | Gauge (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.memory.fragmentation_ratio` | Gauge (double) | `1` | - | - |
| `redis.memory.lua` | Gauge (int) | `By` | - | - |
| `redis.memory.peak` | Gauge (int) | `By` | - | - |
| `redis.memory.rss` | Gauge (int) | `By` | - | - |
| `redis.memory.used` | Gauge (int) | `By` | - | - |
| `redis.memory.used_memory_overhead` | Sum (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.memory.used_memory_startup` | Sum (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.mode` | Gauge (int) | `{mode}` | mode | Disabled by default; enable via the receiver metrics configuration. |
| `redis.net.input` | Sum (int) | `By` | - | - |
| `redis.net.output` | Sum (int) | `By` | - | - |
| `redis.pubsub.channel.status` | Sum (int) | `{channel}` | redis.pubsub.channel.state | Disabled by default; enable via the receiver metrics configuration. |
| `redis.pubsub.connection.count` | Sum (int) | `{client}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.pubsub.pattern.status` | Sum (int) | `{pattern}` | redis.pubsub.pattern.state | Disabled by default; enable via the receiver metrics configuration. |
| `redis.rdb.changes_since_last_save` | Sum (int) | `{change}` | - | - |
| `redis.replication.backlog_first_byte_offset` | Gauge (int) | `By` | - | - |
| `redis.replication.offset` | Gauge (int) | `By` | - | - |
| `redis.replication.replica_offset` | Gauge (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.role` | Sum (int) | `{role}` | role | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.masters` | Gauge (int) | `{master}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.running_scripts` | Gauge (int) | `{script}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.scripts_queue_length` | Gauge (int) | `{script}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.simulate_failure_flags` | Gauge (int) | `{flag}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.tilt_since_seconds` | Gauge (int) | `s` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.total_tilt` | Sum (int) | `{event}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.slaves.connected` | Sum (int) | `{replica}` | - | - |
| `redis.tracking_total_keys` | Sum (int) | `{key}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.uptime` | Sum (int) | `s` | - | - |

## Sources

- receiver/redisreceiver/metadata.yaml
- receiver/redisreceiver/redis_scraper.go
- receiver/redisreceiver/metric_functions.go
- receiver/redisreceiver/keyspace.go
- receiver/redisreceiver/latencystats.go
- receiver/redisreceiver/config.go
        • v0.159.0.md 1.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/redisreceiver
version: v0.159.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/redisreceiver
commit_sha: 1120cc0714bf4d14600105e5673c3b00fe87467a
last_verified: null
---

# Redis Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| redis.clients.blocked | Gauge | 1 | - | - |
| redis.clients.connected | Gauge | 1 | - | - |
| redis.clients.max_input_buffer | Gauge | By | - | - |
| redis.clients.max_output_buffer | Gauge | By | - | - |
| redis.commands | Sum (monotonic) | 1 | - | - |
| redis.commands.processed | Sum (monotonic) | 1 | - | - |
| redis.connections.received | Sum (monotonic) | 1 | - | - |
| redis.connections.rejected | Sum (monotonic) | 1 | - | - |
| redis.cpu.time | Sum (monotonic) | s | state | - |
| redis.db.avg_ttl | Gauge | ms | db | - |
| redis.db.expires | Gauge | 1 | db | - |
| redis.db.keys | Gauge | 1 | db | - |
| redis.keys.evicted | Sum (monotonic) | 1 | - | - |
| redis.keys.expired | Sum (monotonic) | 1 | - | - |
| redis.keyspace.hits | Sum (monotonic) | 1 | - | - |
| redis.keyspace.misses | Sum (monotonic) | 1 | - | - |
| redis.latest_fork | Gauge | s | - | - |
| redis.memory.fragmentation_ratio | Gauge | 1 | - | - |
| redis.memory.lua | Gauge | By | - | - |
| redis.memory.peak | Gauge | By | - | - |
| redis.memory.rss | Gauge | By | - | - |
| redis.memory.used | Gauge | By | - | - |
| redis.net.input | Sum (monotonic) | By | - | - |
| redis.net.output | Sum (monotonic) | By | - | - |
| redis.rdb.changes_since_last_save | Gauge | 1 | - | - |
| redis.replication.backlog_first_byte_offset | Gauge | 1 | - | - |
| redis.replication.offset | Gauge | 1 | - | - |
| redis.slaves.connected | Gauge | 1 | - | - |
| redis.uptime | Gauge | s | - | - |

## Sources

- `receiver/redisreceiver/metadata.yaml`
- `receiver/redisreceiver/redis_scraper.go`
- `receiver/redisreceiver/metric_functions.go`
        • v0.160.0.md 6.5 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/redisreceiver
version: v0.160.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/redisreceiver
commit_sha: 982f20b8a8e8a2569fab3e27cf8b008e8a5080c1
last_verified: 2026-09-03
---

# Redis Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `redis.clients.blocked` | Sum (int) | `{client}` | - | - |
| `redis.clients.connected` | Sum (int) | `{client}` | - | - |
| `redis.clients.max_input_buffer` | Gauge (int) | `By` | - | - |
| `redis.clients.max_output_buffer` | Gauge (int) | `By` | - | - |
| `redis.cluster.cluster_enabled` | Gauge (int) | `1` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.known_nodes` | Gauge (int) | `{node}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.links_buffer_limit_exceeded.count` | Sum (int) | `{count}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.node.count` | Gauge (int) | `{node}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.node.uptime` | Gauge (int) | `s` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_assigned` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_fail` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_ok` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_pfail` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.state` | Gauge (int) | `{state}` | cluster_state | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.stats_messages_received` | Sum (int) | `{message}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.stats_messages_sent` | Sum (int) | `{message}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.uptime` | Gauge (int) | `s` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cmd.calls` | Sum (int) | `{call}` | cmd | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cmd.latency` | Gauge (double) | `s` | cmd, percentile | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cmd.usec` | Sum (int) | `us` | cmd | Disabled by default; enable via the receiver metrics configuration. |
| `redis.commands` | Gauge (int) | `{ops}/s` | - | - |
| `redis.commands.processed` | Sum (int) | `{command}` | - | - |
| `redis.connections.received` | Sum (int) | `{connection}` | - | - |
| `redis.connections.rejected` | Sum (int) | `{connection}` | - | - |
| `redis.cpu.time` | Sum (double) | `s` | state | - |
| `redis.db.avg_ttl` | Gauge (int) | `ms` | db | - |
| `redis.db.expires` | Gauge (int) | `{key}` | db | - |
| `redis.db.keys` | Gauge (int) | `{key}` | db | - |
| `redis.keys.evicted` | Sum (int) | `{key}` | - | - |
| `redis.keys.expired` | Sum (int) | `{event}` | - | - |
| `redis.keyspace.hits` | Sum (int) | `{hit}` | - | - |
| `redis.keyspace.misses` | Sum (int) | `{miss}` | - | - |
| `redis.latest_fork` | Gauge (int) | `us` | - | - |
| `redis.maxmemory` | Gauge (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.memory.fragmentation_ratio` | Gauge (double) | `1` | - | - |
| `redis.memory.lua` | Gauge (int) | `By` | - | - |
| `redis.memory.peak` | Gauge (int) | `By` | - | - |
| `redis.memory.rss` | Gauge (int) | `By` | - | - |
| `redis.memory.used` | Gauge (int) | `By` | - | - |
| `redis.memory.used_memory_overhead` | Sum (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.memory.used_memory_startup` | Sum (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.mode` | Gauge (int) | `{mode}` | mode | Disabled by default; enable via the receiver metrics configuration. |
| `redis.net.input` | Sum (int) | `By` | - | - |
| `redis.net.output` | Sum (int) | `By` | - | - |
| `redis.pubsub.channel.status` | Sum (int) | `{channel}` | redis.pubsub.channel.state | Disabled by default; enable via the receiver metrics configuration. |
| `redis.pubsub.connection.count` | Sum (int) | `{client}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.pubsub.pattern.status` | Sum (int) | `{pattern}` | redis.pubsub.pattern.state | Disabled by default; enable via the receiver metrics configuration. |
| `redis.rdb.changes_since_last_save` | Sum (int) | `{change}` | - | - |
| `redis.replication.backlog_first_byte_offset` | Gauge (int) | `By` | - | - |
| `redis.replication.offset` | Gauge (int) | `By` | - | - |
| `redis.replication.replica_offset` | Gauge (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.role` | Sum (int) | `{role}` | role | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.masters` | Gauge (int) | `{master}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.running_scripts` | Gauge (int) | `{script}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.scripts_queue_length` | Gauge (int) | `{script}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.simulate_failure_flags` | Gauge (int) | `{flag}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.tilt_since_seconds` | Gauge (int) | `s` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.total_tilt` | Sum (int) | `{event}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.slaves.connected` | Sum (int) | `{replica}` | - | - |
| `redis.tracking_total_keys` | Sum (int) | `{key}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.uptime` | Sum (int) | `s` | - | - |

## Sources

- receiver/redisreceiver/metadata.yaml
- receiver/redisreceiver/redis_scraper.go
- receiver/redisreceiver/metric_functions.go
- receiver/redisreceiver/keyspace.go
- receiver/redisreceiver/latencystats.go
- receiver/redisreceiver/config.go
        • v0.161.0.md 6.5 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/redisreceiver
version: v0.161.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/redisreceiver
commit_sha: 3f8455d8038a985398861171e5310bc9b4e988b2
last_verified: 2026-10-03
---

# Redis Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `redis.clients.blocked` | Sum (int) | `{client}` | - | - |
| `redis.clients.connected` | Sum (int) | `{client}` | - | - |
| `redis.clients.max_input_buffer` | Gauge (int) | `By` | - | - |
| `redis.clients.max_output_buffer` | Gauge (int) | `By` | - | - |
| `redis.cluster.cluster_enabled` | Gauge (int) | `1` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.known_nodes` | Gauge (int) | `{node}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.links_buffer_limit_exceeded.count` | Sum (int) | `{count}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.node.count` | Gauge (int) | `{node}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.node.uptime` | Gauge (int) | `s` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_assigned` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_fail` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_ok` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_pfail` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.state` | Gauge (int) | `{state}` | cluster_state | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.stats_messages_received` | Sum (int) | `{message}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.stats_messages_sent` | Sum (int) | `{message}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.uptime` | Gauge (int) | `s` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cmd.calls` | Sum (int) | `{call}` | cmd | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cmd.latency` | Gauge (double) | `s` | cmd, percentile | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cmd.usec` | Sum (int) | `us` | cmd | Disabled by default; enable via the receiver metrics configuration. |
| `redis.commands` | Gauge (int) | `{ops}/s` | - | - |
| `redis.commands.processed` | Sum (int) | `{command}` | - | - |
| `redis.connections.received` | Sum (int) | `{connection}` | - | - |
| `redis.connections.rejected` | Sum (int) | `{connection}` | - | - |
| `redis.cpu.time` | Sum (double) | `s` | state | - |
| `redis.db.avg_ttl` | Gauge (int) | `ms` | db | - |
| `redis.db.expires` | Gauge (int) | `{key}` | db | - |
| `redis.db.keys` | Gauge (int) | `{key}` | db | - |
| `redis.keys.evicted` | Sum (int) | `{key}` | - | - |
| `redis.keys.expired` | Sum (int) | `{event}` | - | - |
| `redis.keyspace.hits` | Sum (int) | `{hit}` | - | - |
| `redis.keyspace.misses` | Sum (int) | `{miss}` | - | - |
| `redis.latest_fork` | Gauge (int) | `us` | - | - |
| `redis.maxmemory` | Gauge (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.memory.fragmentation_ratio` | Gauge (double) | `1` | - | - |
| `redis.memory.lua` | Gauge (int) | `By` | - | - |
| `redis.memory.peak` | Gauge (int) | `By` | - | - |
| `redis.memory.rss` | Gauge (int) | `By` | - | - |
| `redis.memory.used` | Gauge (int) | `By` | - | - |
| `redis.memory.used_memory_overhead` | Sum (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.memory.used_memory_startup` | Sum (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.mode` | Gauge (int) | `{mode}` | mode | Disabled by default; enable via the receiver metrics configuration. |
| `redis.net.input` | Sum (int) | `By` | - | - |
| `redis.net.output` | Sum (int) | `By` | - | - |
| `redis.pubsub.channel.status` | Sum (int) | `{channel}` | redis.pubsub.channel.state | Disabled by default; enable via the receiver metrics configuration. |
| `redis.pubsub.connection.count` | Sum (int) | `{client}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.pubsub.pattern.status` | Sum (int) | `{pattern}` | redis.pubsub.pattern.state | Disabled by default; enable via the receiver metrics configuration. |
| `redis.rdb.changes_since_last_save` | Sum (int) | `{change}` | - | - |
| `redis.replication.backlog_first_byte_offset` | Gauge (int) | `By` | - | - |
| `redis.replication.offset` | Gauge (int) | `By` | - | - |
| `redis.replication.replica_offset` | Gauge (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.role` | Sum (int) | `{role}` | role | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.masters` | Gauge (int) | `{master}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.running_scripts` | Gauge (int) | `{script}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.scripts_queue_length` | Gauge (int) | `{script}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.simulate_failure_flags` | Gauge (int) | `{flag}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.tilt_since_seconds` | Gauge (int) | `s` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.total_tilt` | Sum (int) | `{event}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.slaves.connected` | Sum (int) | `{replica}` | - | - |
| `redis.tracking_total_keys` | Sum (int) | `{key}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.uptime` | Sum (int) | `s` | - | - |

## Sources

- receiver/redisreceiver/metadata.yaml
- receiver/redisreceiver/redis_scraper.go
- receiver/redisreceiver/metric_functions.go
- receiver/redisreceiver/keyspace.go
- receiver/redisreceiver/latencystats.go
- receiver/redisreceiver/config.go
        • v0.162.0.md 6.5 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/redisreceiver
version: v0.162.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/redisreceiver
commit_sha: ae8c507510f48f433ab47dd1c6b01a59d6c388b5
last_verified: 2026-10-03
---

# Redis Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `redis.clients.blocked` | Sum (int) | `{client}` | - | - |
| `redis.clients.connected` | Sum (int) | `{client}` | - | - |
| `redis.clients.max_input_buffer` | Gauge (int) | `By` | - | - |
| `redis.clients.max_output_buffer` | Gauge (int) | `By` | - | - |
| `redis.cluster.cluster_enabled` | Gauge (int) | `1` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.known_nodes` | Gauge (int) | `{node}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.links_buffer_limit_exceeded.count` | Sum (int) | `{count}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.node.count` | Gauge (int) | `{node}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.node.uptime` | Gauge (int) | `s` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_assigned` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_fail` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_ok` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.slots_pfail` | Gauge (int) | `{slot}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.state` | Gauge (int) | `{state}` | cluster_state | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.stats_messages_received` | Sum (int) | `{message}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.stats_messages_sent` | Sum (int) | `{message}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cluster.uptime` | Gauge (int) | `s` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cmd.calls` | Sum (int) | `{call}` | cmd | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cmd.latency` | Gauge (double) | `s` | cmd, percentile | Disabled by default; enable via the receiver metrics configuration. |
| `redis.cmd.usec` | Sum (int) | `us` | cmd | Disabled by default; enable via the receiver metrics configuration. |
| `redis.commands` | Gauge (int) | `{ops}/s` | - | - |
| `redis.commands.processed` | Sum (int) | `{command}` | - | - |
| `redis.connections.received` | Sum (int) | `{connection}` | - | - |
| `redis.connections.rejected` | Sum (int) | `{connection}` | - | - |
| `redis.cpu.time` | Sum (double) | `s` | state | - |
| `redis.db.avg_ttl` | Gauge (int) | `ms` | db | - |
| `redis.db.expires` | Gauge (int) | `{key}` | db | - |
| `redis.db.keys` | Gauge (int) | `{key}` | db | - |
| `redis.keys.evicted` | Sum (int) | `{key}` | - | - |
| `redis.keys.expired` | Sum (int) | `{event}` | - | - |
| `redis.keyspace.hits` | Sum (int) | `{hit}` | - | - |
| `redis.keyspace.misses` | Sum (int) | `{miss}` | - | - |
| `redis.latest_fork` | Gauge (int) | `us` | - | - |
| `redis.maxmemory` | Gauge (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.memory.fragmentation_ratio` | Gauge (double) | `1` | - | - |
| `redis.memory.lua` | Gauge (int) | `By` | - | - |
| `redis.memory.peak` | Gauge (int) | `By` | - | - |
| `redis.memory.rss` | Gauge (int) | `By` | - | - |
| `redis.memory.used` | Gauge (int) | `By` | - | - |
| `redis.memory.used_memory_overhead` | Sum (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.memory.used_memory_startup` | Sum (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.mode` | Gauge (int) | `{mode}` | mode | Disabled by default; enable via the receiver metrics configuration. |
| `redis.net.input` | Sum (int) | `By` | - | - |
| `redis.net.output` | Sum (int) | `By` | - | - |
| `redis.pubsub.channel.status` | Sum (int) | `{channel}` | redis.pubsub.channel.state | Disabled by default; enable via the receiver metrics configuration. |
| `redis.pubsub.connection.count` | Sum (int) | `{client}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.pubsub.pattern.status` | Sum (int) | `{pattern}` | redis.pubsub.pattern.state | Disabled by default; enable via the receiver metrics configuration. |
| `redis.rdb.changes_since_last_save` | Sum (int) | `{change}` | - | - |
| `redis.replication.backlog_first_byte_offset` | Gauge (int) | `By` | - | - |
| `redis.replication.offset` | Gauge (int) | `By` | - | - |
| `redis.replication.replica_offset` | Gauge (int) | `By` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.role` | Sum (int) | `{role}` | role | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.masters` | Gauge (int) | `{master}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.running_scripts` | Gauge (int) | `{script}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.scripts_queue_length` | Gauge (int) | `{script}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.simulate_failure_flags` | Gauge (int) | `{flag}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.tilt_since_seconds` | Gauge (int) | `s` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.sentinel.total_tilt` | Sum (int) | `{event}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.slaves.connected` | Sum (int) | `{replica}` | - | - |
| `redis.tracking_total_keys` | Sum (int) | `{key}` | - | Disabled by default; enable via the receiver metrics configuration. |
| `redis.uptime` | Sum (int) | `s` | - | - |

## Sources

- receiver/redisreceiver/metadata.yaml
- receiver/redisreceiver/redis_scraper.go
- receiver/redisreceiver/metric_functions.go
- receiver/redisreceiver/keyspace.go
- receiver/redisreceiver/latencystats.go
- receiver/redisreceiver/config.go
        • v0.163.0.md 1.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/redisreceiver
version: v0.163.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/redisreceiver
commit_sha: df849b5403c041d5e799e7846392a6f18b0b55ae
last_verified: null
---

# Redis Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| redis.clients.blocked | Gauge | 1 | - | - |
| redis.clients.connected | Gauge | 1 | - | - |
| redis.clients.max_input_buffer | Gauge | By | - | - |
| redis.clients.max_output_buffer | Gauge | By | - | - |
| redis.commands | Sum (monotonic) | 1 | - | - |
| redis.commands.processed | Sum (monotonic) | 1 | - | - |
| redis.connections.received | Sum (monotonic) | 1 | - | - |
| redis.connections.rejected | Sum (monotonic) | 1 | - | - |
| redis.cpu.time | Sum (monotonic) | s | state | - |
| redis.db.avg_ttl | Gauge | ms | db | - |
| redis.db.expires | Gauge | 1 | db | - |
| redis.db.keys | Gauge | 1 | db | - |
| redis.keys.evicted | Sum (monotonic) | 1 | - | - |
| redis.keys.expired | Sum (monotonic) | 1 | - | - |
| redis.keyspace.hits | Sum (monotonic) | 1 | - | - |
| redis.keyspace.misses | Sum (monotonic) | 1 | - | - |
| redis.latest_fork | Gauge | s | - | - |
| redis.memory.fragmentation_ratio | Gauge | 1 | - | - |
| redis.memory.lua | Gauge | By | - | - |
| redis.memory.peak | Gauge | By | - | - |
| redis.memory.rss | Gauge | By | - | - |
| redis.memory.used | Gauge | By | - | - |
| redis.net.input | Sum (monotonic) | By | - | - |
| redis.net.output | Sum (monotonic) | By | - | - |
| redis.rdb.changes_since_last_save | Gauge | 1 | - | - |
| redis.replication.backlog_first_byte_offset | Gauge | 1 | - | - |
| redis.replication.offset | Gauge | 1 | - | - |
| redis.slaves.connected | Gauge | 1 | - | - |
| redis.uptime | Gauge | s | - | - |

## Sources

- `receiver/redisreceiver/metadata.yaml`
- `receiver/redisreceiver/redis_scraper.go`
- `receiver/redisreceiver/metric_functions.go`
      • sqlserverreceiver
        • v0.153.0.md 11.2 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/sqlserverreceiver
version: v0.153.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/sqlserverreceiver
commit_sha: 42f949127580c0d00088b785cd0b35842dc0ddb8
last_verified: 2026-08-11
---

# SQL Server receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| sqlserver.batch.request.rate | Gauge | {requests}/s | - | Controlled by metrics.sqlserver.batch.request.rate.enabled (default true). |
| sqlserver.batch.sql_compilation.rate | Gauge | {compilations}/s | - | Controlled by metrics.sqlserver.batch.sql_compilation.rate.enabled (default true). |
| sqlserver.batch.sql_recompilation.rate | Gauge | {compilations}/s | - | Controlled by metrics.sqlserver.batch.sql_recompilation.rate.enabled (default true). |
| sqlserver.computer.uptime | Gauge | {seconds} | - | Controlled by metrics.sqlserver.computer.uptime.enabled (default false). |
| sqlserver.cpu.count | Gauge | {CPUs} | - | Controlled by metrics.sqlserver.cpu.count.enabled (default false). |
| sqlserver.database.backup_or_restore.rate | Gauge | “{backups_or_restores}/s” | - | Controlled by metrics.sqlserver.database.backup_or_restore.rate.enabled (default false). |
| sqlserver.database.count | Gauge | {databases} | database.status | Controlled by metrics.sqlserver.database.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.execution.errors | Gauge | “{errors}” | - | Controlled by metrics.sqlserver.database.execution.errors.enabled (default false). |
| sqlserver.database.full_scan.rate | Gauge | {scans}/s | - | Controlled by metrics.sqlserver.database.full_scan.rate.enabled (default false). |
| sqlserver.database.io | Sum | By | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.io.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.latency | Sum | s | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.latency.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.operations | Sum | {operations} | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.operations.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.tempdb.space | Sum | “KB” | tempdb.state | Controlled by metrics.sqlserver.database.tempdb.space.enabled (default false). |
| sqlserver.database.tempdb.version_store.size | Gauge | “KB” | - | Controlled by metrics.sqlserver.database.tempdb.version_store.size.enabled (default false). |
| sqlserver.deadlock.rate | Gauge | “{deadlocks}/s” | - | Controlled by metrics.sqlserver.deadlock.rate.enabled (default false). |
| sqlserver.index.search.rate | Gauge | “{searches}/s” | - | Controlled by metrics.sqlserver.index.search.rate.enabled (default false). |
| sqlserver.lock.timeout.rate | Gauge | “{timeouts}/s” | - | Controlled by metrics.sqlserver.lock.timeout.rate.enabled (default false). |
| sqlserver.lock.wait.count | Sum | {wait} | - | Controlled by metrics.sqlserver.lock.wait.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.wait.rate | Gauge | {requests}/s | - | Controlled by metrics.sqlserver.lock.wait.rate.enabled (default true). |
| sqlserver.lock.wait_time.avg | Gauge | ms | - | Controlled by metrics.sqlserver.lock.wait_time.avg.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.login.rate | Gauge | “{logins}/s” | - | Controlled by metrics.sqlserver.login.rate.enabled (default false). |
| sqlserver.logout.rate | Gauge | “{logouts}/s” | - | Controlled by metrics.sqlserver.logout.rate.enabled (default false). |
| sqlserver.memory.grants.pending.count | Sum | “{grants}” | - | Controlled by metrics.sqlserver.memory.grants.pending.count.enabled (default false). |
| sqlserver.memory.usage | Sum | “KB” | - | Controlled by metrics.sqlserver.memory.usage.enabled (default false). |
| sqlserver.os.wait.duration | Sum | s | wait.category, wait.type | Controlled by metrics.sqlserver.os.wait.duration.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.buffer_cache.free_list.stalls.rate | Gauge | “{stalls}/s” | - | Controlled by metrics.sqlserver.page.buffer_cache.free_list.stalls.rate.enabled (default false). |
| sqlserver.page.buffer_cache.hit_ratio | Gauge | % | - | Controlled by metrics.sqlserver.page.buffer_cache.hit_ratio.enabled (default true). |
| sqlserver.page.checkpoint.flush.rate | Gauge | {pages}/s | - | Controlled by metrics.sqlserver.page.checkpoint.flush.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.lazy_write.rate | Gauge | {writes}/s | - | Controlled by metrics.sqlserver.page.lazy_write.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.life_expectancy | Gauge | s | performance_counter.object_name | Controlled by metrics.sqlserver.page.life_expectancy.enabled (default true). |
| sqlserver.page.lookup.rate | Gauge | “{lookups}/s” | - | Controlled by metrics.sqlserver.page.lookup.rate.enabled (default false). |
| sqlserver.page.operation.rate | Gauge | {operations}/s | page.operations | Controlled by metrics.sqlserver.page.operation.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.split.rate | Gauge | {pages}/s | - | Controlled by metrics.sqlserver.page.split.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.processes.blocked | Gauge | {processes} | - | Controlled by metrics.sqlserver.processes.blocked.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.replica.data.rate | Gauge | By/s | replica.direction | Controlled by metrics.sqlserver.replica.data.rate.enabled (default false). |
| sqlserver.resource_pool.disk.operations | Gauge | {operations}/s | direction | Controlled by metrics.sqlserver.resource_pool.disk.operations.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.resource_pool.disk.throttled.read.rate | Gauge | {reads}/s | - | Controlled by metrics.sqlserver.resource_pool.disk.throttled.read.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.resource_pool.disk.throttled.write.rate | Gauge | {writes}/s | - | Controlled by metrics.sqlserver.resource_pool.disk.throttled.write.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.table.count | Sum | “{tables}” | table.state, table.status | Controlled by metrics.sqlserver.table.count.enabled (default false). |
| sqlserver.transaction.delay | Sum | ms | - | Controlled by metrics.sqlserver.transaction.delay.enabled (default false). |
| sqlserver.transaction.mirror_write.rate | Gauge | “{transactions}/s” | - | Controlled by metrics.sqlserver.transaction.mirror_write.rate.enabled (default false). |
| sqlserver.transaction.rate | Gauge | {transactions}/s | - | Controlled by metrics.sqlserver.transaction.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction.write.rate | Gauge | {transactions}/s | - | Controlled by metrics.sqlserver.transaction.write.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.data.rate | Gauge | By/s | - | Controlled by metrics.sqlserver.transaction_log.flush.data.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.rate | Gauge | {flushes}/s | - | Controlled by metrics.sqlserver.transaction_log.flush.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.wait.rate | Gauge | {commits}/s | - | Controlled by metrics.sqlserver.transaction_log.flush.wait.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.growth.count | Sum | {growths} | - | Controlled by metrics.sqlserver.transaction_log.growth.count.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.shrink.count | Sum | {shrinks} | - | Controlled by metrics.sqlserver.transaction_log.shrink.count.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.usage | Gauge | % | - | Controlled by metrics.sqlserver.transaction_log.usage.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.user.connection.count | Gauge | {connections} | - | Controlled by metrics.sqlserver.user.connection.count.enabled (default true). |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| db.server.query_sample | client.address, client.port, db.namespace, db.query.text, db.system.name, network.peer.address, network.peer.port, sqlserver.blocking_session_id, sqlserver.blocking.start_time, sqlserver.context_info, sqlserver.command, sqlserver.cpu_time, sqlserver.deadlock_priority, sqlserver.estimated_completion_time, sqlserver.lock_timeout, sqlserver.logical_reads, sqlserver.open_transaction_count, sqlserver.percent_complete, sqlserver.query_hash, sqlserver.query_plan_hash, sqlserver.query_start, sqlserver.reads, sqlserver.request_status, sqlserver.wait.resource.id, sqlserver.wait.resource.type, sqlserver.row_count, sqlserver.session_id, sqlserver.session_status, sqlserver.total_elapsed_time, sqlserver.transaction_id, sqlserver.transaction_isolation_level, sqlserver.wait_resource, sqlserver.wait_time, sqlserver.wait_type, sqlserver.writes, user.name, sqlserver.procedure_id, sqlserver.procedure_name | Controlled by events.db.server.query_sample.enabled (default false). |
| db.server.top_query | sqlserver.total_worker_time, db.query.text, db.namespace, sqlserver.execution_count, sqlserver.total_logical_reads, sqlserver.total_logical_writes, sqlserver.total_physical_reads, sqlserver.query_hash, sqlserver.query_plan, sqlserver.query_plan_hash, sqlserver.total_rows, sqlserver.total_elapsed_time, sqlserver.total_grant_kb, server.address, server.port, db.system.name, sqlserver.procedure_execution_count, sqlserver.procedure_id, sqlserver.procedure_name, sqlserver.query.last_started | Controlled by events.db.server.top_query.enabled (default false). |

## Sources

- receiver/sqlserverreceiver/metadata.yaml
- receiver/sqlserverreceiver/scraper.go
- receiver/sqlserverreceiver/recorders.go
- receiver/sqlserverreceiver/config.go
- receiver/sqlserverreceiver/factory.go
- receiver/sqlserverreceiver/logs-documentation.md
        • v0.154.0.md 13.7 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/sqlserverreceiver
version: v0.154.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/sqlserverreceiver
commit_sha: 853eda0e12b3ba142552ecd2b63cec07062904f0
last_verified: 2026-08-11
---

# SQL Server receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| sqlserver.attention.rate | Gauge | {attentions}/s | - | Controlled by metrics.sqlserver.attention.rate.enabled (default false). |
| sqlserver.batch.request.rate | Gauge | {requests}/s | - | Controlled by metrics.sqlserver.batch.request.rate.enabled (default true). |
| sqlserver.batch.sql_compilation.rate | Gauge | {compilations}/s | - | Controlled by metrics.sqlserver.batch.sql_compilation.rate.enabled (default true). |
| sqlserver.batch.sql_recompilation.rate | Gauge | {compilations}/s | - | Controlled by metrics.sqlserver.batch.sql_recompilation.rate.enabled (default true). |
| sqlserver.computer.uptime | Gauge | {seconds} | - | Controlled by metrics.sqlserver.computer.uptime.enabled (default false). |
| sqlserver.cpu.count | Gauge | {CPUs} | - | Controlled by metrics.sqlserver.cpu.count.enabled (default false). |
| sqlserver.database.backup_or_restore.rate | Gauge | “{backups_or_restores}/s” | - | Controlled by metrics.sqlserver.database.backup_or_restore.rate.enabled (default false). |
| sqlserver.database.count | Gauge | {databases} | database.status | Controlled by metrics.sqlserver.database.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.execution.errors | Gauge | “{errors}” | - | Controlled by metrics.sqlserver.database.execution.errors.enabled (default false). |
| sqlserver.database.full_scan.rate | Gauge | {scans}/s | - | Controlled by metrics.sqlserver.database.full_scan.rate.enabled (default false). |
| sqlserver.database.io | Sum | By | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.io.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.latency | Sum | s | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.latency.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.operations | Sum | {operations} | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.operations.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.tempdb.space | Sum | “KB” | tempdb.state | Controlled by metrics.sqlserver.database.tempdb.space.enabled (default false). |
| sqlserver.database.tempdb.version_store.size | Gauge | “KB” | - | Controlled by metrics.sqlserver.database.tempdb.version_store.size.enabled (default false). |
| sqlserver.deadlock.rate | Gauge | “{deadlocks}/s” | - | Controlled by metrics.sqlserver.deadlock.rate.enabled (default false). |
| sqlserver.index.search.rate | Gauge | “{searches}/s” | - | Controlled by metrics.sqlserver.index.search.rate.enabled (default false). |
| sqlserver.latch.superlatch.count | Gauge | {superlatch} | - | Controlled by metrics.sqlserver.latch.superlatch.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.superlatch.transition.rate | Gauge | {transition}/s | transition.direction | Controlled by metrics.sqlserver.latch.superlatch.transition.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.wait.rate | Gauge | {wait}/s | - | Controlled by metrics.sqlserver.latch.wait.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.wait_time.avg | Gauge | s | - | Controlled by metrics.sqlserver.latch.wait_time.avg.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.wait_time.total | Sum | s | - | Controlled by metrics.sqlserver.latch.wait_time.total.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.timeout.rate | Gauge | “{timeouts}/s” | - | Controlled by metrics.sqlserver.lock.timeout.rate.enabled (default false). |
| sqlserver.lock.wait.count | Sum | {wait} | - | Controlled by metrics.sqlserver.lock.wait.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.wait.rate | Gauge | {requests}/s | - | Controlled by metrics.sqlserver.lock.wait.rate.enabled (default true). |
| sqlserver.lock.wait_time.avg | Gauge | ms | - | Controlled by metrics.sqlserver.lock.wait_time.avg.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.login.rate | Gauge | “{logins}/s” | - | Controlled by metrics.sqlserver.login.rate.enabled (default false). |
| sqlserver.logout.rate | Gauge | “{logouts}/s” | - | Controlled by metrics.sqlserver.logout.rate.enabled (default false). |
| sqlserver.memory.area | Gauge | By | memory.pool | Controlled by metrics.sqlserver.memory.area.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.memory.cache.object.count | Gauge | {object} | cache.state | Controlled by metrics.sqlserver.memory.cache.object.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.memory.grants.pending.count | Sum | {grants} | - | Controlled by metrics.sqlserver.memory.grants.pending.count.enabled (default false). |
| sqlserver.memory.page.count | Gauge | {page} | page.pool | Controlled by metrics.sqlserver.memory.page.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.memory.usage | Sum | KB | - | Controlled by metrics.sqlserver.memory.usage.enabled (default false). |
| sqlserver.os.wait.duration | Sum | s | wait.category, wait.type | Controlled by metrics.sqlserver.os.wait.duration.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.buffer_cache.free_list.stalls.rate | Gauge | “{stalls}/s” | - | Controlled by metrics.sqlserver.page.buffer_cache.free_list.stalls.rate.enabled (default false). |
| sqlserver.page.buffer_cache.hit_ratio | Gauge | % | - | Controlled by metrics.sqlserver.page.buffer_cache.hit_ratio.enabled (default true). |
| sqlserver.page.checkpoint.flush.rate | Gauge | {pages}/s | - | Controlled by metrics.sqlserver.page.checkpoint.flush.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.lazy_write.rate | Gauge | {writes}/s | - | Controlled by metrics.sqlserver.page.lazy_write.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.life_expectancy | Gauge | s | performance_counter.object_name | Controlled by metrics.sqlserver.page.life_expectancy.enabled (default true). |
| sqlserver.page.lookup.rate | Gauge | “{lookups}/s” | - | Controlled by metrics.sqlserver.page.lookup.rate.enabled (default false). |
| sqlserver.page.operation.rate | Gauge | {operations}/s | page.operations | Controlled by metrics.sqlserver.page.operation.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.split.rate | Gauge | {pages}/s | - | Controlled by metrics.sqlserver.page.split.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.parameterization.rate | Gauge | {params}/s | sqlserver.parameterization.result | Controlled by metrics.sqlserver.parameterization.rate.enabled (default false). |
| sqlserver.plan.execution.rate | Gauge | {executions}/s | sqlserver.plan.guidance.result | Controlled by metrics.sqlserver.plan.execution.rate.enabled (default false). |
| sqlserver.processes.blocked | Gauge | {processes} | - | Controlled by metrics.sqlserver.processes.blocked.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.recompilation.ratio | Gauge | % | - | Controlled by metrics.sqlserver.recompilation.ratio.enabled (default false). |
| sqlserver.replica.data.rate | Gauge | By/s | replica.direction | Controlled by metrics.sqlserver.replica.data.rate.enabled (default false). |
| sqlserver.resource_pool.disk.operations | Gauge | {operations}/s | direction | Controlled by metrics.sqlserver.resource_pool.disk.operations.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.resource_pool.disk.throttled.read.rate | Gauge | {reads}/s | - | Controlled by metrics.sqlserver.resource_pool.disk.throttled.read.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.resource_pool.disk.throttled.write.rate | Gauge | {writes}/s | - | Controlled by metrics.sqlserver.resource_pool.disk.throttled.write.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.table.count | Sum | “{tables}” | table.state, table.status | Controlled by metrics.sqlserver.table.count.enabled (default false). |
| sqlserver.transaction.delay | Sum | ms | - | Controlled by metrics.sqlserver.transaction.delay.enabled (default false). |
| sqlserver.transaction.mirror_write.rate | Gauge | “{transactions}/s” | - | Controlled by metrics.sqlserver.transaction.mirror_write.rate.enabled (default false). |
| sqlserver.transaction.rate | Gauge | {transactions}/s | - | Controlled by metrics.sqlserver.transaction.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction.write.rate | Gauge | {transactions}/s | - | Controlled by metrics.sqlserver.transaction.write.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.data.rate | Gauge | By/s | - | Controlled by metrics.sqlserver.transaction_log.flush.data.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.rate | Gauge | {flushes}/s | - | Controlled by metrics.sqlserver.transaction_log.flush.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.wait.rate | Gauge | {commits}/s | - | Controlled by metrics.sqlserver.transaction_log.flush.wait.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.growth.count | Sum | {growths} | - | Controlled by metrics.sqlserver.transaction_log.growth.count.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.shrink.count | Sum | {shrinks} | - | Controlled by metrics.sqlserver.transaction_log.shrink.count.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.usage | Gauge | % | - | Controlled by metrics.sqlserver.transaction_log.usage.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.user.connection.count | Gauge | {connections} | - | Controlled by metrics.sqlserver.user.connection.count.enabled (default true). |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| db.server.query_sample | client.address, client.port, db.namespace, db.query.text, db.system.name, network.peer.address, network.peer.port, sqlserver.blocking_session_id, sqlserver.blocking.start_time, sqlserver.client.app.name, sqlserver.context_info, sqlserver.command, sqlserver.cpu_time, sqlserver.deadlock_priority, sqlserver.estimated_completion_time, sqlserver.lock_timeout, sqlserver.logical_reads, sqlserver.open_transaction_count, sqlserver.percent_complete, sqlserver.query_hash, sqlserver.query_plan_hash, sqlserver.query_start, sqlserver.reads, sqlserver.request_status, sqlserver.wait.resource.id, sqlserver.wait.resource.type, sqlserver.row_count, sqlserver.session.duration, sqlserver.session.start_time, sqlserver.session_id, sqlserver.session_status, sqlserver.total_elapsed_time, sqlserver.transaction_id, sqlserver.transaction_isolation_level, sqlserver.wait_resource, sqlserver.wait_time, sqlserver.wait_type, sqlserver.writes, user.name, sqlserver.procedure_id, sqlserver.procedure_name | Controlled by events.db.server.query_sample.enabled (default false). |
| db.server.top_query | sqlserver.total_worker_time, db.query.text, db.namespace, sqlserver.execution_count, sqlserver.total_logical_reads, sqlserver.total_logical_writes, sqlserver.total_physical_reads, sqlserver.query_hash, sqlserver.query_plan, sqlserver.query_plan_hash, sqlserver.total_rows, sqlserver.total_elapsed_time, sqlserver.total_grant_kb, server.address, server.port, db.system.name, sqlserver.procedure_execution_count, sqlserver.procedure_id, sqlserver.procedure_name, sqlserver.query.last_started | Controlled by events.db.server.top_query.enabled (default false). |

## Sources

- receiver/sqlserverreceiver/metadata.yaml
- receiver/sqlserverreceiver/scraper.go
- receiver/sqlserverreceiver/recorders.go
- receiver/sqlserverreceiver/config.go
- receiver/sqlserverreceiver/factory.go
- receiver/sqlserverreceiver/logs-documentation.md
        • v0.155.0.md 13.7 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/sqlserverreceiver
version: v0.155.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/sqlserverreceiver
commit_sha: aaf5045a24c0a6f000225c97ad5449e69aeb5835
last_verified: 2026-08-11
---

# SQL Server receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| sqlserver.attention.rate | Gauge | {attentions}/s | - | Controlled by metrics.sqlserver.attention.rate.enabled (default false). |
| sqlserver.batch.request.rate | Gauge | {requests}/s | - | Controlled by metrics.sqlserver.batch.request.rate.enabled (default true). |
| sqlserver.batch.sql_compilation.rate | Gauge | {compilations}/s | - | Controlled by metrics.sqlserver.batch.sql_compilation.rate.enabled (default true). |
| sqlserver.batch.sql_recompilation.rate | Gauge | {compilations}/s | - | Controlled by metrics.sqlserver.batch.sql_recompilation.rate.enabled (default true). |
| sqlserver.computer.uptime | Gauge | {seconds} | - | Controlled by metrics.sqlserver.computer.uptime.enabled (default false). |
| sqlserver.cpu.count | Gauge | {CPUs} | - | Controlled by metrics.sqlserver.cpu.count.enabled (default false). |
| sqlserver.database.backup_or_restore.rate | Gauge | “{backups_or_restores}/s” | - | Controlled by metrics.sqlserver.database.backup_or_restore.rate.enabled (default false). |
| sqlserver.database.count | Gauge | {databases} | database.status | Controlled by metrics.sqlserver.database.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.execution.errors | Gauge | “{errors}” | - | Controlled by metrics.sqlserver.database.execution.errors.enabled (default false). |
| sqlserver.database.full_scan.rate | Gauge | {scans}/s | - | Controlled by metrics.sqlserver.database.full_scan.rate.enabled (default false). |
| sqlserver.database.io | Sum | By | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.io.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.latency | Sum | s | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.latency.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.operations | Sum | {operations} | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.operations.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.tempdb.space | Sum | “KB” | tempdb.state | Controlled by metrics.sqlserver.database.tempdb.space.enabled (default false). |
| sqlserver.database.tempdb.version_store.size | Gauge | “KB” | - | Controlled by metrics.sqlserver.database.tempdb.version_store.size.enabled (default false). |
| sqlserver.deadlock.rate | Gauge | “{deadlocks}/s” | - | Controlled by metrics.sqlserver.deadlock.rate.enabled (default false). |
| sqlserver.index.search.rate | Gauge | “{searches}/s” | - | Controlled by metrics.sqlserver.index.search.rate.enabled (default false). |
| sqlserver.latch.superlatch.count | Gauge | {superlatch} | - | Controlled by metrics.sqlserver.latch.superlatch.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.superlatch.transition.rate | Gauge | {transition}/s | transition.direction | Controlled by metrics.sqlserver.latch.superlatch.transition.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.wait.rate | Gauge | {wait}/s | - | Controlled by metrics.sqlserver.latch.wait.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.wait_time.avg | Gauge | s | - | Controlled by metrics.sqlserver.latch.wait_time.avg.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.wait_time.total | Sum | s | - | Controlled by metrics.sqlserver.latch.wait_time.total.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.timeout.rate | Gauge | “{timeouts}/s” | - | Controlled by metrics.sqlserver.lock.timeout.rate.enabled (default false). |
| sqlserver.lock.wait.count | Sum | {wait} | - | Controlled by metrics.sqlserver.lock.wait.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.wait.rate | Gauge | {requests}/s | - | Controlled by metrics.sqlserver.lock.wait.rate.enabled (default true). |
| sqlserver.lock.wait_time.avg | Gauge | ms | - | Controlled by metrics.sqlserver.lock.wait_time.avg.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.login.rate | Gauge | “{logins}/s” | - | Controlled by metrics.sqlserver.login.rate.enabled (default false). |
| sqlserver.logout.rate | Gauge | “{logouts}/s” | - | Controlled by metrics.sqlserver.logout.rate.enabled (default false). |
| sqlserver.memory.area | Gauge | By | memory.pool | Controlled by metrics.sqlserver.memory.area.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.memory.cache.object.count | Gauge | {object} | cache.state | Controlled by metrics.sqlserver.memory.cache.object.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.memory.grants.pending.count | Sum | {grants} | - | Controlled by metrics.sqlserver.memory.grants.pending.count.enabled (default false). |
| sqlserver.memory.page.count | Gauge | {page} | page.pool | Controlled by metrics.sqlserver.memory.page.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.memory.usage | Sum | KB | - | Controlled by metrics.sqlserver.memory.usage.enabled (default false). |
| sqlserver.os.wait.duration | Sum | s | wait.category, wait.type | Controlled by metrics.sqlserver.os.wait.duration.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.buffer_cache.free_list.stalls.rate | Gauge | “{stalls}/s” | - | Controlled by metrics.sqlserver.page.buffer_cache.free_list.stalls.rate.enabled (default false). |
| sqlserver.page.buffer_cache.hit_ratio | Gauge | % | - | Controlled by metrics.sqlserver.page.buffer_cache.hit_ratio.enabled (default true). |
| sqlserver.page.checkpoint.flush.rate | Gauge | {pages}/s | - | Controlled by metrics.sqlserver.page.checkpoint.flush.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.lazy_write.rate | Gauge | {writes}/s | - | Controlled by metrics.sqlserver.page.lazy_write.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.life_expectancy | Gauge | s | performance_counter.object_name | Controlled by metrics.sqlserver.page.life_expectancy.enabled (default true). |
| sqlserver.page.lookup.rate | Gauge | “{lookups}/s” | - | Controlled by metrics.sqlserver.page.lookup.rate.enabled (default false). |
| sqlserver.page.operation.rate | Gauge | {operations}/s | page.operations | Controlled by metrics.sqlserver.page.operation.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.split.rate | Gauge | {pages}/s | - | Controlled by metrics.sqlserver.page.split.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.parameterization.rate | Gauge | {params}/s | sqlserver.parameterization.result | Controlled by metrics.sqlserver.parameterization.rate.enabled (default false). |
| sqlserver.plan.execution.rate | Gauge | {executions}/s | sqlserver.plan.guidance.result | Controlled by metrics.sqlserver.plan.execution.rate.enabled (default false). |
| sqlserver.processes.blocked | Gauge | {processes} | - | Controlled by metrics.sqlserver.processes.blocked.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.recompilation.ratio | Gauge | % | - | Controlled by metrics.sqlserver.recompilation.ratio.enabled (default false). |
| sqlserver.replica.data.rate | Gauge | By/s | replica.direction | Controlled by metrics.sqlserver.replica.data.rate.enabled (default false). |
| sqlserver.resource_pool.disk.operations | Gauge | {operations}/s | direction | Controlled by metrics.sqlserver.resource_pool.disk.operations.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.resource_pool.disk.throttled.read.rate | Gauge | {reads}/s | - | Controlled by metrics.sqlserver.resource_pool.disk.throttled.read.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.resource_pool.disk.throttled.write.rate | Gauge | {writes}/s | - | Controlled by metrics.sqlserver.resource_pool.disk.throttled.write.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.table.count | Sum | “{tables}” | table.state, table.status | Controlled by metrics.sqlserver.table.count.enabled (default false). |
| sqlserver.transaction.delay | Sum | ms | - | Controlled by metrics.sqlserver.transaction.delay.enabled (default false). |
| sqlserver.transaction.mirror_write.rate | Gauge | “{transactions}/s” | - | Controlled by metrics.sqlserver.transaction.mirror_write.rate.enabled (default false). |
| sqlserver.transaction.rate | Gauge | {transactions}/s | - | Controlled by metrics.sqlserver.transaction.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction.write.rate | Gauge | {transactions}/s | - | Controlled by metrics.sqlserver.transaction.write.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.data.rate | Gauge | By/s | - | Controlled by metrics.sqlserver.transaction_log.flush.data.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.rate | Gauge | {flushes}/s | - | Controlled by metrics.sqlserver.transaction_log.flush.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.wait.rate | Gauge | {commits}/s | - | Controlled by metrics.sqlserver.transaction_log.flush.wait.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.growth.count | Sum | {growths} | - | Controlled by metrics.sqlserver.transaction_log.growth.count.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.shrink.count | Sum | {shrinks} | - | Controlled by metrics.sqlserver.transaction_log.shrink.count.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.usage | Gauge | % | - | Controlled by metrics.sqlserver.transaction_log.usage.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.user.connection.count | Gauge | {connections} | - | Controlled by metrics.sqlserver.user.connection.count.enabled (default true). |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| db.server.query_sample | client.address, client.port, db.namespace, db.query.text, db.system.name, network.peer.address, network.peer.port, sqlserver.blocking_session_id, sqlserver.blocking.start_time, sqlserver.client.app.name, sqlserver.context_info, sqlserver.command, sqlserver.cpu_time, sqlserver.deadlock_priority, sqlserver.estimated_completion_time, sqlserver.lock_timeout, sqlserver.logical_reads, sqlserver.open_transaction_count, sqlserver.percent_complete, sqlserver.query_hash, sqlserver.query_plan_hash, sqlserver.query_start, sqlserver.reads, sqlserver.request_status, sqlserver.wait.resource.id, sqlserver.wait.resource.type, sqlserver.row_count, sqlserver.session.duration, sqlserver.session.start_time, sqlserver.session_id, sqlserver.session_status, sqlserver.total_elapsed_time, sqlserver.transaction_id, sqlserver.transaction_isolation_level, sqlserver.wait_resource, sqlserver.wait_time, sqlserver.wait_type, sqlserver.writes, user.name, sqlserver.procedure_id, sqlserver.procedure_name | Controlled by events.db.server.query_sample.enabled (default false). |
| db.server.top_query | sqlserver.total_worker_time, db.query.text, db.namespace, sqlserver.execution_count, sqlserver.total_logical_reads, sqlserver.total_logical_writes, sqlserver.total_physical_reads, sqlserver.query_hash, sqlserver.query_plan, sqlserver.query_plan_hash, sqlserver.total_rows, sqlserver.total_elapsed_time, sqlserver.total_grant_kb, server.address, server.port, db.system.name, sqlserver.procedure_execution_count, sqlserver.procedure_id, sqlserver.procedure_name, sqlserver.query.last_started, sqlserver.query.plan.creation_time | Controlled by events.db.server.top_query.enabled (default false). |

## Sources

- receiver/sqlserverreceiver/metadata.yaml
- receiver/sqlserverreceiver/scraper.go
- receiver/sqlserverreceiver/recorders.go
- receiver/sqlserverreceiver/config.go
- receiver/sqlserverreceiver/factory.go
- receiver/sqlserverreceiver/logs-documentation.md
        • v0.156.0.md 15.7 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/sqlserverreceiver
version: v0.156.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/sqlserverreceiver
commit_sha: 41e24cd516dd69a5b4277465cdb2ff4ef0676f49
last_verified: 2026-08-11
---

# SQL Server receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| sqlserver.access.scan.rate | Gauge | {scan}/s | sqlserver.access.scan.type | Controlled by metrics.sqlserver.access.scan.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.attention.rate | Gauge | {attentions}/s | - | Controlled by metrics.sqlserver.attention.rate.enabled (default false). |
| sqlserver.batch.request.rate | Gauge | {requests}/s | - | Controlled by metrics.sqlserver.batch.request.rate.enabled (default true). |
| sqlserver.batch.sql_compilation.rate | Gauge | {compilations}/s | - | Controlled by metrics.sqlserver.batch.sql_compilation.rate.enabled (default true). |
| sqlserver.batch.sql_recompilation.rate | Gauge | {compilations}/s | - | Controlled by metrics.sqlserver.batch.sql_recompilation.rate.enabled (default true). |
| sqlserver.computer.uptime | Gauge | {seconds} | - | Controlled by metrics.sqlserver.computer.uptime.enabled (default false). |
| sqlserver.cpu.count | Gauge | {CPUs} | - | Controlled by metrics.sqlserver.cpu.count.enabled (default false). |
| sqlserver.database.backup_or_restore.rate | Gauge | “{backups_or_restores}/s” | - | Controlled by metrics.sqlserver.database.backup_or_restore.rate.enabled (default false). |
| sqlserver.database.count | Gauge | {databases} | database.status | Controlled by metrics.sqlserver.database.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.execution.errors | Gauge | “{errors}” | - | Controlled by metrics.sqlserver.database.execution.errors.enabled (default false). |
| sqlserver.database.full_scan.rate | Gauge | {scans}/s | - | Controlled by metrics.sqlserver.database.full_scan.rate.enabled (default false). |
| sqlserver.database.io | Sum | By | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.io.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.latency | Sum | s | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.latency.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.operations | Sum | {operations} | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.operations.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.tempdb.space | Sum | “KB” | tempdb.state | Controlled by metrics.sqlserver.database.tempdb.space.enabled (default false). |
| sqlserver.database.tempdb.version_store.size | Gauge | “KB” | - | Controlled by metrics.sqlserver.database.tempdb.version_store.size.enabled (default false). |
| sqlserver.deadlock.rate | Gauge | “{deadlocks}/s” | - | Controlled by metrics.sqlserver.deadlock.rate.enabled (default false). |
| sqlserver.extent.operation.rate | Gauge | {extent}/s | sqlserver.extent.operation.type | Controlled by metrics.sqlserver.extent.operation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.ghost_record.skipped.rate | Gauge | {record}/s | - | Controlled by metrics.sqlserver.ghost_record.skipped.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.search.rate | Gauge | “{searches}/s” | - | Controlled by metrics.sqlserver.index.search.rate.enabled (default false). |
| sqlserver.latch.superlatch.count | Gauge | {superlatch} | - | Controlled by metrics.sqlserver.latch.superlatch.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.superlatch.transition.rate | Gauge | {transition}/s | transition.direction | Controlled by metrics.sqlserver.latch.superlatch.transition.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.wait.rate | Gauge | {wait}/s | - | Controlled by metrics.sqlserver.latch.wait.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.wait_time.avg | Gauge | s | - | Controlled by metrics.sqlserver.latch.wait_time.avg.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.wait_time.total | Sum | s | - | Controlled by metrics.sqlserver.latch.wait_time.total.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.timeout.rate | Gauge | “{timeouts}/s” | - | Controlled by metrics.sqlserver.lock.timeout.rate.enabled (default false). |
| sqlserver.lock.wait.count | Sum | {wait} | - | Controlled by metrics.sqlserver.lock.wait.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.wait.rate | Gauge | {requests}/s | - | Controlled by metrics.sqlserver.lock.wait.rate.enabled (default true). |
| sqlserver.lock.wait_time.avg | Gauge | ms | - | Controlled by metrics.sqlserver.lock.wait_time.avg.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.login.rate | Gauge | “{logins}/s” | - | Controlled by metrics.sqlserver.login.rate.enabled (default false). |
| sqlserver.logout.rate | Gauge | “{logouts}/s” | - | Controlled by metrics.sqlserver.logout.rate.enabled (default false). |
| sqlserver.memory.area | Gauge | By | memory.pool | Controlled by metrics.sqlserver.memory.area.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.memory.cache.object.count | Gauge | {object} | cache.state | Controlled by metrics.sqlserver.memory.cache.object.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.memory.grants.pending.count | Sum | {grants} | - | Controlled by metrics.sqlserver.memory.grants.pending.count.enabled (default false). |
| sqlserver.memory.page.count | Gauge | {page} | page.pool | Controlled by metrics.sqlserver.memory.page.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.memory.usage | Sum | KB | - | Controlled by metrics.sqlserver.memory.usage.enabled (default false). |
| sqlserver.os.wait.duration | Sum | s | wait.category, wait.type | Controlled by metrics.sqlserver.os.wait.duration.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.allocation.rate | Gauge | {page}/s | sqlserver.page.allocation.type | Controlled by metrics.sqlserver.page.allocation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.buffer_cache.free_list.stalls.rate | Gauge | “{stalls}/s” | - | Controlled by metrics.sqlserver.page.buffer_cache.free_list.stalls.rate.enabled (default false). |
| sqlserver.page.buffer_cache.hit_ratio | Gauge | % | - | Controlled by metrics.sqlserver.page.buffer_cache.hit_ratio.enabled (default true). |
| sqlserver.page.checkpoint.flush.rate | Gauge | {pages}/s | - | Controlled by metrics.sqlserver.page.checkpoint.flush.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.compression.rate | Gauge | {page}/s | sqlserver.page.compression.type | Controlled by metrics.sqlserver.page.compression.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.lazy_write.rate | Gauge | {writes}/s | - | Controlled by metrics.sqlserver.page.lazy_write.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.life_expectancy | Gauge | s | performance_counter.object_name | Controlled by metrics.sqlserver.page.life_expectancy.enabled (default true). |
| sqlserver.page.lookup.rate | Gauge | “{lookups}/s” | - | Controlled by metrics.sqlserver.page.lookup.rate.enabled (default false). |
| sqlserver.page.operation.rate | Gauge | {operations}/s | page.operations | Controlled by metrics.sqlserver.page.operation.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.read_ahead.rate | Gauge | {page}/s | - | Controlled by metrics.sqlserver.page.read_ahead.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.split.rate | Gauge | {pages}/s | - | Controlled by metrics.sqlserver.page.split.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.parameterization.rate | Gauge | {params}/s | sqlserver.parameterization.result | Controlled by metrics.sqlserver.parameterization.rate.enabled (default false). |
| sqlserver.plan.execution.rate | Gauge | {executions}/s | sqlserver.plan.guidance.result | Controlled by metrics.sqlserver.plan.execution.rate.enabled (default false). |
| sqlserver.processes.blocked | Gauge | {processes} | - | Controlled by metrics.sqlserver.processes.blocked.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.recompilation.ratio | Gauge | % | - | Controlled by metrics.sqlserver.recompilation.ratio.enabled (default false). |
| sqlserver.replica.data.rate | Gauge | By/s | replica.direction | Controlled by metrics.sqlserver.replica.data.rate.enabled (default false). |
| sqlserver.resource_pool.disk.operations | Gauge | {operations}/s | direction | Controlled by metrics.sqlserver.resource_pool.disk.operations.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.resource_pool.disk.throttled.read.rate | Gauge | {reads}/s | - | Controlled by metrics.sqlserver.resource_pool.disk.throttled.read.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.resource_pool.disk.throttled.write.rate | Gauge | {writes}/s | - | Controlled by metrics.sqlserver.resource_pool.disk.throttled.write.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.scan_point.revalidation.rate | Gauge | {revalidate}/s | - | Controlled by metrics.sqlserver.scan_point.revalidation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.table.count | Sum | “{tables}” | table.state, table.status | Controlled by metrics.sqlserver.table.count.enabled (default false). |
| sqlserver.transaction.delay | Sum | ms | - | Controlled by metrics.sqlserver.transaction.delay.enabled (default false). |
| sqlserver.transaction.mirror_write.rate | Gauge | “{transactions}/s” | - | Controlled by metrics.sqlserver.transaction.mirror_write.rate.enabled (default false). |
| sqlserver.transaction.rate | Gauge | {transactions}/s | - | Controlled by metrics.sqlserver.transaction.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction.write.rate | Gauge | {transactions}/s | - | Controlled by metrics.sqlserver.transaction.write.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.data.rate | Gauge | By/s | - | Controlled by metrics.sqlserver.transaction_log.flush.data.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.rate | Gauge | {flushes}/s | - | Controlled by metrics.sqlserver.transaction_log.flush.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.wait.rate | Gauge | {commits}/s | - | Controlled by metrics.sqlserver.transaction_log.flush.wait.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.growth.count | Sum | {growths} | - | Controlled by metrics.sqlserver.transaction_log.growth.count.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.shrink.count | Sum | {shrinks} | - | Controlled by metrics.sqlserver.transaction_log.shrink.count.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.usage | Gauge | % | - | Controlled by metrics.sqlserver.transaction_log.usage.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.user.connection.count | Gauge | {connections} | - | Controlled by metrics.sqlserver.user.connection.count.enabled (default true). |
| sqlserver.worktable.cache.hit_ratio | Gauge | 1 | - | Controlled by metrics.sqlserver.worktable.cache.hit_ratio.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| db.server.query_sample | client.address, client.port, db.namespace, db.query.text, db.system.name, network.peer.address, network.peer.port, sqlserver.blocking_session_id, sqlserver.blocking.start_time, sqlserver.client.app.name, sqlserver.context_info, sqlserver.command, sqlserver.cpu_time, sqlserver.deadlock_priority, sqlserver.estimated_completion_time, sqlserver.lock_timeout, sqlserver.logical_reads, sqlserver.open_transaction_count, sqlserver.percent_complete, sqlserver.query_hash, sqlserver.query_plan_hash, sqlserver.query_start, sqlserver.reads, sqlserver.request_status, sqlserver.wait.resource.id, sqlserver.wait.resource.type, sqlserver.row_count, sqlserver.session.duration, sqlserver.session.start_time, sqlserver.session_id, sqlserver.session_status, sqlserver.total_elapsed_time, sqlserver.transaction_id, sqlserver.transaction_isolation_level, sqlserver.wait_resource, sqlserver.wait_time, sqlserver.wait_type, sqlserver.writes, user.name, sqlserver.procedure_id, sqlserver.procedure_name | Controlled by events.db.server.query_sample.enabled (default false). |
| db.server.top_query | sqlserver.total_worker_time, db.query.text, db.namespace, sqlserver.execution_count, sqlserver.total_logical_reads, sqlserver.total_logical_writes, sqlserver.total_physical_reads, sqlserver.query_hash, sqlserver.query_plan, sqlserver.query_plan_hash, sqlserver.total_rows, sqlserver.total_elapsed_time, sqlserver.total_grant_kb, server.address, server.port, db.system.name, sqlserver.procedure_execution_count, sqlserver.procedure_id, sqlserver.procedure_name, sqlserver.query.last_started, sqlserver.query.plan.creation_time | Controlled by events.db.server.top_query.enabled (default false). |

## Sources

- receiver/sqlserverreceiver/metadata.yaml
- receiver/sqlserverreceiver/scraper.go
- receiver/sqlserverreceiver/recorders.go
- receiver/sqlserverreceiver/config.go
- receiver/sqlserverreceiver/factory.go
- receiver/sqlserverreceiver/logs-documentation.md
        • v0.157.0.md 21 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/sqlserverreceiver
version: v0.157.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/sqlserverreceiver
commit_sha: 89e43555904cd97c2d36605347c5d5237b1bdc8c
last_verified: 2026-08-11
---

# SQL Server receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| sqlserver.access.scan.rate | Gauge | {scan}/s | sqlserver.access.scan.type | Controlled by metrics.sqlserver.access.scan.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.attention.rate | Gauge | {attentions}/s | - | Controlled by metrics.sqlserver.attention.rate.enabled (default false). |
| sqlserver.batch.request.rate | Gauge | {requests}/s | - | Controlled by metrics.sqlserver.batch.request.rate.enabled (default true). |
| sqlserver.batch.sql_compilation.rate | Gauge | {compilations}/s | - | Controlled by metrics.sqlserver.batch.sql_compilation.rate.enabled (default true). |
| sqlserver.batch.sql_recompilation.rate | Gauge | {compilations}/s | - | Controlled by metrics.sqlserver.batch.sql_recompilation.rate.enabled (default true). |
| sqlserver.clr.execution.time | Sum | s | - | Controlled by metrics.sqlserver.clr.execution.time.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.computer.uptime | Gauge | {seconds} | - | Controlled by metrics.sqlserver.computer.uptime.enabled (default false). |
| sqlserver.connection.reset.rate | Gauge | {connection}/s | - | Controlled by metrics.sqlserver.connection.reset.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cpu.count | Gauge | {CPUs} | - | Controlled by metrics.sqlserver.cpu.count.enabled (default false). |
| sqlserver.cursor.count | Gauge | {cursor} | cursor.state | Controlled by metrics.sqlserver.cursor.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cursor.memory.usage | Gauge | By | - | Controlled by metrics.sqlserver.cursor.memory.usage.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cursor.plan.count | Gauge | {plan} | - | Controlled by metrics.sqlserver.cursor.plan.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cursor.request.rate | Gauge | {request}/s | - | Controlled by metrics.sqlserver.cursor.request.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.backup_or_restore.rate | Gauge | {backups_or_restores}/s | - | Controlled by metrics.sqlserver.database.backup_or_restore.rate.enabled (default false). |
| sqlserver.database.count | Gauge | {databases} | database.status | Controlled by metrics.sqlserver.database.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.execution.errors | Gauge | {errors} | - | Controlled by metrics.sqlserver.database.execution.errors.enabled (default false). |
| sqlserver.database.full_scan.rate | Gauge | {scans}/s | - | Controlled by metrics.sqlserver.database.full_scan.rate.enabled (default false). |
| sqlserver.database.io | Sum | By | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.io.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.latency | Sum | s | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.latency.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.operations | Sum | {operations} | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.operations.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.tempdb.space | Sum | kBy | tempdb.state | Controlled by metrics.sqlserver.database.tempdb.space.enabled (default false). |
| sqlserver.database.tempdb.version_store.size | Gauge | kBy | - | Controlled by metrics.sqlserver.database.tempdb.version_store.size.enabled (default false). |
| sqlserver.deadlock.rate | Gauge | {deadlocks}/s | - | Controlled by metrics.sqlserver.deadlock.rate.enabled (default false). |
| sqlserver.error.rate | Gauge | {error}/s | sqlserver.error.category | Controlled by metrics.sqlserver.error.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.extent.operation.rate | Gauge | {extent}/s | sqlserver.extent.operation.type | Controlled by metrics.sqlserver.extent.operation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.ghost_record.skipped.rate | Gauge | {record}/s | - | Controlled by metrics.sqlserver.ghost_record.skipped.rate.enabled (default false). |
| sqlserver.index.fragmentation | Gauge | % | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.fragmentation.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.page.count | Gauge | {page} | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.page.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.page.utilization | Gauge | % | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.page.utilization.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.record.count | Gauge | {record} | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.record.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.search.rate | Gauge | {searches}/s | - | Controlled by metrics.sqlserver.index.search.rate.enabled (default false). |
| sqlserver.index.size | Gauge | By | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.size.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.superlatch.count | Gauge | {superlatch} | - | Controlled by metrics.sqlserver.latch.superlatch.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.superlatch.transition.rate | Gauge | {transition}/s | transition.direction | Controlled by metrics.sqlserver.latch.superlatch.transition.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.wait.rate | Gauge | {wait}/s | - | Controlled by metrics.sqlserver.latch.wait.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.wait_time.avg | Gauge | s | - | Controlled by metrics.sqlserver.latch.wait_time.avg.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.wait_time.total | Sum | s | - | Controlled by metrics.sqlserver.latch.wait_time.total.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.block.count | Gauge | {block} | sqlserver.lock.block.type | Controlled by metrics.sqlserver.lock.block.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.escalation.rate | Gauge | {escalation}/s | - | Controlled by metrics.sqlserver.lock.escalation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.memory | Gauge | By | - | Controlled by metrics.sqlserver.lock.memory.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.request.rate | Gauge | {request}/s | - | Controlled by metrics.sqlserver.lock.request.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.timeout.rate | Gauge | {timeout}/s | sqlserver.lock.timeout.type | Controlled by metrics.sqlserver.lock.timeout.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.wait.count | Sum | {wait} | - | Controlled by metrics.sqlserver.lock.wait.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.wait.rate | Gauge | {requests}/s | - | Controlled by metrics.sqlserver.lock.wait.rate.enabled (default true). |
| sqlserver.lock.wait_time.avg | Gauge | ms | - | Controlled by metrics.sqlserver.lock.wait_time.avg.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.lock.wait_time.total | Sum | s | - | Controlled by metrics.sqlserver.lock.wait_time.total.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.login.rate | Gauge | {logins}/s | - | Controlled by metrics.sqlserver.login.rate.enabled (default false). |
| sqlserver.logout.rate | Gauge | {logouts}/s | - | Controlled by metrics.sqlserver.logout.rate.enabled (default false). |
| sqlserver.memory.area | Gauge | By | memory.pool | Controlled by metrics.sqlserver.memory.area.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.memory.cache.object.count | Gauge | {object} | cache.state | Controlled by metrics.sqlserver.memory.cache.object.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.memory.grants.pending.count | Sum | {grants} | - | Controlled by metrics.sqlserver.memory.grants.pending.count.enabled (default false). |
| sqlserver.memory.page.count | Gauge | {page} | page.pool | Controlled by metrics.sqlserver.memory.page.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.memory.usage | Sum | kBy | - | Controlled by metrics.sqlserver.memory.usage.enabled (default false). |
| sqlserver.os.wait.duration | Sum | s | wait.category, wait.type | Controlled by metrics.sqlserver.os.wait.duration.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.allocation.rate | Gauge | {page}/s | sqlserver.page.allocation.type | Controlled by metrics.sqlserver.page.allocation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.buffer_cache.free_list.stalls.rate | Gauge | {stalls}/s | - | Controlled by metrics.sqlserver.page.buffer_cache.free_list.stalls.rate.enabled (default false). |
| sqlserver.page.buffer_cache.hit_ratio | Gauge | % | - | Controlled by metrics.sqlserver.page.buffer_cache.hit_ratio.enabled (default true). |
| sqlserver.page.checkpoint.flush.rate | Gauge | {pages}/s | - | Controlled by metrics.sqlserver.page.checkpoint.flush.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.compression.rate | Gauge | {page}/s | sqlserver.page.compression.type | Controlled by metrics.sqlserver.page.compression.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.lazy_write.rate | Gauge | {writes}/s | - | Controlled by metrics.sqlserver.page.lazy_write.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.life_expectancy | Gauge | s | performance_counter.object_name | Controlled by metrics.sqlserver.page.life_expectancy.enabled (default true). |
| sqlserver.page.lookup.rate | Gauge | {lookups}/s | - | Controlled by metrics.sqlserver.page.lookup.rate.enabled (default false). |
| sqlserver.page.operation.rate | Gauge | {operations}/s | page.operations | Controlled by metrics.sqlserver.page.operation.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.read_ahead.rate | Gauge | {page}/s | - | Controlled by metrics.sqlserver.page.read_ahead.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.split.rate | Gauge | {pages}/s | - | Controlled by metrics.sqlserver.page.split.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.parameterization.rate | Gauge | {params}/s | sqlserver.parameterization.result | Controlled by metrics.sqlserver.parameterization.rate.enabled (default false). |
| sqlserver.plan.execution.rate | Gauge | {executions}/s | sqlserver.plan.guidance.result | Controlled by metrics.sqlserver.plan.execution.rate.enabled (default false). |
| sqlserver.processes.blocked | Gauge | {processes} | - | Controlled by metrics.sqlserver.processes.blocked.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.recompilation.ratio | Gauge | % | - | Controlled by metrics.sqlserver.recompilation.ratio.enabled (default false). |
| sqlserver.replica.data.rate | Gauge | By/s | replica.direction | Controlled by metrics.sqlserver.replica.data.rate.enabled (default false). |
| sqlserver.resource_pool.disk.operations | Gauge | {operations}/s | direction | Controlled by metrics.sqlserver.resource_pool.disk.operations.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.resource_pool.disk.throttled.read.rate | Gauge | {reads}/s | - | Controlled by metrics.sqlserver.resource_pool.disk.throttled.read.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.resource_pool.disk.throttled.write.rate | Gauge | {writes}/s | - | Controlled by metrics.sqlserver.resource_pool.disk.throttled.write.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.scan_point.revalidation.rate | Gauge | {revalidate}/s | - | Controlled by metrics.sqlserver.scan_point.revalidation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.stored_procedure.invocation.rate | Gauge | {invocation}/s | - | Controlled by metrics.sqlserver.stored_procedure.invocation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.table.count | Sum | {tables} | table.state, table.status | Controlled by metrics.sqlserver.table.count.enabled (default false). |
| sqlserver.task.count | Gauge | {task} | task.state | Controlled by metrics.sqlserver.task.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.task.rate | Gauge | {task}/s | task.result | Controlled by metrics.sqlserver.task.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.transaction.delay | Sum | ms | - | Controlled by metrics.sqlserver.transaction.delay.enabled (default false). |
| sqlserver.transaction.mirror_write.rate | Gauge | {transactions}/s | - | Controlled by metrics.sqlserver.transaction.mirror_write.rate.enabled (default false). |
| sqlserver.transaction.rate | Gauge | {transactions}/s | - | Controlled by metrics.sqlserver.transaction.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction.write.rate | Gauge | {transactions}/s | - | Controlled by metrics.sqlserver.transaction.write.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.data.rate | Gauge | By/s | - | Controlled by metrics.sqlserver.transaction_log.flush.data.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.rate | Gauge | {flushes}/s | - | Controlled by metrics.sqlserver.transaction_log.flush.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.wait.rate | Gauge | {commits}/s | - | Controlled by metrics.sqlserver.transaction_log.flush.wait.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.growth.count | Sum | {growths} | - | Controlled by metrics.sqlserver.transaction_log.growth.count.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.shrink.count | Sum | {shrinks} | - | Controlled by metrics.sqlserver.transaction_log.shrink.count.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.usage | Gauge | % | - | Controlled by metrics.sqlserver.transaction_log.usage.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.user.connection.count | Gauge | {connections} | - | Controlled by metrics.sqlserver.user.connection.count.enabled (default true). |
| sqlserver.worker.request.count | Gauge | {request} | request.state | Controlled by metrics.sqlserver.worker.request.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.worker.thread.count | Gauge | {thread} | worker.state | Controlled by metrics.sqlserver.worker.thread.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.worktable.cache.hit_ratio | Gauge | 1 | - | Controlled by metrics.sqlserver.worktable.cache.hit_ratio.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| db.server.query_sample | client.address, client.port, db.namespace, db.query.text, db.system.name, network.peer.address, network.peer.port, sqlserver.blocking_session_id, sqlserver.blocking.start_time, sqlserver.client.app.name, sqlserver.context_info, sqlserver.command, sqlserver.cpu_time, sqlserver.deadlock_priority, sqlserver.estimated_completion_time, sqlserver.lock_timeout, sqlserver.logical_reads, sqlserver.open_transaction_count, sqlserver.percent_complete, sqlserver.query_hash, sqlserver.query_plan_hash, sqlserver.query_start, sqlserver.reads, sqlserver.request_status, sqlserver.wait.resource.id, sqlserver.wait.resource.type, sqlserver.row_count, sqlserver.session.duration, sqlserver.session.start_time, sqlserver.session_id, sqlserver.session_status, sqlserver.total_elapsed_time, sqlserver.transaction_id, sqlserver.transaction_isolation_level, sqlserver.wait_resource, sqlserver.wait_time, sqlserver.wait_type, sqlserver.writes, user.name, sqlserver.procedure_id, sqlserver.procedure_name | Controlled by events.db.server.query_sample.enabled (default false). |
| db.server.top_query | sqlserver.total_worker_time, db.query.text, db.namespace, sqlserver.execution_count, sqlserver.total_logical_reads, sqlserver.total_logical_writes, sqlserver.total_physical_reads, sqlserver.query_hash, sqlserver.query_plan, sqlserver.query_plan_hash, sqlserver.total_rows, sqlserver.total_elapsed_time, sqlserver.total_grant_kb, server.address, server.port, db.system.name, sqlserver.procedure_execution_count, sqlserver.procedure_id, sqlserver.procedure_name, sqlserver.query.last_started, sqlserver.query.plan.creation_time | Controlled by events.db.server.top_query.enabled (default false). |

## Sources

- receiver/sqlserverreceiver/metadata.yaml
- receiver/sqlserverreceiver/scraper.go
- receiver/sqlserverreceiver/recorders.go
- receiver/sqlserverreceiver/config.go
- receiver/sqlserverreceiver/factory.go
- receiver/sqlserverreceiver/logs-documentation.md
        • v0.158.0.md 23.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/sqlserverreceiver
version: v0.158.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/sqlserverreceiver
commit_sha: 821a9d9c2c1623c4a0ceba5d47b57c48879c3f84
last_verified: 2026-08-11
---

# SQL Server receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| sqlserver.access.scan.rate | Gauge | {scan}/s | sqlserver.access.scan.type | Controlled by metrics.sqlserver.access.scan.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.attention.rate | Gauge | {attentions}/s | - | Controlled by metrics.sqlserver.attention.rate.enabled (default false). |
| sqlserver.availability_group.database_replica.queue.rate | Gauge | By/s | sqlserver.availability_group.name, sqlserver.replica.name, sqlserver.availability_group.queue.type | Controlled by metrics.sqlserver.availability_group.database_replica.queue.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server and the instance has Always On Availability Groups enabled. |
| sqlserver.availability_group.database_replica.queue.size | Gauge | By | sqlserver.availability_group.name, sqlserver.replica.name, sqlserver.availability_group.queue.type | Controlled by metrics.sqlserver.availability_group.database_replica.queue.size.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server and the instance has Always On Availability Groups enabled. |
| sqlserver.availability_group.database_replica.secondary_lag | Gauge | s | sqlserver.availability_group.name, sqlserver.replica.name | Controlled by metrics.sqlserver.availability_group.database_replica.secondary_lag.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server and the instance has Always On Availability Groups enabled. |
| sqlserver.batch.request.rate | Gauge | {requests}/s | - | Controlled by metrics.sqlserver.batch.request.rate.enabled (default true). |
| sqlserver.batch.sql_compilation.rate | Gauge | {compilations}/s | - | Controlled by metrics.sqlserver.batch.sql_compilation.rate.enabled (default true). |
| sqlserver.batch.sql_recompilation.rate | Gauge | {compilations}/s | - | Controlled by metrics.sqlserver.batch.sql_recompilation.rate.enabled (default true). |
| sqlserver.clr.execution.time | Sum | s | - | Controlled by metrics.sqlserver.clr.execution.time.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.computer.uptime | Gauge | {seconds} | - | Controlled by metrics.sqlserver.computer.uptime.enabled (default false). |
| sqlserver.connection.reset.rate | Gauge | {connection}/s | - | Controlled by metrics.sqlserver.connection.reset.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cpu.count | Gauge | {CPUs} | - | Controlled by metrics.sqlserver.cpu.count.enabled (default false). |
| sqlserver.cpu.utilization | Gauge | 1 | - | Controlled by metrics.sqlserver.cpu.utilization.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cursor.count | Gauge | {cursor} | cursor.state | Controlled by metrics.sqlserver.cursor.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cursor.memory.usage | Gauge | By | - | Controlled by metrics.sqlserver.cursor.memory.usage.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cursor.plan.count | Gauge | {plan} | - | Controlled by metrics.sqlserver.cursor.plan.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cursor.request.rate | Gauge | {request}/s | - | Controlled by metrics.sqlserver.cursor.request.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.backup_or_restore.rate | Gauge | {backups_or_restores}/s | - | Controlled by metrics.sqlserver.database.backup_or_restore.rate.enabled (default false). |
| sqlserver.database.count | Gauge | {databases} | database.status | Controlled by metrics.sqlserver.database.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.execution.errors | Gauge | {errors} | - | Controlled by metrics.sqlserver.database.execution.errors.enabled (default false). |
| sqlserver.database.full_scan.rate | Gauge | {scans}/s | - | Controlled by metrics.sqlserver.database.full_scan.rate.enabled (default false). |
| sqlserver.database.io | Sum | By | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.io.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.latency | Sum | s | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.latency.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.operations | Sum | {operations} | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.operations.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.tempdb.space | Sum | kBy | tempdb.state | Controlled by metrics.sqlserver.database.tempdb.space.enabled (default false). |
| sqlserver.database.tempdb.version_store.size | Gauge | kBy | - | Controlled by metrics.sqlserver.database.tempdb.version_store.size.enabled (default false). |
| sqlserver.deadlock.rate | Gauge | {deadlocks}/s | - | Controlled by metrics.sqlserver.deadlock.rate.enabled (default false). |
| sqlserver.disk.io | Sum | By | disk.io.direction, sqlserver.file.path.prefix | Controlled by metrics.sqlserver.disk.io.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. Only covers I/O for SQL Server database files, not total host disk I/O. |
| sqlserver.disk.operations | Sum | {operation} | disk.io.direction, sqlserver.file.path.prefix | Controlled by metrics.sqlserver.disk.operations.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. Only covers I/O for SQL Server database files, not total host disk I/O. |
| sqlserver.error.rate | Gauge | {error}/s | sqlserver.error.category | Controlled by metrics.sqlserver.error.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.extent.operation.rate | Gauge | {extent}/s | sqlserver.extent.operation.type | Controlled by metrics.sqlserver.extent.operation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.ghost_record.skipped.rate | Gauge | {record}/s | - | Controlled by metrics.sqlserver.ghost_record.skipped.rate.enabled (default false). |
| sqlserver.host.memory.limit | Gauge | By | - | Controlled by metrics.sqlserver.host.memory.limit.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.host.memory.usage | Gauge | By | system.memory.state | Controlled by metrics.sqlserver.host.memory.usage.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.fragmentation | Gauge | % | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.fragmentation.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.page.count | Gauge | {page} | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.page.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.page.utilization | Gauge | % | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.page.utilization.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.record.count | Gauge | {record} | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.record.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.search.rate | Gauge | {searches}/s | - | Controlled by metrics.sqlserver.index.search.rate.enabled (default false). |
| sqlserver.index.size | Gauge | By | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.size.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.superlatch.count | Gauge | {superlatch} | - | Controlled by metrics.sqlserver.latch.superlatch.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.superlatch.transition.rate | Gauge | {transition}/s | transition.direction | Controlled by metrics.sqlserver.latch.superlatch.transition.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.wait.rate | Gauge | {wait}/s | - | Controlled by metrics.sqlserver.latch.wait.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.wait_time.avg | Gauge | s | - | Controlled by metrics.sqlserver.latch.wait_time.avg.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.wait_time.total | Sum | s | - | Controlled by metrics.sqlserver.latch.wait_time.total.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.block.count | Gauge | {block} | sqlserver.lock.block.type | Controlled by metrics.sqlserver.lock.block.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.escalation.rate | Gauge | {escalation}/s | - | Controlled by metrics.sqlserver.lock.escalation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.memory | Gauge | By | - | Controlled by metrics.sqlserver.lock.memory.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.request.rate | Gauge | {request}/s | - | Controlled by metrics.sqlserver.lock.request.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.timeout.rate | Gauge | {timeout}/s | sqlserver.lock.timeout.type | Controlled by metrics.sqlserver.lock.timeout.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.wait.count | Sum | {wait} | - | Controlled by metrics.sqlserver.lock.wait.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.wait.rate | Gauge | {requests}/s | - | Controlled by metrics.sqlserver.lock.wait.rate.enabled (default true). |
| sqlserver.lock.wait_time.avg | Gauge | ms | - | Controlled by metrics.sqlserver.lock.wait_time.avg.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.lock.wait_time.total | Sum | s | - | Controlled by metrics.sqlserver.lock.wait_time.total.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.login.rate | Gauge | {logins}/s | - | Controlled by metrics.sqlserver.login.rate.enabled (default false). |
| sqlserver.logout.rate | Gauge | {logouts}/s | - | Controlled by metrics.sqlserver.logout.rate.enabled (default false). |
| sqlserver.memory.area | Gauge | By | memory.pool | Controlled by metrics.sqlserver.memory.area.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.memory.cache.object.count | Gauge | {object} | cache.state | Controlled by metrics.sqlserver.memory.cache.object.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.memory.grants.pending.count | Sum | {grants} | - | Controlled by metrics.sqlserver.memory.grants.pending.count.enabled (default false). |
| sqlserver.memory.page.count | Gauge | {page} | page.pool | Controlled by metrics.sqlserver.memory.page.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.memory.usage | Sum | kBy | - | Controlled by metrics.sqlserver.memory.usage.enabled (default false). |
| sqlserver.os.wait.duration | Sum | s | wait.category, wait.type | Controlled by metrics.sqlserver.os.wait.duration.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.allocation.rate | Gauge | {page}/s | sqlserver.page.allocation.type | Controlled by metrics.sqlserver.page.allocation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.buffer_cache.free_list.stalls.rate | Gauge | {stalls}/s | - | Controlled by metrics.sqlserver.page.buffer_cache.free_list.stalls.rate.enabled (default false). |
| sqlserver.page.buffer_cache.hit_ratio | Gauge | % | - | Controlled by metrics.sqlserver.page.buffer_cache.hit_ratio.enabled (default true). |
| sqlserver.page.checkpoint.flush.rate | Gauge | {pages}/s | - | Controlled by metrics.sqlserver.page.checkpoint.flush.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.compression.rate | Gauge | {page}/s | sqlserver.page.compression.type | Controlled by metrics.sqlserver.page.compression.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.lazy_write.rate | Gauge | {writes}/s | - | Controlled by metrics.sqlserver.page.lazy_write.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.life_expectancy | Gauge | s | performance_counter.object_name | Controlled by metrics.sqlserver.page.life_expectancy.enabled (default true). |
| sqlserver.page.lookup.rate | Gauge | {lookups}/s | - | Controlled by metrics.sqlserver.page.lookup.rate.enabled (default false). |
| sqlserver.page.operation.rate | Gauge | {operations}/s | page.operations | Controlled by metrics.sqlserver.page.operation.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.read_ahead.rate | Gauge | {page}/s | - | Controlled by metrics.sqlserver.page.read_ahead.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.split.rate | Gauge | {pages}/s | - | Controlled by metrics.sqlserver.page.split.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.parameterization.rate | Gauge | {params}/s | sqlserver.parameterization.result | Controlled by metrics.sqlserver.parameterization.rate.enabled (default false). |
| sqlserver.plan.execution.rate | Gauge | {executions}/s | sqlserver.plan.guidance.result | Controlled by metrics.sqlserver.plan.execution.rate.enabled (default false). |
| sqlserver.processes.blocked | Gauge | {processes} | - | Controlled by metrics.sqlserver.processes.blocked.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.recompilation.ratio | Gauge | % | - | Controlled by metrics.sqlserver.recompilation.ratio.enabled (default false). |
| sqlserver.replica.data.rate | Gauge | By/s | replica.direction | Controlled by metrics.sqlserver.replica.data.rate.enabled (default false). |
| sqlserver.resource_pool.disk.operations | Gauge | {operations}/s | direction | Controlled by metrics.sqlserver.resource_pool.disk.operations.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.resource_pool.disk.throttled.read.rate | Gauge | {reads}/s | - | Controlled by metrics.sqlserver.resource_pool.disk.throttled.read.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.resource_pool.disk.throttled.write.rate | Gauge | {writes}/s | - | Controlled by metrics.sqlserver.resource_pool.disk.throttled.write.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.scan_point.revalidation.rate | Gauge | {revalidate}/s | - | Controlled by metrics.sqlserver.scan_point.revalidation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.stored_procedure.invocation.rate | Gauge | {invocation}/s | - | Controlled by metrics.sqlserver.stored_procedure.invocation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.table.count | Sum | {tables} | table.state, table.status | Controlled by metrics.sqlserver.table.count.enabled (default false). |
| sqlserver.task.count | Gauge | {task} | task.state | Controlled by metrics.sqlserver.task.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.task.rate | Gauge | {task}/s | task.result | Controlled by metrics.sqlserver.task.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.transaction.delay | Sum | ms | - | Controlled by metrics.sqlserver.transaction.delay.enabled (default false). |
| sqlserver.transaction.mirror_write.rate | Gauge | {transactions}/s | - | Controlled by metrics.sqlserver.transaction.mirror_write.rate.enabled (default false). |
| sqlserver.transaction.rate | Gauge | {transactions}/s | - | Controlled by metrics.sqlserver.transaction.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction.write.rate | Gauge | {transactions}/s | - | Controlled by metrics.sqlserver.transaction.write.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.data.rate | Gauge | By/s | - | Controlled by metrics.sqlserver.transaction_log.flush.data.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.rate | Gauge | {flushes}/s | - | Controlled by metrics.sqlserver.transaction_log.flush.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.wait.rate | Gauge | {commits}/s | - | Controlled by metrics.sqlserver.transaction_log.flush.wait.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.growth.count | Sum | {growths} | - | Controlled by metrics.sqlserver.transaction_log.growth.count.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.shrink.count | Sum | {shrinks} | - | Controlled by metrics.sqlserver.transaction_log.shrink.count.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.usage | Gauge | % | - | Controlled by metrics.sqlserver.transaction_log.usage.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.user.connection.count | Gauge | {connections} | - | Controlled by metrics.sqlserver.user.connection.count.enabled (default true). |
| sqlserver.worker.request.count | Gauge | {request} | request.state | Controlled by metrics.sqlserver.worker.request.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.worker.thread.count | Gauge | {thread} | worker.state | Controlled by metrics.sqlserver.worker.thread.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.worktable.cache.hit_ratio | Gauge | 1 | - | Controlled by metrics.sqlserver.worktable.cache.hit_ratio.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| db.server.query_sample | client.address, client.port, db.namespace, db.query.text, db.system.name, network.peer.address, network.peer.port, sqlserver.blocking_session_id, sqlserver.blocking.start_time, sqlserver.client.app.name, sqlserver.context_info, sqlserver.command, sqlserver.cpu_time, sqlserver.deadlock_priority, sqlserver.estimated_completion_time, sqlserver.lock_timeout, sqlserver.logical_reads, sqlserver.open_transaction_count, sqlserver.percent_complete, sqlserver.query_hash, sqlserver.query_plan_hash, sqlserver.query_start, sqlserver.reads, sqlserver.request_status, sqlserver.wait.resource.id, sqlserver.wait.resource.type, sqlserver.row_count, sqlserver.session.duration, sqlserver.session.start_time, sqlserver.session_id, sqlserver.session_status, sqlserver.total_elapsed_time, sqlserver.transaction_id, sqlserver.transaction_isolation_level, sqlserver.wait_resource, sqlserver.wait_time, sqlserver.wait_type, sqlserver.writes, user.name, sqlserver.procedure_id, sqlserver.procedure_name | Controlled by events.db.server.query_sample.enabled (default false). |
| db.server.top_query | sqlserver.total_worker_time, db.query.text, db.namespace, sqlserver.execution_count, sqlserver.total_logical_reads, sqlserver.total_logical_writes, sqlserver.total_physical_reads, sqlserver.query_hash, sqlserver.query_plan, sqlserver.query_plan_hash, sqlserver.total_rows, sqlserver.total_elapsed_time, sqlserver.total_grant_kb, server.address, server.port, db.system.name, sqlserver.procedure_execution_count, sqlserver.procedure_id, sqlserver.procedure_name, sqlserver.query.last_started, sqlserver.query.plan.creation_time | Controlled by events.db.server.top_query.enabled (default false). |

## Sources

- receiver/sqlserverreceiver/metadata.yaml
- receiver/sqlserverreceiver/scraper.go
- receiver/sqlserverreceiver/recorders.go
- receiver/sqlserverreceiver/config.go
- receiver/sqlserverreceiver/factory.go
- receiver/sqlserverreceiver/logs-documentation.md
        • v0.159.0.md 23.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/sqlserverreceiver
version: v0.159.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/sqlserverreceiver
commit_sha: 1120cc0714bf4d14600105e5673c3b00fe87467a
last_verified: 2026-08-26
---

# SQL Server receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| sqlserver.access.scan.rate | Gauge | {scan}/s | sqlserver.access.scan.type | Controlled by metrics.sqlserver.access.scan.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.attention.rate | Gauge | {attentions}/s | - | Controlled by metrics.sqlserver.attention.rate.enabled (default false). |
| sqlserver.availability_group.database_replica.queue.rate | Gauge | By/s | sqlserver.availability_group.name, sqlserver.replica.name, sqlserver.availability_group.queue.type | Controlled by metrics.sqlserver.availability_group.database_replica.queue.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server and the instance has Always On Availability Groups enabled. |
| sqlserver.availability_group.database_replica.queue.size | Gauge | By | sqlserver.availability_group.name, sqlserver.replica.name, sqlserver.availability_group.queue.type | Controlled by metrics.sqlserver.availability_group.database_replica.queue.size.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server and the instance has Always On Availability Groups enabled. |
| sqlserver.availability_group.database_replica.secondary_lag | Gauge | s | sqlserver.availability_group.name, sqlserver.replica.name | Controlled by metrics.sqlserver.availability_group.database_replica.secondary_lag.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server and the instance has Always On Availability Groups enabled. |
| sqlserver.batch.request.rate | Gauge | {requests}/s | - | Controlled by metrics.sqlserver.batch.request.rate.enabled (default true). |
| sqlserver.batch.sql_compilation.rate | Gauge | {compilations}/s | - | Controlled by metrics.sqlserver.batch.sql_compilation.rate.enabled (default true). |
| sqlserver.batch.sql_recompilation.rate | Gauge | {compilations}/s | - | Controlled by metrics.sqlserver.batch.sql_recompilation.rate.enabled (default true). |
| sqlserver.clr.execution.time | Sum | s | - | Controlled by metrics.sqlserver.clr.execution.time.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.computer.uptime | Gauge | {seconds} | - | Controlled by metrics.sqlserver.computer.uptime.enabled (default false). |
| sqlserver.connection.reset.rate | Gauge | {connection}/s | - | Controlled by metrics.sqlserver.connection.reset.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cpu.count | Gauge | {CPUs} | - | Controlled by metrics.sqlserver.cpu.count.enabled (default false). |
| sqlserver.cpu.utilization | Gauge | 1 | - | Controlled by metrics.sqlserver.cpu.utilization.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cursor.count | Gauge | {cursor} | cursor.state | Controlled by metrics.sqlserver.cursor.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cursor.memory.usage | Gauge | By | - | Controlled by metrics.sqlserver.cursor.memory.usage.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cursor.plan.count | Gauge | {plan} | - | Controlled by metrics.sqlserver.cursor.plan.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cursor.request.rate | Gauge | {request}/s | - | Controlled by metrics.sqlserver.cursor.request.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.backup_or_restore.rate | Gauge | {backups_or_restores}/s | - | Controlled by metrics.sqlserver.database.backup_or_restore.rate.enabled (default false). |
| sqlserver.database.count | Gauge | {databases} | database.status | Controlled by metrics.sqlserver.database.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.execution.errors | Gauge | {errors} | - | Controlled by metrics.sqlserver.database.execution.errors.enabled (default false). |
| sqlserver.database.full_scan.rate | Gauge | {scans}/s | - | Controlled by metrics.sqlserver.database.full_scan.rate.enabled (default false). |
| sqlserver.database.io | Sum | By | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.io.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.latency | Sum | s | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.latency.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.operations | Sum | {operations} | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.operations.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.tempdb.space | Sum | kBy | tempdb.state | Controlled by metrics.sqlserver.database.tempdb.space.enabled (default false). |
| sqlserver.database.tempdb.version_store.size | Gauge | kBy | - | Controlled by metrics.sqlserver.database.tempdb.version_store.size.enabled (default false). |
| sqlserver.deadlock.rate | Gauge | {deadlocks}/s | - | Controlled by metrics.sqlserver.deadlock.rate.enabled (default false). |
| sqlserver.disk.io | Sum | By | disk.io.direction, sqlserver.file.path.prefix | Controlled by metrics.sqlserver.disk.io.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. Only covers I/O for SQL Server database files, not total host disk I/O. |
| sqlserver.disk.operations | Sum | {operation} | disk.io.direction, sqlserver.file.path.prefix | Controlled by metrics.sqlserver.disk.operations.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. Only covers I/O for SQL Server database files, not total host disk I/O. |
| sqlserver.error.rate | Gauge | {error}/s | sqlserver.error.category | Controlled by metrics.sqlserver.error.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.extent.operation.rate | Gauge | {extent}/s | sqlserver.extent.operation.type | Controlled by metrics.sqlserver.extent.operation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.ghost_record.skipped.rate | Gauge | {record}/s | - | Controlled by metrics.sqlserver.ghost_record.skipped.rate.enabled (default false). |
| sqlserver.host.memory.limit | Gauge | By | - | Controlled by metrics.sqlserver.host.memory.limit.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.host.memory.usage | Gauge | By | system.memory.state | Controlled by metrics.sqlserver.host.memory.usage.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.fragmentation | Gauge | % | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.fragmentation.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.page.count | Gauge | {page} | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.page.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.page.utilization | Gauge | % | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.page.utilization.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.record.count | Gauge | {record} | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.record.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.search.rate | Gauge | {searches}/s | - | Controlled by metrics.sqlserver.index.search.rate.enabled (default false). |
| sqlserver.index.size | Gauge | By | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.size.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.superlatch.count | Gauge | {superlatch} | - | Controlled by metrics.sqlserver.latch.superlatch.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.superlatch.transition.rate | Gauge | {transition}/s | transition.direction | Controlled by metrics.sqlserver.latch.superlatch.transition.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.wait.rate | Gauge | {wait}/s | - | Controlled by metrics.sqlserver.latch.wait.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.wait_time.avg | Gauge | s | - | Controlled by metrics.sqlserver.latch.wait_time.avg.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.wait_time.total | Sum | s | - | Controlled by metrics.sqlserver.latch.wait_time.total.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.block.count | Gauge | {block} | sqlserver.lock.block.type | Controlled by metrics.sqlserver.lock.block.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.escalation.rate | Gauge | {escalation}/s | - | Controlled by metrics.sqlserver.lock.escalation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.memory | Gauge | By | - | Controlled by metrics.sqlserver.lock.memory.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.request.rate | Gauge | {request}/s | - | Controlled by metrics.sqlserver.lock.request.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.timeout.rate | Gauge | {timeout}/s | sqlserver.lock.timeout.type | Controlled by metrics.sqlserver.lock.timeout.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.wait.count | Sum | {wait} | - | Controlled by metrics.sqlserver.lock.wait.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.wait.rate | Gauge | {requests}/s | - | Controlled by metrics.sqlserver.lock.wait.rate.enabled (default true). |
| sqlserver.lock.wait_time.avg | Gauge | ms | - | Controlled by metrics.sqlserver.lock.wait_time.avg.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.lock.wait_time.total | Sum | s | - | Controlled by metrics.sqlserver.lock.wait_time.total.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.login.rate | Gauge | {logins}/s | - | Controlled by metrics.sqlserver.login.rate.enabled (default false). |
| sqlserver.logout.rate | Gauge | {logouts}/s | - | Controlled by metrics.sqlserver.logout.rate.enabled (default false). |
| sqlserver.memory.area | Gauge | By | memory.pool | Controlled by metrics.sqlserver.memory.area.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.memory.cache.object.count | Gauge | {object} | cache.state | Controlled by metrics.sqlserver.memory.cache.object.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.memory.grants.pending.count | Sum | {grants} | - | Controlled by metrics.sqlserver.memory.grants.pending.count.enabled (default false). |
| sqlserver.memory.page.count | Gauge | {page} | page.pool | Controlled by metrics.sqlserver.memory.page.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.memory.usage | Sum | kBy | - | Controlled by metrics.sqlserver.memory.usage.enabled (default false). |
| sqlserver.os.wait.duration | Sum | s | wait.category, wait.type | Controlled by metrics.sqlserver.os.wait.duration.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.allocation.rate | Gauge | {page}/s | sqlserver.page.allocation.type | Controlled by metrics.sqlserver.page.allocation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.buffer_cache.free_list.stalls.rate | Gauge | {stalls}/s | - | Controlled by metrics.sqlserver.page.buffer_cache.free_list.stalls.rate.enabled (default false). |
| sqlserver.page.buffer_cache.hit_ratio | Gauge | % | - | Controlled by metrics.sqlserver.page.buffer_cache.hit_ratio.enabled (default true). |
| sqlserver.page.checkpoint.flush.rate | Gauge | {pages}/s | - | Controlled by metrics.sqlserver.page.checkpoint.flush.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.compression.rate | Gauge | {page}/s | sqlserver.page.compression.type | Controlled by metrics.sqlserver.page.compression.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.lazy_write.rate | Gauge | {writes}/s | - | Controlled by metrics.sqlserver.page.lazy_write.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.life_expectancy | Gauge | s | performance_counter.object_name | Controlled by metrics.sqlserver.page.life_expectancy.enabled (default true). |
| sqlserver.page.lookup.rate | Gauge | {lookups}/s | - | Controlled by metrics.sqlserver.page.lookup.rate.enabled (default false). |
| sqlserver.page.operation.rate | Gauge | {operations}/s | page.operations | Controlled by metrics.sqlserver.page.operation.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.read_ahead.rate | Gauge | {page}/s | - | Controlled by metrics.sqlserver.page.read_ahead.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.split.rate | Gauge | {pages}/s | - | Controlled by metrics.sqlserver.page.split.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.parameterization.rate | Gauge | {params}/s | sqlserver.parameterization.result | Controlled by metrics.sqlserver.parameterization.rate.enabled (default false). |
| sqlserver.plan.execution.rate | Gauge | {executions}/s | sqlserver.plan.guidance.result | Controlled by metrics.sqlserver.plan.execution.rate.enabled (default false). |
| sqlserver.processes.blocked | Gauge | {processes} | - | Controlled by metrics.sqlserver.processes.blocked.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.recompilation.ratio | Gauge | % | - | Controlled by metrics.sqlserver.recompilation.ratio.enabled (default false). |
| sqlserver.replica.data.rate | Gauge | By/s | replica.direction | Controlled by metrics.sqlserver.replica.data.rate.enabled (default false). |
| sqlserver.resource_pool.disk.operations | Gauge | {operations}/s | direction | Controlled by metrics.sqlserver.resource_pool.disk.operations.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.resource_pool.disk.throttled.read.rate | Gauge | {reads}/s | - | Controlled by metrics.sqlserver.resource_pool.disk.throttled.read.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.resource_pool.disk.throttled.write.rate | Gauge | {writes}/s | - | Controlled by metrics.sqlserver.resource_pool.disk.throttled.write.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.scan_point.revalidation.rate | Gauge | {revalidate}/s | - | Controlled by metrics.sqlserver.scan_point.revalidation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.stored_procedure.invocation.rate | Gauge | {invocation}/s | - | Controlled by metrics.sqlserver.stored_procedure.invocation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.table.count | Sum | {tables} | table.state, table.status | Controlled by metrics.sqlserver.table.count.enabled (default false). |
| sqlserver.task.count | Gauge | {task} | task.state | Controlled by metrics.sqlserver.task.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.task.rate | Gauge | {task}/s | task.result | Controlled by metrics.sqlserver.task.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.transaction.delay | Sum | ms | - | Controlled by metrics.sqlserver.transaction.delay.enabled (default false). |
| sqlserver.transaction.mirror_write.rate | Gauge | {transactions}/s | - | Controlled by metrics.sqlserver.transaction.mirror_write.rate.enabled (default false). |
| sqlserver.transaction.rate | Gauge | {transactions}/s | - | Controlled by metrics.sqlserver.transaction.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction.write.rate | Gauge | {transactions}/s | - | Controlled by metrics.sqlserver.transaction.write.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.data.rate | Gauge | By/s | - | Controlled by metrics.sqlserver.transaction_log.flush.data.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.rate | Gauge | {flushes}/s | - | Controlled by metrics.sqlserver.transaction_log.flush.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.wait.rate | Gauge | {commits}/s | - | Controlled by metrics.sqlserver.transaction_log.flush.wait.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.growth.count | Sum | {growths} | - | Controlled by metrics.sqlserver.transaction_log.growth.count.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.shrink.count | Sum | {shrinks} | - | Controlled by metrics.sqlserver.transaction_log.shrink.count.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.usage | Gauge | % | - | Controlled by metrics.sqlserver.transaction_log.usage.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.user.connection.count | Gauge | {connections} | - | Controlled by metrics.sqlserver.user.connection.count.enabled (default true). |
| sqlserver.worker.request.count | Gauge | {request} | request.state | Controlled by metrics.sqlserver.worker.request.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.worker.thread.count | Gauge | {thread} | worker.state | Controlled by metrics.sqlserver.worker.thread.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.worktable.cache.hit_ratio | Gauge | 1 | - | Controlled by metrics.sqlserver.worktable.cache.hit_ratio.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| db.server.query_sample | client.address, client.port, db.namespace, db.query.text, db.system.name, network.peer.address, network.peer.port, sqlserver.blocking_session_id, sqlserver.blocking.start_time, sqlserver.client.app.name, sqlserver.context_info, sqlserver.command, sqlserver.cpu_time, sqlserver.deadlock_priority, sqlserver.estimated_completion_time, sqlserver.lock_timeout, sqlserver.logical_reads, sqlserver.open_transaction_count, sqlserver.percent_complete, sqlserver.query_hash, sqlserver.query_plan_hash, sqlserver.query_start, sqlserver.reads, sqlserver.request_status, sqlserver.wait.resource.id, sqlserver.wait.resource.type, sqlserver.row_count, sqlserver.session.duration, sqlserver.session.start_time, sqlserver.session_id, sqlserver.session_status, sqlserver.total_elapsed_time, sqlserver.transaction_id, sqlserver.transaction_isolation_level, sqlserver.wait_resource, sqlserver.wait_time, sqlserver.wait_type, sqlserver.writes, user.name, sqlserver.procedure_id, sqlserver.procedure_name | Controlled by events.db.server.query_sample.enabled (default false). `db.query.text` is obfuscated and whitespace-normalized. Sessions blocked on schema locks remain eligible even when `sys.dm_exec_sql_text` returns no text. |
| db.server.top_query | sqlserver.total_worker_time, db.query.text, db.namespace, sqlserver.execution_count, sqlserver.total_logical_reads, sqlserver.total_logical_writes, sqlserver.total_physical_reads, sqlserver.query_hash, sqlserver.query_plan, sqlserver.query_plan_hash, sqlserver.total_rows, sqlserver.total_elapsed_time, sqlserver.total_grant_kb, server.address, server.port, db.system.name, sqlserver.procedure_execution_count, sqlserver.procedure_id, sqlserver.procedure_name, sqlserver.query.last_started, sqlserver.query.plan.creation_time | Controlled by events.db.server.top_query.enabled (default false). Query text is obfuscated and whitespace-normalized; query-plan attributes are retained if plan obfuscation fails, with offending SQL attributes redacted. |

## Sources

- receiver/sqlserverreceiver/metadata.yaml
- receiver/sqlserverreceiver/scraper.go
- receiver/sqlserverreceiver/recorders.go
- receiver/sqlserverreceiver/config.go
- receiver/sqlserverreceiver/factory.go
- receiver/sqlserverreceiver/logs-documentation.md
        • v0.160.0.md 23.9 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/sqlserverreceiver
version: v0.160.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/sqlserverreceiver
commit_sha: 982f20b8a8e8a2569fab3e27cf8b008e8a5080c1
last_verified: 2026-09-03
---

# SQL Server receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| sqlserver.access.scan.rate | Gauge | {scan}/s | sqlserver.access.scan.type | Controlled by metrics.sqlserver.access.scan.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.attention.rate | Gauge | {attentions}/s | - | Controlled by metrics.sqlserver.attention.rate.enabled (default false). |
| sqlserver.availability_group.database_replica.queue.rate | Gauge | By/s | sqlserver.availability_group.name, sqlserver.replica.name, sqlserver.availability_group.queue.type | Controlled by metrics.sqlserver.availability_group.database_replica.queue.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server and the instance has Always On Availability Groups enabled. |
| sqlserver.availability_group.database_replica.queue.size | Gauge | By | sqlserver.availability_group.name, sqlserver.replica.name, sqlserver.availability_group.queue.type | Controlled by metrics.sqlserver.availability_group.database_replica.queue.size.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server and the instance has Always On Availability Groups enabled. |
| sqlserver.availability_group.database_replica.secondary_lag | Gauge | s | sqlserver.availability_group.name, sqlserver.replica.name | Controlled by metrics.sqlserver.availability_group.database_replica.secondary_lag.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server and the instance has Always On Availability Groups enabled. |
| sqlserver.batch.request.rate | Gauge | {requests}/s | - | Controlled by metrics.sqlserver.batch.request.rate.enabled (default true). |
| sqlserver.batch.sql_compilation.rate | Gauge | {compilations}/s | - | Controlled by metrics.sqlserver.batch.sql_compilation.rate.enabled (default true). |
| sqlserver.batch.sql_recompilation.rate | Gauge | {compilations}/s | - | Controlled by metrics.sqlserver.batch.sql_recompilation.rate.enabled (default true). |
| sqlserver.clr.execution.time | Sum | s | - | Controlled by metrics.sqlserver.clr.execution.time.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.computer.uptime | Gauge | {seconds} | - | Controlled by metrics.sqlserver.computer.uptime.enabled (default false). |
| sqlserver.connection.reset.rate | Gauge | {connection}/s | - | Controlled by metrics.sqlserver.connection.reset.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cpu.count | Gauge | {CPUs} | - | Controlled by metrics.sqlserver.cpu.count.enabled (default false). |
| sqlserver.cpu.utilization | Gauge | 1 | - | Controlled by metrics.sqlserver.cpu.utilization.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cursor.count | Gauge | {cursor} | cursor.state | Controlled by metrics.sqlserver.cursor.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cursor.memory.usage | Gauge | By | - | Controlled by metrics.sqlserver.cursor.memory.usage.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cursor.plan.count | Gauge | {plan} | - | Controlled by metrics.sqlserver.cursor.plan.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cursor.request.rate | Gauge | {request}/s | - | Controlled by metrics.sqlserver.cursor.request.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.backup_or_restore.rate | Gauge | {backups_or_restores}/s | - | Controlled by metrics.sqlserver.database.backup_or_restore.rate.enabled (default false). |
| sqlserver.database.count | Gauge | {databases} | database.status | Controlled by metrics.sqlserver.database.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.execution.errors | Gauge | {errors} | - | Controlled by metrics.sqlserver.database.execution.errors.enabled (default false). |
| sqlserver.database.full_scan.rate | Gauge | {scans}/s | - | Controlled by metrics.sqlserver.database.full_scan.rate.enabled (default false). |
| sqlserver.database.io | Sum | By | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.io.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.latency | Sum | s | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.latency.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.operations | Sum | {operations} | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.operations.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.tempdb.space | Sum | kBy | tempdb.state | Controlled by metrics.sqlserver.database.tempdb.space.enabled (default false). |
| sqlserver.database.tempdb.version_store.size | Gauge | kBy | - | Controlled by metrics.sqlserver.database.tempdb.version_store.size.enabled (default false). |
| sqlserver.deadlock.rate | Gauge | {deadlocks}/s | - | Controlled by metrics.sqlserver.deadlock.rate.enabled (default false). |
| sqlserver.disk.io | Sum | By | disk.io.direction, sqlserver.file.path.prefix | Controlled by metrics.sqlserver.disk.io.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. Only covers I/O for SQL Server database files, not total host disk I/O. |
| sqlserver.disk.operations | Sum | {operation} | disk.io.direction, sqlserver.file.path.prefix | Controlled by metrics.sqlserver.disk.operations.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. Only covers I/O for SQL Server database files, not total host disk I/O. |
| sqlserver.error.rate | Gauge | {error}/s | sqlserver.error.category | Controlled by metrics.sqlserver.error.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.extent.operation.rate | Gauge | {extent}/s | sqlserver.extent.operation.type | Controlled by metrics.sqlserver.extent.operation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.ghost_record.skipped.rate | Gauge | {record}/s | - | Controlled by metrics.sqlserver.ghost_record.skipped.rate.enabled (default false). |
| sqlserver.host.memory.limit | Gauge | By | - | Controlled by metrics.sqlserver.host.memory.limit.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.host.memory.usage | Gauge | By | system.memory.state | Controlled by metrics.sqlserver.host.memory.usage.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.fragmentation | Gauge | % | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.fragmentation.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.page.count | Gauge | {page} | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.page.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.page.utilization | Gauge | % | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.page.utilization.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.record.count | Gauge | {record} | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.record.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.search.rate | Gauge | {searches}/s | - | Controlled by metrics.sqlserver.index.search.rate.enabled (default false). |
| sqlserver.index.size | Gauge | By | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.size.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.superlatch.count | Gauge | {superlatch} | - | Controlled by metrics.sqlserver.latch.superlatch.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.superlatch.transition.rate | Gauge | {transition}/s | transition.direction | Controlled by metrics.sqlserver.latch.superlatch.transition.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.wait.rate | Gauge | {wait}/s | - | Controlled by metrics.sqlserver.latch.wait.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.wait_time.avg | Gauge | s | - | Controlled by metrics.sqlserver.latch.wait_time.avg.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.wait_time.total | Sum | s | - | Controlled by metrics.sqlserver.latch.wait_time.total.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.block.count | Gauge | {block} | sqlserver.lock.block.type | Controlled by metrics.sqlserver.lock.block.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.escalation.rate | Gauge | {escalation}/s | - | Controlled by metrics.sqlserver.lock.escalation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.memory | Gauge | By | - | Controlled by metrics.sqlserver.lock.memory.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.request.rate | Gauge | {request}/s | - | Controlled by metrics.sqlserver.lock.request.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.timeout.rate | Gauge | {timeout}/s | sqlserver.lock.timeout.type | Controlled by metrics.sqlserver.lock.timeout.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.wait.count | Sum | {wait} | - | Controlled by metrics.sqlserver.lock.wait.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.wait.rate | Gauge | {requests}/s | - | Controlled by metrics.sqlserver.lock.wait.rate.enabled (default true). |
| sqlserver.lock.wait_time.avg | Gauge | ms | - | Controlled by metrics.sqlserver.lock.wait_time.avg.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.lock.wait_time.total | Sum | s | - | Controlled by metrics.sqlserver.lock.wait_time.total.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.login.rate | Gauge | {logins}/s | - | Controlled by metrics.sqlserver.login.rate.enabled (default false). |
| sqlserver.logout.rate | Gauge | {logouts}/s | - | Controlled by metrics.sqlserver.logout.rate.enabled (default false). |
| sqlserver.memory.area | Gauge | By | memory.pool | Controlled by metrics.sqlserver.memory.area.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.memory.cache.object.count | Gauge | {object} | cache.state | Controlled by metrics.sqlserver.memory.cache.object.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.memory.grants.pending.count | Sum | {grants} | - | Controlled by metrics.sqlserver.memory.grants.pending.count.enabled (default false). |
| sqlserver.memory.page.count | Gauge | {page} | page.pool | Controlled by metrics.sqlserver.memory.page.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.memory.usage | Sum | kBy | - | Controlled by metrics.sqlserver.memory.usage.enabled (default false). |
| sqlserver.os.wait.duration | Sum | s | wait.category, wait.type | Controlled by metrics.sqlserver.os.wait.duration.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.allocation.rate | Gauge | {page}/s | sqlserver.page.allocation.type | Controlled by metrics.sqlserver.page.allocation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.buffer_cache.free_list.stalls.rate | Gauge | {stalls}/s | - | Controlled by metrics.sqlserver.page.buffer_cache.free_list.stalls.rate.enabled (default false). |
| sqlserver.page.buffer_cache.hit_ratio | Gauge | % | - | Controlled by metrics.sqlserver.page.buffer_cache.hit_ratio.enabled (default true). |
| sqlserver.page.checkpoint.flush.rate | Gauge | {pages}/s | - | Controlled by metrics.sqlserver.page.checkpoint.flush.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.compression.rate | Gauge | {page}/s | sqlserver.page.compression.type | Controlled by metrics.sqlserver.page.compression.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.lazy_write.rate | Gauge | {writes}/s | - | Controlled by metrics.sqlserver.page.lazy_write.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.life_expectancy | Gauge | s | performance_counter.object_name | Controlled by metrics.sqlserver.page.life_expectancy.enabled (default true). |
| sqlserver.page.lookup.rate | Gauge | {lookups}/s | - | Controlled by metrics.sqlserver.page.lookup.rate.enabled (default false). |
| sqlserver.page.operation.rate | Gauge | {operations}/s | page.operations | Controlled by metrics.sqlserver.page.operation.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.read_ahead.rate | Gauge | {page}/s | - | Controlled by metrics.sqlserver.page.read_ahead.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.split.rate | Gauge | {pages}/s | - | Controlled by metrics.sqlserver.page.split.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.parameterization.rate | Gauge | {params}/s | sqlserver.parameterization.result | Controlled by metrics.sqlserver.parameterization.rate.enabled (default false). |
| sqlserver.plan.execution.rate | Gauge | {executions}/s | sqlserver.plan.guidance.result | Controlled by metrics.sqlserver.plan.execution.rate.enabled (default false). |
| sqlserver.processes.blocked | Gauge | {processes} | - | Controlled by metrics.sqlserver.processes.blocked.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.recompilation.ratio | Gauge | % | - | Controlled by metrics.sqlserver.recompilation.ratio.enabled (default false). |
| sqlserver.replica.data.rate | Gauge | By/s | replica.direction | Controlled by metrics.sqlserver.replica.data.rate.enabled (default false). |
| sqlserver.resource_pool.disk.operations | Gauge | {operations}/s | direction | Controlled by metrics.sqlserver.resource_pool.disk.operations.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.resource_pool.disk.throttled.read.rate | Gauge | {reads}/s | - | Controlled by metrics.sqlserver.resource_pool.disk.throttled.read.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.resource_pool.disk.throttled.write.rate | Gauge | {writes}/s | - | Controlled by metrics.sqlserver.resource_pool.disk.throttled.write.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.scan_point.revalidation.rate | Gauge | {revalidate}/s | - | Controlled by metrics.sqlserver.scan_point.revalidation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.stored_procedure.invocation.rate | Gauge | {invocation}/s | - | Controlled by metrics.sqlserver.stored_procedure.invocation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.table.count | Sum | {tables} | table.state, table.status | Controlled by metrics.sqlserver.table.count.enabled (default false). |
| sqlserver.task.count | Gauge | {task} | task.state | Controlled by metrics.sqlserver.task.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.task.rate | Gauge | {task}/s | task.result | Controlled by metrics.sqlserver.task.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.transaction.delay | Sum | ms | - | Controlled by metrics.sqlserver.transaction.delay.enabled (default false). |
| sqlserver.transaction.mirror_write.rate | Gauge | {transactions}/s | - | Controlled by metrics.sqlserver.transaction.mirror_write.rate.enabled (default false). |
| sqlserver.transaction.rate | Gauge | {transactions}/s | - | Controlled by metrics.sqlserver.transaction.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction.write.rate | Gauge | {transactions}/s | - | Controlled by metrics.sqlserver.transaction.write.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.data.rate | Gauge | By/s | - | Controlled by metrics.sqlserver.transaction_log.flush.data.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.rate | Gauge | {flushes}/s | - | Controlled by metrics.sqlserver.transaction_log.flush.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.wait.rate | Gauge | {commits}/s | - | Controlled by metrics.sqlserver.transaction_log.flush.wait.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.growth.count | Sum | {growths} | - | Controlled by metrics.sqlserver.transaction_log.growth.count.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.shrink.count | Sum | {shrinks} | - | Controlled by metrics.sqlserver.transaction_log.shrink.count.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.usage | Gauge | % | - | Controlled by metrics.sqlserver.transaction_log.usage.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.user.connection.count | Gauge | {connections} | - | Controlled by metrics.sqlserver.user.connection.count.enabled (default true). |
| sqlserver.worker.request.count | Gauge | {request} | request.state | Controlled by metrics.sqlserver.worker.request.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.worker.thread.count | Gauge | {thread} | worker.state | Controlled by metrics.sqlserver.worker.thread.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.worktable.cache.hit_ratio | Gauge | 1 | - | Controlled by metrics.sqlserver.worktable.cache.hit_ratio.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| db.server.query_sample | client.address, client.port, db.namespace, db.query.text, db.system.name, network.peer.address, network.peer.port, sqlserver.blocking_session_id, sqlserver.blocking.start_time, sqlserver.client.app.name, sqlserver.context_info, sqlserver.command, sqlserver.cpu_time, sqlserver.deadlock_priority, sqlserver.estimated_completion_time, sqlserver.lock_timeout, sqlserver.logical_reads, sqlserver.open_transaction_count, sqlserver.percent_complete, sqlserver.query_hash, sqlserver.query_plan_hash, sqlserver.query_start, sqlserver.reads, sqlserver.request_status, sqlserver.wait.resource.id, sqlserver.wait.resource.type, sqlserver.row_count, sqlserver.session.duration, sqlserver.session.start_time, sqlserver.session_id, sqlserver.session_status, sqlserver.total_elapsed_time, sqlserver.transaction_id, sqlserver.transaction_isolation_level, sqlserver.wait_resource, sqlserver.wait_time, sqlserver.wait_type, sqlserver.writes, user.name, sqlserver.procedure_id, sqlserver.procedure_name | Controlled by events.db.server.query_sample.enabled (default false). `db.query.text` is obfuscated and whitespace-normalized. Sessions blocked on schema locks remain eligible even when `sys.dm_exec_sql_text` returns no text. |
| db.server.top_query | sqlserver.total_worker_time, db.query.text, db.namespace, sqlserver.execution_count, sqlserver.total_logical_reads, sqlserver.total_logical_writes, sqlserver.total_physical_reads, sqlserver.query_hash, sqlserver.query_plan, sqlserver.query_plan_hash, sqlserver.total_rows, sqlserver.total_elapsed_time, sqlserver.total_grant_kb, server.address, server.port, db.system.name, sqlserver.procedure_execution_count, sqlserver.procedure_id, sqlserver.procedure_name, sqlserver.query.last_started, sqlserver.query.plan.creation_time | Controlled by events.db.server.top_query.enabled (default false). Query text is obfuscated and whitespace-normalized; query-plan attributes are retained if plan obfuscation fails, with offending SQL attributes redacted. |

## Sources

- receiver/sqlserverreceiver/metadata.yaml
- receiver/sqlserverreceiver/scraper.go
- receiver/sqlserverreceiver/recorders.go
- receiver/sqlserverreceiver/config.go
- receiver/sqlserverreceiver/factory.go
- receiver/sqlserverreceiver/logs-documentation.md
        • v0.161.0.md 25.5 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/sqlserverreceiver
version: v0.161.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/sqlserverreceiver
commit_sha: 3f8455d8038a985398861171e5310bc9b4e988b2
last_verified: 2026-10-03
---

# SQL Server receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| sqlserver.access.scan.rate | Gauge | {scan}/s | sqlserver.access.scan.type | Controlled by metrics.sqlserver.access.scan.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.attention.rate | Gauge | {attentions}/s | - | Controlled by metrics.sqlserver.attention.rate.enabled (default false). |
| sqlserver.availability_group.database_replica.queue.rate | Gauge | By/s | sqlserver.availability_group.name, sqlserver.replica.name, sqlserver.availability_group.queue.type | Controlled by metrics.sqlserver.availability_group.database_replica.queue.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server and the instance has Always On Availability Groups enabled. |
| sqlserver.availability_group.database_replica.queue.size | Gauge | By | sqlserver.availability_group.name, sqlserver.replica.name, sqlserver.availability_group.queue.type | Controlled by metrics.sqlserver.availability_group.database_replica.queue.size.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server and the instance has Always On Availability Groups enabled. |
| sqlserver.availability_group.database_replica.secondary_lag | Gauge | s | sqlserver.availability_group.name, sqlserver.replica.name | Controlled by metrics.sqlserver.availability_group.database_replica.secondary_lag.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server and the instance has Always On Availability Groups enabled. |
| sqlserver.batch.request.rate | Gauge | {requests}/s | - | Controlled by metrics.sqlserver.batch.request.rate.enabled (default true). |
| sqlserver.batch.sql_compilation.rate | Gauge | {compilations}/s | - | Controlled by metrics.sqlserver.batch.sql_compilation.rate.enabled (default true). |
| sqlserver.batch.sql_recompilation.rate | Gauge | {compilations}/s | - | Controlled by metrics.sqlserver.batch.sql_recompilation.rate.enabled (default true). |
| sqlserver.clr.execution.time | Sum | s | - | Controlled by metrics.sqlserver.clr.execution.time.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.computer.uptime | Gauge | {seconds} | - | Controlled by metrics.sqlserver.computer.uptime.enabled (default false). |
| sqlserver.connection.reset.rate | Gauge | {connection}/s | - | Controlled by metrics.sqlserver.connection.reset.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cpu.count | Gauge | {CPUs} | - | Controlled by metrics.sqlserver.cpu.count.enabled (default false). |
| sqlserver.cpu.utilization | Gauge | 1 | - | Controlled by metrics.sqlserver.cpu.utilization.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cursor.count | Gauge | {cursor} | cursor.state | Controlled by metrics.sqlserver.cursor.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cursor.memory.usage | Gauge | By | - | Controlled by metrics.sqlserver.cursor.memory.usage.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cursor.plan.count | Gauge | {plan} | - | Controlled by metrics.sqlserver.cursor.plan.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cursor.request.rate | Gauge | {request}/s | - | Controlled by metrics.sqlserver.cursor.request.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.backup_or_restore.rate | Gauge | {backups_or_restores}/s | - | Controlled by metrics.sqlserver.database.backup_or_restore.rate.enabled (default false). |
| sqlserver.database.count | Gauge | {databases} | database.status | Controlled by metrics.sqlserver.database.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.execution.errors | Gauge | {errors} | - | Controlled by metrics.sqlserver.database.execution.errors.enabled (default false). |
| sqlserver.database.full_scan.rate | Gauge | {scans}/s | - | Controlled by metrics.sqlserver.database.full_scan.rate.enabled (default false). |
| sqlserver.database.io | Sum | By | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.io.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.latency | Sum | s | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.latency.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.operations | Sum | {operations} | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.operations.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.tempdb.space | Sum | kBy | tempdb.state | Controlled by metrics.sqlserver.database.tempdb.space.enabled (default false). |
| sqlserver.database.tempdb.version_store.size | Gauge | kBy | - | Controlled by metrics.sqlserver.database.tempdb.version_store.size.enabled (default false). |
| sqlserver.deadlock.rate | Gauge | {deadlocks}/s | - | Controlled by metrics.sqlserver.deadlock.rate.enabled (default false). |
| sqlserver.disk.io | Sum | By | disk.io.direction, sqlserver.file.path.prefix | Controlled by metrics.sqlserver.disk.io.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. Only covers I/O for SQL Server database files, not total host disk I/O. |
| sqlserver.disk.operations | Sum | {operation} | disk.io.direction, sqlserver.file.path.prefix | Controlled by metrics.sqlserver.disk.operations.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. Only covers I/O for SQL Server database files, not total host disk I/O. |
| sqlserver.error.rate | Gauge | {error}/s | sqlserver.error.category | Controlled by metrics.sqlserver.error.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.extent.operation.rate | Gauge | {extent}/s | sqlserver.extent.operation.type | Controlled by metrics.sqlserver.extent.operation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.ghost_record.skipped.rate | Gauge | {record}/s | - | Controlled by metrics.sqlserver.ghost_record.skipped.rate.enabled (default false). |
| sqlserver.host.memory.limit | Gauge | By | - | Controlled by metrics.sqlserver.host.memory.limit.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.host.memory.usage | Gauge | By | system.memory.state | Controlled by metrics.sqlserver.host.memory.usage.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.fragmentation | Gauge | % | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.fragmentation.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.page.count | Gauge | {page} | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.page.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.page.utilization | Gauge | % | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.page.utilization.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.record.count | Gauge | {record} | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.record.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.search.rate | Gauge | {searches}/s | - | Controlled by metrics.sqlserver.index.search.rate.enabled (default false). |
| sqlserver.index.size | Gauge | By | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.size.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.superlatch.count | Gauge | {superlatch} | - | Controlled by metrics.sqlserver.latch.superlatch.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.superlatch.transition.rate | Gauge | {transition}/s | transition.direction | Controlled by metrics.sqlserver.latch.superlatch.transition.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.wait.rate | Gauge | {wait}/s | - | Controlled by metrics.sqlserver.latch.wait.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.wait_time.avg | Gauge | s | - | Controlled by metrics.sqlserver.latch.wait_time.avg.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.wait_time.total | Sum | s | - | Controlled by metrics.sqlserver.latch.wait_time.total.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.block.count | Gauge | {block} | sqlserver.lock.block.type | Controlled by metrics.sqlserver.lock.block.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.escalation.rate | Gauge | {escalation}/s | - | Controlled by metrics.sqlserver.lock.escalation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.memory | Gauge | By | - | Controlled by metrics.sqlserver.lock.memory.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.request.rate | Gauge | {request}/s | - | Controlled by metrics.sqlserver.lock.request.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.timeout.rate | Gauge | {timeout}/s | sqlserver.lock.timeout.type | Controlled by metrics.sqlserver.lock.timeout.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.wait.count | Sum | {wait} | - | Controlled by metrics.sqlserver.lock.wait.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.wait.rate | Gauge | {requests}/s | - | Controlled by metrics.sqlserver.lock.wait.rate.enabled (default true). |
| sqlserver.lock.wait_time.avg | Gauge | ms | - | Controlled by metrics.sqlserver.lock.wait_time.avg.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.lock.wait_time.total | Sum | s | - | Controlled by metrics.sqlserver.lock.wait_time.total.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.login.rate | Gauge | {logins}/s | - | Controlled by metrics.sqlserver.login.rate.enabled (default false). |
| sqlserver.logout.rate | Gauge | {logouts}/s | - | Controlled by metrics.sqlserver.logout.rate.enabled (default false). |
| sqlserver.memory.area | Gauge | By | memory.pool | Controlled by metrics.sqlserver.memory.area.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.memory.cache.object.count | Gauge | {object} | cache.state | Controlled by metrics.sqlserver.memory.cache.object.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.memory.grants.pending.count | Sum | {grants} | - | Controlled by metrics.sqlserver.memory.grants.pending.count.enabled (default false). |
| sqlserver.memory.page.count | Gauge | {page} | page.pool | Controlled by metrics.sqlserver.memory.page.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.memory.usage | Sum | kBy | - | Controlled by metrics.sqlserver.memory.usage.enabled (default false). |
| sqlserver.os.wait.duration | Sum | s | wait.category, wait.type | Controlled by metrics.sqlserver.os.wait.duration.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.allocation.rate | Gauge | {page}/s | sqlserver.page.allocation.type | Controlled by metrics.sqlserver.page.allocation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.buffer_cache.free_list.stalls.rate | Gauge | {stalls}/s | - | Controlled by metrics.sqlserver.page.buffer_cache.free_list.stalls.rate.enabled (default false). |
| sqlserver.page.buffer_cache.hit_ratio | Gauge | % | - | Controlled by metrics.sqlserver.page.buffer_cache.hit_ratio.enabled (default true). |
| sqlserver.page.checkpoint.flush.rate | Gauge | {pages}/s | - | Controlled by metrics.sqlserver.page.checkpoint.flush.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.compression.rate | Gauge | {page}/s | sqlserver.page.compression.type | Controlled by metrics.sqlserver.page.compression.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.lazy_write.rate | Gauge | {writes}/s | - | Controlled by metrics.sqlserver.page.lazy_write.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.life_expectancy | Gauge | s | performance_counter.object_name | Controlled by metrics.sqlserver.page.life_expectancy.enabled (default true). |
| sqlserver.page.lookup.rate | Gauge | {lookups}/s | - | Controlled by metrics.sqlserver.page.lookup.rate.enabled (default false). |
| sqlserver.page.operation.rate | Gauge | {operations}/s | page.operations | Controlled by metrics.sqlserver.page.operation.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.read_ahead.rate | Gauge | {page}/s | - | Controlled by metrics.sqlserver.page.read_ahead.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.split.rate | Gauge | {pages}/s | - | Controlled by metrics.sqlserver.page.split.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.parameterization.rate | Gauge | {params}/s | sqlserver.parameterization.result | Controlled by metrics.sqlserver.parameterization.rate.enabled (default false). |
| sqlserver.plan.execution.rate | Gauge | {executions}/s | sqlserver.plan.guidance.result | Controlled by metrics.sqlserver.plan.execution.rate.enabled (default false). |
| sqlserver.processes.blocked | Gauge | {processes} | - | Controlled by metrics.sqlserver.processes.blocked.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.recompilation.ratio | Gauge | % | - | Controlled by metrics.sqlserver.recompilation.ratio.enabled (default false). |
| sqlserver.replica.data.rate | Gauge | By/s | replica.direction | Controlled by metrics.sqlserver.replica.data.rate.enabled (default false). |
| sqlserver.resource_pool.disk.operations | Gauge | {operations}/s | direction | Controlled by metrics.sqlserver.resource_pool.disk.operations.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.resource_pool.disk.throttled.read.rate | Gauge | {reads}/s | - | Controlled by metrics.sqlserver.resource_pool.disk.throttled.read.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.resource_pool.disk.throttled.write.rate | Gauge | {writes}/s | - | Controlled by metrics.sqlserver.resource_pool.disk.throttled.write.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.scan_point.revalidation.rate | Gauge | {revalidate}/s | - | Controlled by metrics.sqlserver.scan_point.revalidation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.stored_procedure.invocation.rate | Gauge | {invocation}/s | - | Controlled by metrics.sqlserver.stored_procedure.invocation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.table.count | Sum | {tables} | table.state, table.status | Controlled by metrics.sqlserver.table.count.enabled (default false). |
| sqlserver.task.count | Gauge | {task} | task.state | Controlled by metrics.sqlserver.task.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.task.rate | Gauge | {task}/s | task.result | Controlled by metrics.sqlserver.task.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.transaction.delay | Sum | ms | - | Controlled by metrics.sqlserver.transaction.delay.enabled (default false). |
| sqlserver.transaction.mirror_write.rate | Gauge | {transactions}/s | - | Controlled by metrics.sqlserver.transaction.mirror_write.rate.enabled (default false). |
| sqlserver.transaction.rate | Gauge | {transactions}/s | - | Controlled by metrics.sqlserver.transaction.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction.write.rate | Gauge | {transactions}/s | - | Controlled by metrics.sqlserver.transaction.write.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.data.rate | Gauge | By/s | - | Controlled by metrics.sqlserver.transaction_log.flush.data.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.rate | Gauge | {flushes}/s | - | Controlled by metrics.sqlserver.transaction_log.flush.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.wait.rate | Gauge | {commits}/s | - | Controlled by metrics.sqlserver.transaction_log.flush.wait.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.growth.count | Sum | {growths} | - | Controlled by metrics.sqlserver.transaction_log.growth.count.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.shrink.count | Sum | {shrinks} | - | Controlled by metrics.sqlserver.transaction_log.shrink.count.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.usage | Gauge | % | - | Controlled by metrics.sqlserver.transaction_log.usage.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.user.connection.count | Gauge | {connections} | - | Controlled by metrics.sqlserver.user.connection.count.enabled (default true). |
| sqlserver.worker.request.count | Gauge | {request} | request.state | Controlled by metrics.sqlserver.worker.request.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.worker.thread.count | Gauge | {thread} | worker.state | Controlled by metrics.sqlserver.worker.thread.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.worktable.cache.hit_ratio | Gauge | 1 | - | Controlled by metrics.sqlserver.worktable.cache.hit_ratio.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| db.server.query_plan | sqlserver.query_hash, sqlserver.query_plan, sqlserver.query_plan_hash | Controlled by events.db.server.query_plan.enabled (default false). Sourced from the db.server.top_query collection, so it emits nothing unless db.server.top_query is also enabled. When enabled, `sqlserver.query_plan` is removed from db.server.top_query records and carried only here; join back on `sqlserver.query_hash` + `sqlserver.query_plan_hash`. |
| db.server.query_sample | client.address, client.port, db.namespace, db.query.text, db.system.name, network.peer.address, network.peer.port, sqlserver.blocking_session_id, sqlserver.blocking.start_time, sqlserver.client.app.name, sqlserver.context_info, sqlserver.command, sqlserver.cpu_time, sqlserver.deadlock_priority, sqlserver.estimated_completion_time, sqlserver.lock_timeout, sqlserver.logical_reads, sqlserver.open_transaction_count, sqlserver.percent_complete, sqlserver.query_hash, sqlserver.query_plan_hash, sqlserver.query_start, sqlserver.reads, sqlserver.request_status, sqlserver.wait.resource.id, sqlserver.wait.resource.type, sqlserver.row_count, sqlserver.session.duration, sqlserver.session.start_time, sqlserver.session_id, sqlserver.session_status, sqlserver.total_elapsed_time, sqlserver.transaction_id, sqlserver.transaction_isolation_level, sqlserver.wait_resource, sqlserver.wait_time, sqlserver.wait_type, sqlserver.writes, user.name, sqlserver.procedure_id, sqlserver.procedure_name | Controlled by events.db.server.query_sample.enabled (default false). `db.query.text` is obfuscated and whitespace-normalized. Sessions blocked on schema locks remain eligible even when `sys.dm_exec_sql_text` returns no text. |
| db.server.top_procedure | db.system.name, db.namespace, sqlserver.procedure_id, sqlserver.procedure_name, sqlserver.schema.name, sqlserver.procedure_execution_count, sqlserver.total_worker_time, sqlserver.total_elapsed_time, sqlserver.total_logical_reads, sqlserver.total_logical_writes, sqlserver.total_physical_reads, sqlserver.procedure.tempdb.spilled_pages, sqlserver.procedure.max_duration, sqlserver.procedure.min_duration, sqlserver.procedure.last_execution_time | Controlled by events.db.server.top_procedure.enabled (default false). Top `top_procedure_collection.top_procedure_count` (default 250) procedures by elapsed-time delta, collected at most once per `top_procedure_collection.collection_interval` (default 60s); counters are deltas, `max_duration`/`min_duration` are lifetime values. First scrape only seeds the cache; procedures in system databases are never reported. Requires `VIEW ANY DEFINITION` and SQL Server 2017 CU3+. |
| db.server.top_query | sqlserver.total_worker_time, db.query.text, db.namespace, sqlserver.execution_count, sqlserver.total_logical_reads, sqlserver.total_logical_writes, sqlserver.total_physical_reads, sqlserver.query_hash, sqlserver.query_plan, sqlserver.query_plan_hash, sqlserver.total_rows, sqlserver.total_elapsed_time, sqlserver.total_grant_kb, db.system.name, sqlserver.procedure_execution_count, sqlserver.procedure_id, sqlserver.procedure_name, sqlserver.query.last_started, sqlserver.query.plan.creation_time | Controlled by events.db.server.top_query.enabled (default false). Query text is obfuscated and whitespace-normalized; query-plan attributes are retained if plan obfuscation fails, with offending SQL attributes redacted. `sqlserver.query_plan` is omitted when events.db.server.query_plan.enabled is true. `server.address`/`server.port` are no longer event attributes; they are resource attributes, enabled by default (the `receiver.sqlserver.RemoveServerResourceAttribute` feature gate was removed). |

## Sources

- receiver/sqlserverreceiver/metadata.yaml
- receiver/sqlserverreceiver/scraper.go
- receiver/sqlserverreceiver/recorders.go
- receiver/sqlserverreceiver/config.go
- receiver/sqlserverreceiver/factory.go
- receiver/sqlserverreceiver/logs-documentation.md
- receiver/sqlserverreceiver/README.md
        • v0.162.0.md 25.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/sqlserverreceiver
version: v0.162.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/sqlserverreceiver
commit_sha: ae8c507510f48f433ab47dd1c6b01a59d6c388b5
last_verified: 2026-10-03
---

# SQL Server receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| sqlserver.access.scan.rate | Gauge | {scan}/s | sqlserver.access.scan.type | Controlled by metrics.sqlserver.access.scan.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.attention.rate | Gauge | {attentions}/s | - | Controlled by metrics.sqlserver.attention.rate.enabled (default false). |
| sqlserver.availability_group.database_replica.queue.rate | Gauge | By/s | sqlserver.availability_group.name, sqlserver.replica.name, sqlserver.availability_group.queue.type | Controlled by metrics.sqlserver.availability_group.database_replica.queue.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server and the instance has Always On Availability Groups enabled. |
| sqlserver.availability_group.database_replica.queue.size | Gauge | By | sqlserver.availability_group.name, sqlserver.replica.name, sqlserver.availability_group.queue.type | Controlled by metrics.sqlserver.availability_group.database_replica.queue.size.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server and the instance has Always On Availability Groups enabled. |
| sqlserver.availability_group.database_replica.secondary_lag | Gauge | s | sqlserver.availability_group.name, sqlserver.replica.name | Controlled by metrics.sqlserver.availability_group.database_replica.secondary_lag.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server and the instance has Always On Availability Groups enabled. |
| sqlserver.batch.request.rate | Gauge | {requests}/s | - | Controlled by metrics.sqlserver.batch.request.rate.enabled (default true). |
| sqlserver.batch.sql_compilation.rate | Gauge | {compilations}/s | - | Controlled by metrics.sqlserver.batch.sql_compilation.rate.enabled (default true). |
| sqlserver.batch.sql_recompilation.rate | Gauge | {compilations}/s | - | Controlled by metrics.sqlserver.batch.sql_recompilation.rate.enabled (default true). |
| sqlserver.clr.execution.time | Sum | s | - | Controlled by metrics.sqlserver.clr.execution.time.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.computer.uptime | Gauge | {seconds} | - | Controlled by metrics.sqlserver.computer.uptime.enabled (default false). |
| sqlserver.connection.reset.rate | Gauge | {connection}/s | - | Controlled by metrics.sqlserver.connection.reset.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cpu.count | Gauge | {CPUs} | - | Controlled by metrics.sqlserver.cpu.count.enabled (default false). |
| sqlserver.cpu.utilization | Gauge | 1 | - | Controlled by metrics.sqlserver.cpu.utilization.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cursor.count | Gauge | {cursor} | cursor.state | Controlled by metrics.sqlserver.cursor.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cursor.memory.usage | Gauge | By | - | Controlled by metrics.sqlserver.cursor.memory.usage.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cursor.plan.count | Gauge | {plan} | - | Controlled by metrics.sqlserver.cursor.plan.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cursor.request.rate | Gauge | {request}/s | - | Controlled by metrics.sqlserver.cursor.request.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.backup_or_restore.rate | Gauge | {backups_or_restores}/s | - | Controlled by metrics.sqlserver.database.backup_or_restore.rate.enabled (default false). |
| sqlserver.database.count | Gauge | {databases} | database.status | Controlled by metrics.sqlserver.database.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.execution.errors | Gauge | {errors} | - | Controlled by metrics.sqlserver.database.execution.errors.enabled (default false). |
| sqlserver.database.full_scan.rate | Gauge | {scans}/s | - | Controlled by metrics.sqlserver.database.full_scan.rate.enabled (default false). |
| sqlserver.database.io | Sum | By | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.io.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.latency | Sum | s | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.latency.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.operations | Sum | {operations} | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.operations.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.tempdb.space | Sum | kBy | tempdb.state | Controlled by metrics.sqlserver.database.tempdb.space.enabled (default false). |
| sqlserver.database.tempdb.version_store.size | Gauge | kBy | - | Controlled by metrics.sqlserver.database.tempdb.version_store.size.enabled (default false). |
| sqlserver.deadlock.rate | Gauge | {deadlocks}/s | - | Controlled by metrics.sqlserver.deadlock.rate.enabled (default false). |
| sqlserver.disk.io | Sum | By | disk.io.direction, sqlserver.file.path.prefix | Controlled by metrics.sqlserver.disk.io.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. Only covers I/O for SQL Server database files, not total host disk I/O. |
| sqlserver.disk.operations | Sum | {operation} | disk.io.direction, sqlserver.file.path.prefix | Controlled by metrics.sqlserver.disk.operations.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. Only covers I/O for SQL Server database files, not total host disk I/O. |
| sqlserver.error.rate | Gauge | {error}/s | sqlserver.error.category | Controlled by metrics.sqlserver.error.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.extent.operation.rate | Gauge | {extent}/s | sqlserver.extent.operation.type | Controlled by metrics.sqlserver.extent.operation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.ghost_record.skipped.rate | Gauge | {record}/s | - | Controlled by metrics.sqlserver.ghost_record.skipped.rate.enabled (default false). |
| sqlserver.host.memory.limit | Gauge | By | - | Controlled by metrics.sqlserver.host.memory.limit.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.host.memory.usage | Gauge | By | system.memory.state | Controlled by metrics.sqlserver.host.memory.usage.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.fragmentation | Gauge | % | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.fragmentation.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.page.count | Gauge | {page} | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.page.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.page.utilization | Gauge | % | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.page.utilization.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.record.count | Gauge | {record} | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.record.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.search.rate | Gauge | {searches}/s | - | Controlled by metrics.sqlserver.index.search.rate.enabled (default false). |
| sqlserver.index.size | Gauge | By | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.size.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.superlatch.count | Gauge | {superlatch} | - | Controlled by metrics.sqlserver.latch.superlatch.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.superlatch.transition.rate | Gauge | {transition}/s | transition.direction | Controlled by metrics.sqlserver.latch.superlatch.transition.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.wait.rate | Gauge | {wait}/s | - | Controlled by metrics.sqlserver.latch.wait.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.wait_time.avg | Gauge | s | - | Controlled by metrics.sqlserver.latch.wait_time.avg.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.wait_time.total | Sum | s | - | Controlled by metrics.sqlserver.latch.wait_time.total.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.block.count | Gauge | {block} | sqlserver.lock.block.type | Controlled by metrics.sqlserver.lock.block.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.escalation.rate | Gauge | {escalation}/s | - | Controlled by metrics.sqlserver.lock.escalation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.memory | Gauge | By | - | Controlled by metrics.sqlserver.lock.memory.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.request.rate | Gauge | {request}/s | - | Controlled by metrics.sqlserver.lock.request.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.timeout.rate | Gauge | {timeout}/s | sqlserver.lock.timeout.type | Controlled by metrics.sqlserver.lock.timeout.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.wait.count | Sum | {wait} | - | Controlled by metrics.sqlserver.lock.wait.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.wait.rate | Gauge | {requests}/s | - | Controlled by metrics.sqlserver.lock.wait.rate.enabled (default true). |
| sqlserver.lock.wait_time.avg | Gauge | ms | - | Controlled by metrics.sqlserver.lock.wait_time.avg.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.lock.wait_time.total | Sum | s | - | Controlled by metrics.sqlserver.lock.wait_time.total.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.login.rate | Gauge | {logins}/s | - | Controlled by metrics.sqlserver.login.rate.enabled (default false). |
| sqlserver.logout.rate | Gauge | {logouts}/s | - | Controlled by metrics.sqlserver.logout.rate.enabled (default false). |
| sqlserver.memory.area | Gauge | By | memory.pool | Controlled by metrics.sqlserver.memory.area.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.memory.cache.object.count | Gauge | {object} | cache.state | Controlled by metrics.sqlserver.memory.cache.object.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.memory.grants.pending.count | Sum | {grants} | - | Controlled by metrics.sqlserver.memory.grants.pending.count.enabled (default false). |
| sqlserver.memory.page.count | Gauge | {page} | page.pool | Controlled by metrics.sqlserver.memory.page.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.memory.usage | Sum | kBy | - | Controlled by metrics.sqlserver.memory.usage.enabled (default false). |
| sqlserver.os.wait.duration | Sum | s | wait.category, wait.type | Controlled by metrics.sqlserver.os.wait.duration.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.allocation.rate | Gauge | {page}/s | sqlserver.page.allocation.type | Controlled by metrics.sqlserver.page.allocation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.buffer_cache.free_list.stalls.rate | Gauge | {stalls}/s | - | Controlled by metrics.sqlserver.page.buffer_cache.free_list.stalls.rate.enabled (default false). |
| sqlserver.page.buffer_cache.hit_ratio | Gauge | % | - | Controlled by metrics.sqlserver.page.buffer_cache.hit_ratio.enabled (default true). |
| sqlserver.page.checkpoint.flush.rate | Gauge | {pages}/s | - | Controlled by metrics.sqlserver.page.checkpoint.flush.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.compression.rate | Gauge | {page}/s | sqlserver.page.compression.type | Controlled by metrics.sqlserver.page.compression.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.lazy_write.rate | Gauge | {writes}/s | - | Controlled by metrics.sqlserver.page.lazy_write.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.life_expectancy | Gauge | s | performance_counter.object_name | Controlled by metrics.sqlserver.page.life_expectancy.enabled (default true). |
| sqlserver.page.lookup.rate | Gauge | {lookups}/s | - | Controlled by metrics.sqlserver.page.lookup.rate.enabled (default false). |
| sqlserver.page.operation.rate | Gauge | {operations}/s | page.operations | Controlled by metrics.sqlserver.page.operation.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.read_ahead.rate | Gauge | {page}/s | - | Controlled by metrics.sqlserver.page.read_ahead.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.split.rate | Gauge | {pages}/s | - | Controlled by metrics.sqlserver.page.split.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.parameterization.rate | Gauge | {params}/s | sqlserver.parameterization.result | Controlled by metrics.sqlserver.parameterization.rate.enabled (default false). |
| sqlserver.plan.execution.rate | Gauge | {executions}/s | sqlserver.plan.guidance.result | Controlled by metrics.sqlserver.plan.execution.rate.enabled (default false). |
| sqlserver.processes.blocked | Gauge | {processes} | - | Controlled by metrics.sqlserver.processes.blocked.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.recompilation.ratio | Gauge | % | - | Controlled by metrics.sqlserver.recompilation.ratio.enabled (default false). |
| sqlserver.replica.data.rate | Gauge | By/s | replica.direction | Controlled by metrics.sqlserver.replica.data.rate.enabled (default false). |
| sqlserver.resource_pool.disk.operations | Gauge | {operations}/s | direction | Controlled by metrics.sqlserver.resource_pool.disk.operations.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.resource_pool.disk.throttled.read.rate | Gauge | {reads}/s | - | Controlled by metrics.sqlserver.resource_pool.disk.throttled.read.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.resource_pool.disk.throttled.write.rate | Gauge | {writes}/s | - | Controlled by metrics.sqlserver.resource_pool.disk.throttled.write.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.scan_point.revalidation.rate | Gauge | {revalidate}/s | - | Controlled by metrics.sqlserver.scan_point.revalidation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.stored_procedure.invocation.rate | Gauge | {invocation}/s | - | Controlled by metrics.sqlserver.stored_procedure.invocation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.table.count | Sum | {tables} | table.state, table.status | Controlled by metrics.sqlserver.table.count.enabled (default false). |
| sqlserver.task.count | Gauge | {task} | task.state | Controlled by metrics.sqlserver.task.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.task.rate | Gauge | {task}/s | task.result | Controlled by metrics.sqlserver.task.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.transaction.delay | Sum | ms | - | Controlled by metrics.sqlserver.transaction.delay.enabled (default false). |
| sqlserver.transaction.mirror_write.rate | Gauge | {transactions}/s | - | Controlled by metrics.sqlserver.transaction.mirror_write.rate.enabled (default false). |
| sqlserver.transaction.rate | Gauge | {transactions}/s | - | Controlled by metrics.sqlserver.transaction.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction.write.rate | Gauge | {transactions}/s | - | Controlled by metrics.sqlserver.transaction.write.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.data.rate | Gauge | By/s | - | Controlled by metrics.sqlserver.transaction_log.flush.data.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.rate | Gauge | {flushes}/s | - | Controlled by metrics.sqlserver.transaction_log.flush.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.wait.rate | Gauge | {commits}/s | - | Controlled by metrics.sqlserver.transaction_log.flush.wait.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.growth.count | Sum | {growths} | - | Controlled by metrics.sqlserver.transaction_log.growth.count.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.shrink.count | Sum | {shrinks} | - | Controlled by metrics.sqlserver.transaction_log.shrink.count.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.usage | Gauge | % | - | Controlled by metrics.sqlserver.transaction_log.usage.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.user.connection.count | Gauge | {connections} | - | Controlled by metrics.sqlserver.user.connection.count.enabled (default true). |
| sqlserver.worker.request.count | Gauge | {request} | request.state | Controlled by metrics.sqlserver.worker.request.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.worker.thread.count | Gauge | {thread} | worker.state | Controlled by metrics.sqlserver.worker.thread.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.worktable.cache.hit_ratio | Gauge | 1 | - | Controlled by metrics.sqlserver.worktable.cache.hit_ratio.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| db.server.query_plan | db.namespace, db.system.name, sqlserver.query_hash, sqlserver.query_plan, sqlserver.query_plan_hash | Controlled by events.db.server.query_plan.enabled (default false). Sourced from the db.server.top_query collection, so it emits nothing unless db.server.top_query is also enabled. When enabled, `sqlserver.query_plan` is removed from db.server.top_query records and carried only here; join back on `sqlserver.query_hash` + `sqlserver.query_plan_hash`. |
| db.server.query_sample | client.address, client.port, db.namespace, db.query.text, db.system.name, network.peer.address, network.peer.port, sqlserver.blocking_session_id, sqlserver.blocking.start_time, sqlserver.client.app.name, sqlserver.context_info, sqlserver.command, sqlserver.cpu_time, sqlserver.deadlock_priority, sqlserver.estimated_completion_time, sqlserver.lock_timeout, sqlserver.logical_reads, sqlserver.open_transaction_count, sqlserver.percent_complete, sqlserver.query_hash, sqlserver.query_plan_hash, sqlserver.query_start, sqlserver.reads, sqlserver.request_status, sqlserver.wait.resource.id, sqlserver.wait.resource.type, sqlserver.row_count, sqlserver.session.duration, sqlserver.session.start_time, sqlserver.session_id, sqlserver.session_status, sqlserver.total_elapsed_time, sqlserver.transaction_id, sqlserver.transaction_isolation_level, sqlserver.wait_resource, sqlserver.wait_time, sqlserver.wait_type, sqlserver.writes, user.name, sqlserver.procedure_id, sqlserver.procedure_name | Controlled by events.db.server.query_sample.enabled (default false). `db.query.text` is obfuscated and whitespace-normalized. Sessions blocked on schema locks remain eligible even when `sys.dm_exec_sql_text` returns no text. |
| db.server.top_procedure | db.system.name, db.namespace, sqlserver.procedure_id, sqlserver.procedure_name, sqlserver.schema.name, sqlserver.procedure_execution_count, sqlserver.total_worker_time, sqlserver.total_elapsed_time, sqlserver.total_logical_reads, sqlserver.total_logical_writes, sqlserver.total_physical_reads, sqlserver.procedure.tempdb.spilled_pages, sqlserver.procedure.max_duration, sqlserver.procedure.min_duration, sqlserver.procedure.last_execution_time | Controlled by events.db.server.top_procedure.enabled (default false). Top `top_procedure_collection.top_procedure_count` (default 250) procedures by elapsed-time delta, collected at most once per `top_procedure_collection.collection_interval` (default 60s); counters are deltas, `max_duration`/`min_duration` are lifetime values. First scrape only seeds the cache; procedures in system databases are never reported. Requires `VIEW ANY DEFINITION` and SQL Server 2017 CU3+. |
| db.server.top_query | sqlserver.total_worker_time, db.query.text, db.namespace, sqlserver.execution_count, sqlserver.total_logical_reads, sqlserver.total_logical_writes, sqlserver.total_physical_reads, sqlserver.query_hash, sqlserver.query_plan, sqlserver.query_plan_hash, sqlserver.total_rows, sqlserver.total_elapsed_time, sqlserver.total_grant_kb, db.system.name, sqlserver.procedure_execution_count, sqlserver.procedure_id, sqlserver.procedure_name, sqlserver.query.last_started, sqlserver.query.plan.creation_time | Controlled by events.db.server.top_query.enabled (default false). Query text is obfuscated and whitespace-normalized; query-plan attributes are retained if plan obfuscation fails, with offending SQL attributes redacted. `sqlserver.query_plan` is omitted when events.db.server.query_plan.enabled is true. `server.address`/`server.port` are no longer event attributes; they are resource attributes, enabled by default (the `receiver.sqlserver.RemoveServerResourceAttribute` feature gate was removed). |

## Sources

- receiver/sqlserverreceiver/metadata.yaml
- receiver/sqlserverreceiver/scraper.go
- receiver/sqlserverreceiver/recorders.go
- receiver/sqlserverreceiver/config.go
- receiver/sqlserverreceiver/factory.go
- receiver/sqlserverreceiver/logs-documentation.md
- receiver/sqlserverreceiver/README.md
        • v0.163.0.md 25.6 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/sqlserverreceiver
version: v0.163.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/sqlserverreceiver
commit_sha: df849b5403c041d5e799e7846392a6f18b0b55ae
last_verified: 2026-10-14
---

# SQL Server receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| sqlserver.access.scan.rate | Gauge | {scan}/s | sqlserver.access.scan.type | Controlled by metrics.sqlserver.access.scan.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.attention.rate | Gauge | {attentions}/s | - | Controlled by metrics.sqlserver.attention.rate.enabled (default false). |
| sqlserver.availability_group.database_replica.queue.rate | Gauge | By/s | sqlserver.availability_group.name, sqlserver.replica.name, sqlserver.availability_group.queue.type | Controlled by metrics.sqlserver.availability_group.database_replica.queue.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server and the instance has Always On Availability Groups enabled. |
| sqlserver.availability_group.database_replica.queue.size | Gauge | By | sqlserver.availability_group.name, sqlserver.replica.name, sqlserver.availability_group.queue.type | Controlled by metrics.sqlserver.availability_group.database_replica.queue.size.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server and the instance has Always On Availability Groups enabled. |
| sqlserver.availability_group.database_replica.secondary_lag | Gauge | s | sqlserver.availability_group.name, sqlserver.replica.name | Controlled by metrics.sqlserver.availability_group.database_replica.secondary_lag.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server and the instance has Always On Availability Groups enabled. |
| sqlserver.batch.request.rate | Gauge | {requests}/s | - | Controlled by metrics.sqlserver.batch.request.rate.enabled (default true). |
| sqlserver.batch.sql_compilation.rate | Gauge | {compilations}/s | - | Controlled by metrics.sqlserver.batch.sql_compilation.rate.enabled (default true). |
| sqlserver.batch.sql_recompilation.rate | Gauge | {compilations}/s | - | Controlled by metrics.sqlserver.batch.sql_recompilation.rate.enabled (default true). |
| sqlserver.clr.execution.time | Sum | s | - | Controlled by metrics.sqlserver.clr.execution.time.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.computer.uptime | Gauge | {seconds} | - | Controlled by metrics.sqlserver.computer.uptime.enabled (default false). |
| sqlserver.connection.reset.rate | Gauge | {connection}/s | - | Controlled by metrics.sqlserver.connection.reset.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cpu.count | Gauge | {CPUs} | - | Controlled by metrics.sqlserver.cpu.count.enabled (default false). |
| sqlserver.cpu.utilization | Gauge | 1 | - | Controlled by metrics.sqlserver.cpu.utilization.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cursor.count | Gauge | {cursor} | cursor.state | Controlled by metrics.sqlserver.cursor.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cursor.memory.usage | Gauge | By | - | Controlled by metrics.sqlserver.cursor.memory.usage.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cursor.plan.count | Gauge | {plan} | - | Controlled by metrics.sqlserver.cursor.plan.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.cursor.request.rate | Gauge | {request}/s | - | Controlled by metrics.sqlserver.cursor.request.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.backup_or_restore.rate | Gauge | {backups_or_restores}/s | - | Controlled by metrics.sqlserver.database.backup_or_restore.rate.enabled (default false). |
| sqlserver.database.count | Gauge | {databases} | database.status | Controlled by metrics.sqlserver.database.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.execution.errors | Gauge | {errors} | - | Controlled by metrics.sqlserver.database.execution.errors.enabled (default false). |
| sqlserver.database.full_scan.rate | Gauge | {scans}/s | - | Controlled by metrics.sqlserver.database.full_scan.rate.enabled (default false). |
| sqlserver.database.io | Sum | By | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.io.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.latency | Sum | s | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.latency.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.operations | Sum | {operations} | physical_filename, logical_filename, file_type, direction | Controlled by metrics.sqlserver.database.operations.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.database.tempdb.space | Sum | kBy | tempdb.state | Controlled by metrics.sqlserver.database.tempdb.space.enabled (default false). |
| sqlserver.database.tempdb.version_store.size | Gauge | kBy | - | Controlled by metrics.sqlserver.database.tempdb.version_store.size.enabled (default false). |
| sqlserver.deadlock.rate | Gauge | {deadlocks}/s | - | Controlled by metrics.sqlserver.deadlock.rate.enabled (default false). |
| sqlserver.disk.io | Sum | By | disk.io.direction, sqlserver.file.path.prefix | Controlled by metrics.sqlserver.disk.io.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. Only covers I/O for SQL Server database files, not total host disk I/O. |
| sqlserver.disk.operations | Sum | {operation} | disk.io.direction, sqlserver.file.path.prefix | Controlled by metrics.sqlserver.disk.operations.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. Only covers I/O for SQL Server database files, not total host disk I/O. |
| sqlserver.error.rate | Gauge | {error}/s | sqlserver.error.category | Controlled by metrics.sqlserver.error.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.extent.operation.rate | Gauge | {extent}/s | sqlserver.extent.operation.type | Controlled by metrics.sqlserver.extent.operation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.ghost_record.skipped.rate | Gauge | {record}/s | - | Controlled by metrics.sqlserver.ghost_record.skipped.rate.enabled (default false). |
| sqlserver.host.memory.limit | Gauge | By | - | Controlled by metrics.sqlserver.host.memory.limit.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.host.memory.usage | Gauge | By | system.memory.state | Controlled by metrics.sqlserver.host.memory.usage.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.fragmentation | Gauge | % | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.fragmentation.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.page.count | Gauge | {page} | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.page.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.page.utilization | Gauge | % | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.page.utilization.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.record.count | Gauge | {record} | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.record.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.index.search.rate | Gauge | {searches}/s | - | Controlled by metrics.sqlserver.index.search.rate.enabled (default false). |
| sqlserver.index.size | Gauge | By | db.namespace, sqlserver.index.id, sqlserver.object.name, sqlserver.schema.name | Controlled by metrics.sqlserver.index.size.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.superlatch.count | Gauge | {superlatch} | - | Controlled by metrics.sqlserver.latch.superlatch.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.superlatch.transition.rate | Gauge | {transition}/s | transition.direction | Controlled by metrics.sqlserver.latch.superlatch.transition.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.wait.rate | Gauge | {wait}/s | - | Controlled by metrics.sqlserver.latch.wait.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.wait_time.avg | Gauge | s | - | Controlled by metrics.sqlserver.latch.wait_time.avg.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.latch.wait_time.total | Sum | s | - | Controlled by metrics.sqlserver.latch.wait_time.total.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.block.count | Gauge | {block} | sqlserver.lock.block.type | Controlled by metrics.sqlserver.lock.block.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.escalation.rate | Gauge | {escalation}/s | - | Controlled by metrics.sqlserver.lock.escalation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.memory | Gauge | By | - | Controlled by metrics.sqlserver.lock.memory.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.request.rate | Gauge | {request}/s | - | Controlled by metrics.sqlserver.lock.request.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.timeout.rate | Gauge | {timeout}/s | sqlserver.lock.timeout.type | Controlled by metrics.sqlserver.lock.timeout.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.wait.count | Sum | {wait} | - | Controlled by metrics.sqlserver.lock.wait.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.lock.wait.rate | Gauge | {requests}/s | - | Controlled by metrics.sqlserver.lock.wait.rate.enabled (default true). |
| sqlserver.lock.wait_time.avg | Gauge | ms | - | Controlled by metrics.sqlserver.lock.wait_time.avg.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.lock.wait_time.total | Sum | s | - | Controlled by metrics.sqlserver.lock.wait_time.total.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.login.rate | Gauge | {logins}/s | - | Controlled by metrics.sqlserver.login.rate.enabled (default false). |
| sqlserver.logout.rate | Gauge | {logouts}/s | - | Controlled by metrics.sqlserver.logout.rate.enabled (default false). |
| sqlserver.memory.area | Gauge | By | memory.pool | Controlled by metrics.sqlserver.memory.area.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.memory.cache.object.count | Gauge | {object} | cache.state | Controlled by metrics.sqlserver.memory.cache.object.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.memory.grants.pending.count | Sum | {grants} | - | Controlled by metrics.sqlserver.memory.grants.pending.count.enabled (default false). |
| sqlserver.memory.page.count | Gauge | {page} | page.pool | Controlled by metrics.sqlserver.memory.page.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.memory.usage | Sum | kBy | - | Controlled by metrics.sqlserver.memory.usage.enabled (default false). |
| sqlserver.os.wait.duration | Sum | s | wait.category, wait.type | Controlled by metrics.sqlserver.os.wait.duration.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.allocation.rate | Gauge | {page}/s | sqlserver.page.allocation.type | Controlled by metrics.sqlserver.page.allocation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.buffer_cache.free_list.stalls.rate | Gauge | {stalls}/s | - | Controlled by metrics.sqlserver.page.buffer_cache.free_list.stalls.rate.enabled (default false). |
| sqlserver.page.buffer_cache.hit_ratio | Gauge | % | - | Controlled by metrics.sqlserver.page.buffer_cache.hit_ratio.enabled (default true). |
| sqlserver.page.checkpoint.flush.rate | Gauge | {pages}/s | - | Controlled by metrics.sqlserver.page.checkpoint.flush.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.compression.rate | Gauge | {page}/s | sqlserver.page.compression.type | Controlled by metrics.sqlserver.page.compression.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.lazy_write.rate | Gauge | {writes}/s | - | Controlled by metrics.sqlserver.page.lazy_write.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.life_expectancy | Gauge | s | performance_counter.object_name | Controlled by metrics.sqlserver.page.life_expectancy.enabled (default true). |
| sqlserver.page.lookup.rate | Gauge | {lookups}/s | - | Controlled by metrics.sqlserver.page.lookup.rate.enabled (default false). |
| sqlserver.page.operation.rate | Gauge | {operations}/s | page.operations | Controlled by metrics.sqlserver.page.operation.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.page.read_ahead.rate | Gauge | {page}/s | - | Controlled by metrics.sqlserver.page.read_ahead.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.page.split.rate | Gauge | {pages}/s | - | Controlled by metrics.sqlserver.page.split.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.parameterization.rate | Gauge | {params}/s | sqlserver.parameterization.result | Controlled by metrics.sqlserver.parameterization.rate.enabled (default false). |
| sqlserver.plan.execution.rate | Gauge | {executions}/s | sqlserver.plan.guidance.result | Controlled by metrics.sqlserver.plan.execution.rate.enabled (default false). |
| sqlserver.processes.blocked | Gauge | {processes} | - | Controlled by metrics.sqlserver.processes.blocked.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.recompilation.ratio | Gauge | % | - | Controlled by metrics.sqlserver.recompilation.ratio.enabled (default false). |
| sqlserver.replica.data.rate | Gauge | By/s | replica.direction | Controlled by metrics.sqlserver.replica.data.rate.enabled (default false). |
| sqlserver.resource_pool.disk.operations | Gauge | {operations}/s | direction | Controlled by metrics.sqlserver.resource_pool.disk.operations.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.resource_pool.disk.throttled.read.rate | Gauge | {reads}/s | - | Controlled by metrics.sqlserver.resource_pool.disk.throttled.read.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.resource_pool.disk.throttled.write.rate | Gauge | {writes}/s | - | Controlled by metrics.sqlserver.resource_pool.disk.throttled.write.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.scan_point.revalidation.rate | Gauge | {revalidate}/s | - | Controlled by metrics.sqlserver.scan_point.revalidation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.stored_procedure.invocation.rate | Gauge | {invocation}/s | - | Controlled by metrics.sqlserver.stored_procedure.invocation.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.table.count | Sum | {tables} | table.state, table.status | Controlled by metrics.sqlserver.table.count.enabled (default false). |
| sqlserver.task.count | Gauge | {task} | task.state | Controlled by metrics.sqlserver.task.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.task.rate | Gauge | {task}/s | task.result | Controlled by metrics.sqlserver.task.rate.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.transaction.delay | Sum | ms | - | Controlled by metrics.sqlserver.transaction.delay.enabled (default false). |
| sqlserver.transaction.mirror_write.rate | Gauge | {transactions}/s | - | Controlled by metrics.sqlserver.transaction.mirror_write.rate.enabled (default false). |
| sqlserver.transaction.rate | Gauge | {transactions}/s | - | Controlled by metrics.sqlserver.transaction.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction.write.rate | Gauge | {transactions}/s | - | Controlled by metrics.sqlserver.transaction.write.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.data.rate | Gauge | By/s | - | Controlled by metrics.sqlserver.transaction_log.flush.data.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.rate | Gauge | {flushes}/s | - | Controlled by metrics.sqlserver.transaction_log.flush.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.flush.wait.rate | Gauge | {commits}/s | - | Controlled by metrics.sqlserver.transaction_log.flush.wait.rate.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.growth.count | Sum | {growths} | - | Controlled by metrics.sqlserver.transaction_log.growth.count.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.shrink.count | Sum | {shrinks} | - | Controlled by metrics.sqlserver.transaction_log.shrink.count.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.transaction_log.usage | Gauge | % | - | Controlled by metrics.sqlserver.transaction_log.usage.enabled (default true). This metric is only available when running on Windows. |
| sqlserver.user.connection.count | Gauge | {connections} | - | Controlled by metrics.sqlserver.user.connection.count.enabled (default true). |
| sqlserver.worker.request.count | Gauge | {request} | request.state | Controlled by metrics.sqlserver.worker.request.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.worker.thread.count | Gauge | {thread} | worker.state | Controlled by metrics.sqlserver.worker.thread.count.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |
| sqlserver.worktable.cache.hit_ratio | Gauge | 1 | - | Controlled by metrics.sqlserver.worktable.cache.hit_ratio.enabled (default false). This metric is only available when the receiver is configured to directly connect to SQL Server. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| db.server.query_plan | db.namespace, db.system.name, sqlserver.query_hash, sqlserver.query_plan, sqlserver.query_plan_hash | Controlled by events.db.server.query_plan.enabled (default false). Sourced from the db.server.top_query collection, so it emits nothing unless db.server.top_query is also enabled. When enabled, `sqlserver.query_plan` is removed from db.server.top_query records and carried only here; join back on `sqlserver.query_hash` + `sqlserver.query_plan_hash`. |
| db.server.query_sample | client.address, client.port, db.namespace, db.query.text, db.system.name, network.peer.address, network.peer.port, sqlserver.blocking_session_id, sqlserver.blocking.start_time, sqlserver.client.app.name, sqlserver.context_info, sqlserver.command, sqlserver.cpu_time, sqlserver.deadlock_priority, sqlserver.estimated_completion_time, sqlserver.lock_timeout, sqlserver.logical_reads, sqlserver.open_transaction_count, sqlserver.percent_complete, sqlserver.query_hash, sqlserver.query_plan_hash, sqlserver.query_start, sqlserver.reads, sqlserver.request_status, sqlserver.wait.resource.id, sqlserver.wait.resource.type, sqlserver.row_count, sqlserver.session.duration, sqlserver.session.start_time, sqlserver.session_id, sqlserver.session_status, sqlserver.total_elapsed_time, sqlserver.transaction_id, sqlserver.transaction_isolation_level, sqlserver.wait_resource, sqlserver.wait_time, sqlserver.wait_type, sqlserver.writes, user.name, sqlserver.procedure_id, sqlserver.procedure_name | Controlled by events.db.server.query_sample.enabled (default false). `db.query.text` is obfuscated and whitespace-normalized. Sessions blocked on schema locks remain eligible even when `sys.dm_exec_sql_text` returns no text. |
| db.server.top_procedure | db.system.name, db.namespace, sqlserver.procedure_id, sqlserver.procedure_name, sqlserver.schema.name, sqlserver.procedure_execution_count, sqlserver.total_worker_time, sqlserver.total_elapsed_time, sqlserver.total_logical_reads, sqlserver.total_logical_writes, sqlserver.total_physical_reads, sqlserver.procedure.tempdb.spilled_pages, sqlserver.procedure.max_duration, sqlserver.procedure.min_duration, sqlserver.procedure.last_execution_time | Controlled by events.db.server.top_procedure.enabled (default false). Top `top_procedure_collection.top_procedure_count` (default 250) procedures by elapsed-time delta, collected at most once per `top_procedure_collection.collection_interval` (default 60s); counters are deltas, `max_duration`/`min_duration` are lifetime values. First scrape only seeds the cache; procedures in system databases are never reported. Requires `VIEW ANY DEFINITION` and SQL Server 2017 CU3+. |
| db.server.top_query | sqlserver.total_worker_time, db.query.text, db.namespace, sqlserver.execution_count, sqlserver.total_logical_reads, sqlserver.total_logical_writes, sqlserver.total_physical_reads, sqlserver.query_hash, sqlserver.query_plan, sqlserver.query_plan_hash, sqlserver.total_rows, sqlserver.total_elapsed_time, sqlserver.total_grant_kb, db.system.name, sqlserver.procedure_execution_count, sqlserver.procedure_id, sqlserver.procedure_name, sqlserver.query.last_started, sqlserver.query.plan.creation_time | Controlled by events.db.server.top_query.enabled (default false). Query text is obfuscated and whitespace-normalized; query-plan attributes are retained if plan obfuscation fails, with offending SQL attributes redacted. `sqlserver.query_plan` is omitted when events.db.server.query_plan.enabled is true. `server.address`/`server.port` are no longer event attributes; they are resource attributes, enabled by default (the `receiver.sqlserver.RemoveServerResourceAttribute` feature gate was removed). |

## Sources

- receiver/sqlserverreceiver/metadata.yaml
- receiver/sqlserverreceiver/scraper.go
- receiver/sqlserverreceiver/recorders.go
- receiver/sqlserverreceiver/config.go
- receiver/sqlserverreceiver/factory.go
- receiver/sqlserverreceiver/logs-documentation.md
- receiver/sqlserverreceiver/README.md
      • tcpcheckreceiver
        • v0.153.0.md 1.5 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/tcpcheckreceiver
version: v0.153.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/tcpcheckreceiver
commit_sha: 42f949127580c0d00088b785cd0b35842dc0ddb8
last_verified: 2026-08-11
---

# TCP Check Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `tcpcheck.duration` | Gauge (int) | `ms` | `tcpcheck.endpoint` | Enabled by default; stability `development`. Recorded only when the TCP dial succeeds. |
| `tcpcheck.error` | Sum (cumulative, monotonic, int) | `{errors}` | `tcpcheck.endpoint`, `error.code` | Enabled by default; stability `development`. Recorded only when the TCP dial fails; `error.code` is one of `connection_refused`, `connection_timeout`, `invalid_endpoint`, `network_unreachable`, `unknown_error`, classified from the dial error string. |
| `tcpcheck.status` | Gauge (int) | `1` | `tcpcheck.endpoint` | Enabled by default; stability `development`. `1` on successful connect, `0` on failure. |

Each metric is emitted once per configured target per collection interval, and can be disabled via `metrics::<name>::enabled: false`.

## Sources

- `receiver/tcpcheckreceiver/metadata.yaml`
- `receiver/tcpcheckreceiver/scraper.go`
- `receiver/tcpcheckreceiver/config.go`
- `receiver/tcpcheckreceiver/factory.go`
- `receiver/tcpcheckreceiver/documentation.md`
- `receiver/tcpcheckreceiver/internal/metadata/generated_metrics.go`
- `receiver/tcpcheckreceiver/internal/metadata/generated_status.go`
        • v0.154.0.md 1.5 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/tcpcheckreceiver
version: v0.154.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/tcpcheckreceiver
commit_sha: 853eda0e12b3ba142552ecd2b63cec07062904f0
last_verified: 2026-08-11
---

# TCP Check Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `tcpcheck.duration` | Gauge (int) | `ms` | `tcpcheck.endpoint` | Enabled by default; stability `development`. Recorded only when the TCP dial succeeds. |
| `tcpcheck.error` | Sum (cumulative, monotonic, int) | `{errors}` | `tcpcheck.endpoint`, `error.code` | Enabled by default; stability `development`. Recorded only when the TCP dial fails; `error.code` is one of `connection_refused`, `connection_timeout`, `invalid_endpoint`, `network_unreachable`, `unknown_error`, classified from the dial error string. |
| `tcpcheck.status` | Gauge (int) | `1` | `tcpcheck.endpoint` | Enabled by default; stability `development`. `1` on successful connect, `0` on failure. |

Each metric is emitted once per configured target per collection interval, and can be disabled via `metrics::<name>::enabled: false`.

## Sources

- `receiver/tcpcheckreceiver/metadata.yaml`
- `receiver/tcpcheckreceiver/scraper.go`
- `receiver/tcpcheckreceiver/config.go`
- `receiver/tcpcheckreceiver/factory.go`
- `receiver/tcpcheckreceiver/documentation.md`
- `receiver/tcpcheckreceiver/internal/metadata/generated_metrics.go`
- `receiver/tcpcheckreceiver/internal/metadata/generated_status.go`
        • v0.155.0.md 1.5 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/tcpcheckreceiver
version: v0.155.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/tcpcheckreceiver
commit_sha: aaf5045a24c0a6f000225c97ad5449e69aeb5835
last_verified: 2026-08-11
---

# TCP Check Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `tcpcheck.duration` | Gauge (int) | `ms` | `tcpcheck.endpoint` | Enabled by default; stability `development`. Recorded only when the TCP dial succeeds. |
| `tcpcheck.error` | Sum (cumulative, monotonic, int) | `{errors}` | `tcpcheck.endpoint`, `error.code` | Enabled by default; stability `development`. Recorded only when the TCP dial fails; `error.code` is one of `connection_refused`, `connection_timeout`, `invalid_endpoint`, `network_unreachable`, `unknown_error`, classified from the dial error string. |
| `tcpcheck.status` | Gauge (int) | `1` | `tcpcheck.endpoint` | Enabled by default; stability `development`. `1` on successful connect, `0` on failure. |

Each metric is emitted once per configured target per collection interval, and can be disabled via `metrics::<name>::enabled: false`.

## Sources

- `receiver/tcpcheckreceiver/metadata.yaml`
- `receiver/tcpcheckreceiver/scraper.go`
- `receiver/tcpcheckreceiver/config.go`
- `receiver/tcpcheckreceiver/factory.go`
- `receiver/tcpcheckreceiver/documentation.md`
- `receiver/tcpcheckreceiver/internal/metadata/generated_metrics.go`
- `receiver/tcpcheckreceiver/internal/metadata/generated_status.go`
        • v0.156.0.md 1.5 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/tcpcheckreceiver
version: v0.156.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/tcpcheckreceiver
commit_sha: 41e24cd516dd69a5b4277465cdb2ff4ef0676f49
last_verified: 2026-08-11
---

# TCP Check Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `tcpcheck.duration` | Gauge (int) | `ms` | `tcpcheck.endpoint` | Enabled by default; stability `development`. Recorded only when the TCP dial succeeds. |
| `tcpcheck.error` | Sum (cumulative, monotonic, int) | `{errors}` | `tcpcheck.endpoint`, `error.code` | Enabled by default; stability `development`. Recorded only when the TCP dial fails; `error.code` is one of `connection_refused`, `connection_timeout`, `invalid_endpoint`, `network_unreachable`, `unknown_error`, classified from the dial error string. |
| `tcpcheck.status` | Gauge (int) | `1` | `tcpcheck.endpoint` | Enabled by default; stability `development`. `1` on successful connect, `0` on failure. |

Each metric is emitted once per configured target per collection interval, and can be disabled via `metrics::<name>::enabled: false`.

## Sources

- `receiver/tcpcheckreceiver/metadata.yaml`
- `receiver/tcpcheckreceiver/scraper.go`
- `receiver/tcpcheckreceiver/config.go`
- `receiver/tcpcheckreceiver/factory.go`
- `receiver/tcpcheckreceiver/documentation.md`
- `receiver/tcpcheckreceiver/internal/metadata/generated_metrics.go`
- `receiver/tcpcheckreceiver/internal/metadata/generated_status.go`
        • v0.157.0.md 1.5 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/tcpcheckreceiver
version: v0.157.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/tcpcheckreceiver
commit_sha: 89e43555904cd97c2d36605347c5d5237b1bdc8c
last_verified: 2026-08-11
---

# TCP Check Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `tcpcheck.duration` | Gauge (int) | `ms` | `tcpcheck.endpoint` | Enabled by default; stability `development`. Recorded only when the TCP dial succeeds. |
| `tcpcheck.error` | Sum (cumulative, monotonic, int) | `{errors}` | `tcpcheck.endpoint`, `error.code` | Enabled by default; stability `development`. Recorded only when the TCP dial fails; `error.code` is one of `connection_refused`, `connection_timeout`, `invalid_endpoint`, `network_unreachable`, `unknown_error`, classified from the dial error string. |
| `tcpcheck.status` | Gauge (int) | `1` | `tcpcheck.endpoint` | Enabled by default; stability `development`. `1` on successful connect, `0` on failure. |

Each metric is emitted once per configured target per collection interval, and can be disabled via `metrics::<name>::enabled: false`.

## Sources

- `receiver/tcpcheckreceiver/metadata.yaml`
- `receiver/tcpcheckreceiver/scraper.go`
- `receiver/tcpcheckreceiver/config.go`
- `receiver/tcpcheckreceiver/factory.go`
- `receiver/tcpcheckreceiver/documentation.md`
- `receiver/tcpcheckreceiver/internal/metadata/generated_metrics.go`
- `receiver/tcpcheckreceiver/internal/metadata/generated_status.go`
        • v0.158.0.md 1.5 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/tcpcheckreceiver
version: v0.158.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/tcpcheckreceiver
commit_sha: 821a9d9c2c1623c4a0ceba5d47b57c48879c3f84
last_verified: 2026-08-11
---

# TCP Check Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `tcpcheck.duration` | Gauge (int) | `ms` | `tcpcheck.endpoint` | Enabled by default; stability `development`. Recorded only when the TCP dial succeeds. |
| `tcpcheck.error` | Sum (cumulative, monotonic, int) | `{errors}` | `tcpcheck.endpoint`, `error.code` | Enabled by default; stability `development`. Recorded only when the TCP dial fails; `error.code` is one of `connection_refused`, `connection_timeout`, `invalid_endpoint`, `network_unreachable`, `unknown_error`, classified from the dial error string. |
| `tcpcheck.status` | Gauge (int) | `1` | `tcpcheck.endpoint` | Enabled by default; stability `development`. `1` on successful connect, `0` on failure. |

Each metric is emitted once per configured target per collection interval, and can be disabled via `metrics::<name>::enabled: false`.

## Sources

- `receiver/tcpcheckreceiver/metadata.yaml`
- `receiver/tcpcheckreceiver/scraper.go`
- `receiver/tcpcheckreceiver/config.go`
- `receiver/tcpcheckreceiver/factory.go`
- `receiver/tcpcheckreceiver/documentation.md`
- `receiver/tcpcheckreceiver/internal/metadata/generated_metrics.go`
- `receiver/tcpcheckreceiver/internal/metadata/generated_status.go`
        • v0.159.0.md 961 B 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/tcpcheckreceiver
version: v0.159.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/tcpcheckreceiver
commit_sha: 1120cc0714bf4d14600105e5673c3b00fe87467a
last_verified: 2026-10-14
---

# TCP Check Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| tcpcheck.duration | Gauge | ms | `tcpcheck.endpoint` | Emitted on successful TCP checks. |
| tcpcheck.error | Monotonic cumulative sum | {errors} | `tcpcheck.endpoint`, `error.code` | Emitted on failed checks; attributes are individually enabled through the metric's `enabled` attributes config. |
| tcpcheck.status | Gauge | 1 | `tcpcheck.endpoint` | 1 for successful connection, 0 for failure. |

## Sources

- `receiver/tcpcheckreceiver/metadata.yaml`
- `receiver/tcpcheckreceiver/scraper.go`
- `receiver/tcpcheckreceiver/internal/metadata/generated_metrics.go`
        • v0.160.0.md 1.5 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/tcpcheckreceiver
version: v0.160.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/tcpcheckreceiver
commit_sha: 982f20b8a8e8a2569fab3e27cf8b008e8a5080c1
last_verified: 2026-09-03
---

# TCP Check Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `tcpcheck.duration` | Gauge (int) | `ms` | `tcpcheck.endpoint` | Enabled by default; stability `development`. Recorded only when the TCP dial succeeds. |
| `tcpcheck.error` | Sum (cumulative, monotonic, int) | `{errors}` | `tcpcheck.endpoint`, `error.code` | Enabled by default; stability `development`. Recorded only when the TCP dial fails; `error.code` is one of `connection_refused`, `connection_timeout`, `invalid_endpoint`, `network_unreachable`, `unknown_error`, classified from the dial error string. |
| `tcpcheck.status` | Gauge (int) | `1` | `tcpcheck.endpoint` | Enabled by default; stability `development`. `1` on successful connect, `0` on failure. |

Each metric is emitted once per configured target per collection interval, and can be disabled via `metrics::<name>::enabled: false`.

## Sources

- `receiver/tcpcheckreceiver/metadata.yaml`
- `receiver/tcpcheckreceiver/scraper.go`
- `receiver/tcpcheckreceiver/config.go`
- `receiver/tcpcheckreceiver/factory.go`
- `receiver/tcpcheckreceiver/documentation.md`
- `receiver/tcpcheckreceiver/internal/metadata/generated_metrics.go`
- `receiver/tcpcheckreceiver/internal/metadata/generated_status.go`
        • v0.161.0.md 1.5 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/tcpcheckreceiver
version: v0.161.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/tcpcheckreceiver
commit_sha: 3f8455d8038a985398861171e5310bc9b4e988b2
last_verified: 2026-10-03
---

# TCP Check Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `tcpcheck.duration` | Gauge (int) | `ms` | `tcpcheck.endpoint` | Enabled by default; stability `development`. Recorded only when the TCP dial succeeds. |
| `tcpcheck.error` | Sum (cumulative, monotonic, int) | `{errors}` | `tcpcheck.endpoint`, `error.code` | Enabled by default; stability `development`. Recorded only when the TCP dial fails; `error.code` is one of `connection_refused`, `connection_timeout`, `invalid_endpoint`, `network_unreachable`, `unknown_error`, classified from the dial error string. |
| `tcpcheck.status` | Gauge (int) | `1` | `tcpcheck.endpoint` | Enabled by default; stability `development`. `1` on successful connect, `0` on failure. |

Each metric is emitted once per configured target per collection interval, and can be disabled via `metrics::<name>::enabled: false`.

## Sources

- `receiver/tcpcheckreceiver/metadata.yaml`
- `receiver/tcpcheckreceiver/scraper.go`
- `receiver/tcpcheckreceiver/config.go`
- `receiver/tcpcheckreceiver/factory.go`
- `receiver/tcpcheckreceiver/documentation.md`
- `receiver/tcpcheckreceiver/internal/metadata/generated_metrics.go`
- `receiver/tcpcheckreceiver/internal/metadata/generated_status.go`
        • v0.162.0.md 1.5 KB 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/tcpcheckreceiver
version: v0.162.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/tcpcheckreceiver
commit_sha: ae8c507510f48f433ab47dd1c6b01a59d6c388b5
last_verified: 2026-10-03
---

# TCP Check Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `tcpcheck.duration` | Gauge (int) | `ms` | `tcpcheck.endpoint` | Enabled by default; stability `alpha`. Recorded only when the TCP dial succeeds. |
| `tcpcheck.error` | Sum (cumulative, monotonic, int) | `{error}` | `tcpcheck.endpoint`, `error.code` | Enabled by default; stability `alpha`. Recorded only when the TCP dial fails; `error.code` is one of `connection_refused`, `connection_timeout`, `invalid_endpoint`, `network_unreachable`, `unknown_error`, classified from the dial error string. |
| `tcpcheck.status` | Gauge (int) | `1` | `tcpcheck.endpoint` | Enabled by default; stability `alpha`. `1` on successful connect, `0` on failure. |

Each metric is emitted once per configured target per collection interval, and can be disabled via `metrics::<name>::enabled: false`.

## Sources

- `receiver/tcpcheckreceiver/metadata.yaml`
- `receiver/tcpcheckreceiver/scraper.go`
- `receiver/tcpcheckreceiver/config.go`
- `receiver/tcpcheckreceiver/factory.go`
- `receiver/tcpcheckreceiver/documentation.md`
- `receiver/tcpcheckreceiver/internal/metadata/generated_metrics.go`
- `receiver/tcpcheckreceiver/internal/metadata/generated_status.go`
        • v0.163.0.md 960 B 
          ---
repo: open-telemetry/opentelemetry-collector-contrib
path: receiver/tcpcheckreceiver
version: v0.163.0
scope_name: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/tcpcheckreceiver
commit_sha: df849b5403c041d5e799e7846392a6f18b0b55ae
last_verified: 2026-10-14
---

# TCP Check Receiver

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| tcpcheck.duration | Gauge | ms | `tcpcheck.endpoint` | Emitted on successful TCP checks. |
| tcpcheck.error | Monotonic cumulative sum | {error} | `tcpcheck.endpoint`, `error.code` | Emitted on failed checks; attributes are individually enabled through the metric's `enabled` attributes config. |
| tcpcheck.status | Gauge | 1 | `tcpcheck.endpoint` | 1 for successful connection, 0 for failure. |

## Sources

- `receiver/tcpcheckreceiver/metadata.yaml`
- `receiver/tcpcheckreceiver/scraper.go`
- `receiver/tcpcheckreceiver/internal/metadata/generated_metrics.go`
  • opentelemetry-dotnet-contrib
    • src
      • OpenTelemetry.Instrumentation.AspNetCore
        • v1.15.1.md 1.8 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.AspNetCore
version: v1.15.1
scope_name: Microsoft.AspNetCore
commit_sha: 35de701f42db7142065a057f8ff51009caa7058d
last_verified: 2026-10-14
---

# ASP.NET Core Instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| Microsoft.AspNetCore.Hosting.HttpRequestIn | SERVER | http.request.method, http.request.method_original, http.response.status_code, http.route, url.scheme, url.path, url.query, server.address, server.port, network.protocol.version, network.peer.address, network.peer.port, user_agent.original, error.type; RPC status attributes for gRPC | Framework activity, or sibling/root activity when context extraction/new-root options require it; route/query/peer and exception attributes are conditional. RecordException enables exception events. Filter can suppress enrichment/export. |

## Metrics

The row below describes the package-owned request duration metric before .NET 8. On .NET 8+, `AddAspNetCoreInstrumentation` enables native ASP.NET Core meters, including additional framework-defined instruments; see the pinned package README for the framework telemetry boundary.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| http.server.request.duration | Histogram | s | http.request.method, http.response.status_code, http.route, url.scheme, network.protocol.version, error.type (when an exception was captured) | Recorded on request stop; route/status may be absent depending on request/framework data. |

## Sources

- `src/OpenTelemetry.Instrumentation.AspNetCore/README.md`

- src/OpenTelemetry.Instrumentation.AspNetCore/Implementation/HttpInListener.cs
- src/OpenTelemetry.Instrumentation.AspNetCore/Implementation/HttpInMetricsListener.cs
- src/OpenTelemetry.Instrumentation.AspNetCore/AspNetCoreInstrumentation.cs
        • v1.15.2.md 1.8 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.AspNetCore
version: v1.15.2
scope_name: Microsoft.AspNetCore
commit_sha: 96ef3bf6df7c93c59dce07fc0b0d2682d6797e76
last_verified: 2026-10-14
---

# ASP.NET Core Instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| Microsoft.AspNetCore.Hosting.HttpRequestIn | SERVER | http.request.method, http.request.method_original, http.response.status_code, http.route, url.scheme, url.path, url.query, server.address, server.port, network.protocol.version, network.peer.address, network.peer.port, user_agent.original, error.type; RPC status attributes for gRPC | Framework activity, or sibling/root activity when context extraction/new-root options require it; route/query/peer and exception attributes are conditional. RecordException enables exception events. Filter can suppress enrichment/export. |

## Metrics

The row below describes the package-owned request duration metric before .NET 8. On .NET 8+, `AddAspNetCoreInstrumentation` enables native ASP.NET Core meters, including additional framework-defined instruments; see the pinned package README for the framework telemetry boundary.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| http.server.request.duration | Histogram | s | http.request.method, http.response.status_code, http.route, url.scheme, network.protocol.version, error.type (when an exception was captured) | Recorded on request stop; route/status may be absent depending on request/framework data. |

## Sources

- `src/OpenTelemetry.Instrumentation.AspNetCore/README.md`

- src/OpenTelemetry.Instrumentation.AspNetCore/Implementation/HttpInListener.cs
- src/OpenTelemetry.Instrumentation.AspNetCore/Implementation/HttpInMetricsListener.cs
- src/OpenTelemetry.Instrumentation.AspNetCore/AspNetCoreInstrumentation.cs
        • v1.16.0.md 1.8 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.AspNetCore
version: v1.16.0
scope_name: Microsoft.AspNetCore
commit_sha: 61fd68a15de747c9accdd07273041b28ef454f99
last_verified: 2026-10-14
---

# ASP.NET Core Instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| Microsoft.AspNetCore.Hosting.HttpRequestIn | SERVER | http.request.method, http.request.method_original, http.response.status_code, http.route, url.scheme, url.path, url.query, server.address, server.port, network.protocol.version, network.peer.address, network.peer.port, user_agent.original, error.type; RPC status attributes for gRPC | Framework activity, or sibling/root activity when context extraction/new-root options require it; route/query/peer and exception attributes are conditional. RecordException enables exception events. Filter can suppress enrichment/export. |

## Metrics

The row below describes the package-owned request duration metric before .NET 8. On .NET 8+, `AddAspNetCoreInstrumentation` enables native ASP.NET Core meters, including additional framework-defined instruments; see the pinned package README for the framework telemetry boundary.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| http.server.request.duration | Histogram | s | http.request.method, http.response.status_code, http.route, url.scheme, network.protocol.version, error.type (when an exception was captured) | Recorded on request stop; route/status may be absent depending on request/framework data. |

## Sources

- `src/OpenTelemetry.Instrumentation.AspNetCore/README.md`

- src/OpenTelemetry.Instrumentation.AspNetCore/Implementation/HttpInListener.cs
- src/OpenTelemetry.Instrumentation.AspNetCore/Implementation/HttpInMetricsListener.cs
- src/OpenTelemetry.Instrumentation.AspNetCore/AspNetCoreInstrumentation.cs
        • v1.17.0.md 1.8 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.AspNetCore
version: v1.17.0
scope_name: Microsoft.AspNetCore
commit_sha: 3646636ba929d08b42bf20af02408eba9afc928d
last_verified: 2026-10-14
---

# ASP.NET Core Instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| Microsoft.AspNetCore.Hosting.HttpRequestIn | SERVER | http.request.method, http.request.method_original, http.response.status_code, http.route, url.scheme, url.path, url.query, server.address, server.port, network.protocol.version, network.peer.address, network.peer.port, user_agent.original, error.type; RPC status attributes for gRPC | Framework activity, or sibling/root activity when context extraction/new-root options require it; route/query/peer and exception attributes are conditional. RecordException enables exception events. Filter can suppress enrichment/export. |

## Metrics

The row below describes the package-owned request duration metric before .NET 8. On .NET 8+, `AddAspNetCoreInstrumentation` enables native ASP.NET Core meters, including additional framework-defined instruments; see the pinned package README for the framework telemetry boundary.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| http.server.request.duration | Histogram | s | http.request.method, http.response.status_code, http.route, url.scheme, network.protocol.version, error.type (when an exception was captured) | Recorded on request stop; route/status may be absent depending on request/framework data. |

## Sources

- `src/OpenTelemetry.Instrumentation.AspNetCore/README.md`

- src/OpenTelemetry.Instrumentation.AspNetCore/Implementation/HttpInListener.cs
- src/OpenTelemetry.Instrumentation.AspNetCore/Implementation/HttpInMetricsListener.cs
- src/OpenTelemetry.Instrumentation.AspNetCore/AspNetCoreInstrumentation.cs
        • v1.18.0.md 1.8 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.AspNetCore
version: v1.18.0
scope_name: Microsoft.AspNetCore
commit_sha: 58605ad9fe1a1044fe1e8b4d420806e9c9ba02c8
last_verified: 2026-10-14
---

# ASP.NET Core Instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| Microsoft.AspNetCore.Hosting.HttpRequestIn | SERVER | http.request.method, http.request.method_original, http.response.status_code, http.route, url.scheme, url.path, url.query, server.address, server.port, network.protocol.version, network.peer.address, network.peer.port, user_agent.original, error.type; RPC status attributes for gRPC | Framework activity, or sibling/root activity when context extraction/new-root options require it; route/query/peer and exception attributes are conditional. RecordException enables exception events. Filter can suppress enrichment/export. |

## Metrics

The row below describes the package-owned request duration metric before .NET 8. On .NET 8+, `AddAspNetCoreInstrumentation` enables native ASP.NET Core meters, including additional framework-defined instruments; see the pinned package README for the framework telemetry boundary.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| http.server.request.duration | Histogram | s | http.request.method, http.response.status_code, http.route, url.scheme, network.protocol.version, error.type (when an exception was captured) | Recorded on request stop; route/status may be absent depending on request/framework data. |

## Sources

- `src/OpenTelemetry.Instrumentation.AspNetCore/README.md`

- src/OpenTelemetry.Instrumentation.AspNetCore/Implementation/HttpInListener.cs
- src/OpenTelemetry.Instrumentation.AspNetCore/Implementation/HttpInMetricsListener.cs
- src/OpenTelemetry.Instrumentation.AspNetCore/AspNetCoreInstrumentation.cs
        • v1.19.0.md 1.9 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.AspNetCore
version: v1.19.0
scope_name: Microsoft.AspNetCore
commit_sha: dda21df71c8ccd247ab1051760b13f1db9353cfa
last_verified: 2026-10-14
---

# ASP.NET Core Instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| Microsoft.AspNetCore.Hosting.HttpRequestIn | SERVER | http.request.method, http.request.method_original, http.response.status_code, http.route, url.scheme, url.path, url.query, server.address, server.port, network.protocol.version, network.peer.address, network.peer.port, user_agent.original, error.type; RPC status attributes for gRPC | Framework activity, or sibling/root activity when context extraction/new-root options require it; route/query/peer and exception attributes are conditional. `RecordException` enables exception events. `Filter` can suppress enrichment/export. |

## Metrics

The row below describes the package-owned request duration metric before .NET 8. On .NET 8+, `AddAspNetCoreInstrumentation` enables native ASP.NET Core meters, including additional framework-defined instruments; see the pinned package README for the framework telemetry boundary.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| http.server.request.duration | Histogram | s | http.request.method, http.response.status_code, http.route, url.scheme, network.protocol.version, error.type (when an exception was captured) | Recorded on request stop; route/status may be absent depending on request/framework data. |

## Sources

- `src/OpenTelemetry.Instrumentation.AspNetCore/README.md`

- `src/OpenTelemetry.Instrumentation.AspNetCore/Implementation/HttpInListener.cs`
- `src/OpenTelemetry.Instrumentation.AspNetCore/Implementation/HttpInMetricsListener.cs`
- `src/OpenTelemetry.Instrumentation.AspNetCore/AspNetCoreInstrumentation.cs`
      • OpenTelemetry.Instrumentation.ConfluentKafka
        • v0.1.0-alpha.6.md 3 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.ConfluentKafka
version: v0.1.0-alpha.6
scope_name: OpenTelemetry.Instrumentation.ConfluentKafka
commit_sha: 39bfb6b5df17dc11afadeb72a6ab465024a538a0
last_verified: null
---

# Confluent Kafka instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| send | Producer | messaging.system, messaging.destination.name, messaging.client.id, messaging.operation.name, messaging.operation.type, messaging.kafka.destination.partition, messaging.kafka.message.key, error.type | Producer sends; nullable/dynamic attributes omitted when unavailable. |
| poll | Client | messaging.system, messaging.destination.name, messaging.client.id, messaging.consumer.group.name, messaging.destination.partition.id, messaging.operation.name, messaging.operation.type, messaging.kafka.offset, messaging.kafka.message.key, messaging.kafka.message.tombstone, error.type | Consumer poll; generated when a consumed record is available. |
| process | Consumer | messaging.system, messaging.destination.name, messaging.client.id, messaging.consumer.group.name, messaging.destination.partition.id, messaging.operation.name, messaging.operation.type, messaging.kafka.offset, messaging.kafka.message.key, messaging.kafka.message.tombstone, error.type | Consume-and-process helper; links message context. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| messaging.client.operation.duration | Histogram | s | messaging.system, messaging.destination.name, messaging.client.id, messaging.operation.name, messaging.operation.type, error.type | Metrics opt-in via instrumentation/builder Metrics or EnableMetrics option. |
| messaging.client.sent.messages | Counter | {message} | messaging.system, messaging.destination.name, messaging.client.id, messaging.operation.name, messaging.operation.type, error.type | Metrics opt-in via instrumentation/builder Metrics or EnableMetrics option. |
| messaging.client.consumed.messages | Counter | {message} | messaging.system, messaging.destination.name, messaging.client.id, messaging.consumer.group.name, messaging.destination.partition.id, messaging.operation.name, messaging.operation.type, error.type | Metrics opt-in via instrumentation/builder Metrics or EnableMetrics option. |

## Sources

- src/OpenTelemetry.Instrumentation.ConfluentKafka/ConfluentKafkaCommon.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/InstrumentedProducer.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/InstrumentedConsumer.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/OpenTelemetryConsumeResultExtensions.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/TracerProviderBuilderExtensions.Producer.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/TracerProviderBuilderExtensions.Consumer.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/MeterProviderBuilderExtensions.Producer.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/MeterProviderBuilderExtensions.Consumer.cs
        • v0.1.0-alpha.7.md 3 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.ConfluentKafka
version: v0.1.0-alpha.7
scope_name: OpenTelemetry.Instrumentation.ConfluentKafka
commit_sha: ba6461c9f346493f55f1da185997eb6fff14c76f
last_verified: null
---

# Confluent Kafka instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| send | Producer | messaging.system, messaging.destination.name, messaging.client.id, messaging.operation.name, messaging.operation.type, messaging.kafka.destination.partition, messaging.kafka.message.key, error.type | Producer sends; nullable/dynamic attributes omitted when unavailable. |
| poll | Client | messaging.system, messaging.destination.name, messaging.client.id, messaging.consumer.group.name, messaging.destination.partition.id, messaging.operation.name, messaging.operation.type, messaging.kafka.offset, messaging.kafka.message.key, messaging.kafka.message.tombstone, error.type | Consumer poll; generated when a consumed record is available. |
| process | Consumer | messaging.system, messaging.destination.name, messaging.client.id, messaging.consumer.group.name, messaging.destination.partition.id, messaging.operation.name, messaging.operation.type, messaging.kafka.offset, messaging.kafka.message.key, messaging.kafka.message.tombstone, error.type | Consume-and-process helper; links message context. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| messaging.client.operation.duration | Histogram | s | messaging.system, messaging.destination.name, messaging.client.id, messaging.operation.name, messaging.operation.type, error.type | Metrics opt-in via instrumentation/builder Metrics or EnableMetrics option. |
| messaging.client.sent.messages | Counter | {message} | messaging.system, messaging.destination.name, messaging.client.id, messaging.operation.name, messaging.operation.type, error.type | Metrics opt-in via instrumentation/builder Metrics or EnableMetrics option. |
| messaging.client.consumed.messages | Counter | {message} | messaging.system, messaging.destination.name, messaging.client.id, messaging.consumer.group.name, messaging.destination.partition.id, messaging.operation.name, messaging.operation.type, error.type | Metrics opt-in via instrumentation/builder Metrics or EnableMetrics option. |

## Sources

- src/OpenTelemetry.Instrumentation.ConfluentKafka/ConfluentKafkaCommon.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/InstrumentedProducer.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/InstrumentedConsumer.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/OpenTelemetryConsumeResultExtensions.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/TracerProviderBuilderExtensions.Producer.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/TracerProviderBuilderExtensions.Consumer.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/MeterProviderBuilderExtensions.Producer.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/MeterProviderBuilderExtensions.Consumer.cs
        • v0.2.0-alpha.1.md 3 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.ConfluentKafka
version: v0.2.0-alpha.1
scope_name: OpenTelemetry.Instrumentation.ConfluentKafka
commit_sha: 0299cdd7648c84ffe0c93385f51d27db5ea7527b
last_verified: null
---

# Confluent Kafka instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| send | Producer | messaging.system, messaging.destination.name, messaging.client.id, messaging.operation.name, messaging.operation.type, messaging.kafka.destination.partition, messaging.kafka.message.key, error.type | Producer sends; nullable/dynamic attributes omitted when unavailable. |
| poll | Client | messaging.system, messaging.destination.name, messaging.client.id, messaging.consumer.group.name, messaging.destination.partition.id, messaging.operation.name, messaging.operation.type, messaging.kafka.offset, messaging.kafka.message.key, messaging.kafka.message.tombstone, error.type | Consumer poll; generated when a consumed record is available. |
| process | Consumer | messaging.system, messaging.destination.name, messaging.client.id, messaging.consumer.group.name, messaging.destination.partition.id, messaging.operation.name, messaging.operation.type, messaging.kafka.offset, messaging.kafka.message.key, messaging.kafka.message.tombstone, error.type | Consume-and-process helper; links message context. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| messaging.client.operation.duration | Histogram | s | messaging.system, messaging.destination.name, messaging.client.id, messaging.operation.name, messaging.operation.type, error.type | Metrics opt-in via instrumentation/builder Metrics or EnableMetrics option. |
| messaging.client.sent.messages | Counter | {message} | messaging.system, messaging.destination.name, messaging.client.id, messaging.operation.name, messaging.operation.type, error.type | Metrics opt-in via instrumentation/builder Metrics or EnableMetrics option. |
| messaging.client.consumed.messages | Counter | {message} | messaging.system, messaging.destination.name, messaging.client.id, messaging.consumer.group.name, messaging.destination.partition.id, messaging.operation.name, messaging.operation.type, error.type | Metrics opt-in via instrumentation/builder Metrics or EnableMetrics option. |

## Sources

- src/OpenTelemetry.Instrumentation.ConfluentKafka/ConfluentKafkaCommon.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/InstrumentedProducer.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/InstrumentedConsumer.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/OpenTelemetryConsumeResultExtensions.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/TracerProviderBuilderExtensions.Producer.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/TracerProviderBuilderExtensions.Consumer.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/MeterProviderBuilderExtensions.Producer.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/MeterProviderBuilderExtensions.Consumer.cs
        • v0.2.0-alpha.2.md 3 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.ConfluentKafka
version: v0.2.0-alpha.2
scope_name: OpenTelemetry.Instrumentation.ConfluentKafka
commit_sha: 0dd592dca5a5b206629ae0c29477a0028f47d1fe
last_verified: null
---

# Confluent Kafka instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| send | Producer | messaging.system, messaging.destination.name, messaging.client.id, messaging.operation.name, messaging.operation.type, messaging.kafka.destination.partition, messaging.kafka.message.key, error.type | Producer sends; nullable/dynamic attributes omitted when unavailable. |
| poll | Client | messaging.system, messaging.destination.name, messaging.client.id, messaging.consumer.group.name, messaging.destination.partition.id, messaging.operation.name, messaging.operation.type, messaging.kafka.offset, messaging.kafka.message.key, messaging.kafka.message.tombstone, error.type | Consumer poll; generated when a consumed record is available. |
| process | Consumer | messaging.system, messaging.destination.name, messaging.client.id, messaging.consumer.group.name, messaging.destination.partition.id, messaging.operation.name, messaging.operation.type, messaging.kafka.offset, messaging.kafka.message.key, messaging.kafka.message.tombstone, error.type | Consume-and-process helper; links message context. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| messaging.client.operation.duration | Histogram | s | messaging.system, messaging.destination.name, messaging.client.id, messaging.operation.name, messaging.operation.type, error.type | Metrics opt-in via instrumentation/builder Metrics or EnableMetrics option. |
| messaging.client.sent.messages | Counter | {message} | messaging.system, messaging.destination.name, messaging.client.id, messaging.operation.name, messaging.operation.type, error.type | Metrics opt-in via instrumentation/builder Metrics or EnableMetrics option. |
| messaging.client.consumed.messages | Counter | {message} | messaging.system, messaging.destination.name, messaging.client.id, messaging.consumer.group.name, messaging.destination.partition.id, messaging.operation.name, messaging.operation.type, error.type | Metrics opt-in via instrumentation/builder Metrics or EnableMetrics option. |

## Sources

- src/OpenTelemetry.Instrumentation.ConfluentKafka/ConfluentKafkaCommon.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/InstrumentedProducer.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/InstrumentedConsumer.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/OpenTelemetryConsumeResultExtensions.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/TracerProviderBuilderExtensions.Producer.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/TracerProviderBuilderExtensions.Consumer.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/MeterProviderBuilderExtensions.Producer.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/MeterProviderBuilderExtensions.Consumer.cs
        • v0.3.0-alpha.1.md 3 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.ConfluentKafka
version: v0.3.0-alpha.1
scope_name: OpenTelemetry.Instrumentation.ConfluentKafka
commit_sha: 1df0046ddc8ec4373d48f3efc2fcf9f5f3faf4c9
last_verified: null
---

# Confluent Kafka instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| send | Producer | messaging.system, messaging.destination.name, messaging.client.id, messaging.operation.name, messaging.operation.type, messaging.kafka.destination.partition, messaging.kafka.message.key, error.type | Producer sends; nullable/dynamic attributes omitted when unavailable. |
| poll | Client | messaging.system, messaging.destination.name, messaging.client.id, messaging.consumer.group.name, messaging.destination.partition.id, messaging.operation.name, messaging.operation.type, messaging.kafka.offset, messaging.kafka.message.key, messaging.kafka.message.tombstone, error.type | Consumer poll; generated when a consumed record is available. |
| process | Consumer | messaging.system, messaging.destination.name, messaging.client.id, messaging.consumer.group.name, messaging.destination.partition.id, messaging.operation.name, messaging.operation.type, messaging.kafka.offset, messaging.kafka.message.key, messaging.kafka.message.tombstone, error.type | Consume-and-process helper; links message context. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| messaging.client.operation.duration | Histogram | s | messaging.system, messaging.destination.name, messaging.client.id, messaging.operation.name, messaging.operation.type, error.type | Metrics opt-in via instrumentation/builder Metrics or EnableMetrics option. |
| messaging.client.sent.messages | Counter | {message} | messaging.system, messaging.destination.name, messaging.client.id, messaging.operation.name, messaging.operation.type, error.type | Metrics opt-in via instrumentation/builder Metrics or EnableMetrics option. |
| messaging.client.consumed.messages | Counter | {message} | messaging.system, messaging.destination.name, messaging.client.id, messaging.consumer.group.name, messaging.destination.partition.id, messaging.operation.name, messaging.operation.type, error.type | Metrics opt-in via instrumentation/builder Metrics or EnableMetrics option. |

## Sources

- src/OpenTelemetry.Instrumentation.ConfluentKafka/ConfluentKafkaCommon.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/InstrumentedProducer.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/InstrumentedConsumer.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/OpenTelemetryConsumeResultExtensions.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/TracerProviderBuilderExtensions.Producer.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/TracerProviderBuilderExtensions.Consumer.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/MeterProviderBuilderExtensions.Producer.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/MeterProviderBuilderExtensions.Consumer.cs
        • v0.3.0-alpha.2.md 3 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.ConfluentKafka
version: v0.3.0-alpha.2
scope_name: OpenTelemetry.Instrumentation.ConfluentKafka
commit_sha: 6389a083a1f792b855ce751a2316c4063fb6f112
last_verified: null
---

# Confluent Kafka instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| send | Producer | messaging.system, messaging.destination.name, messaging.client.id, messaging.operation.name, messaging.operation.type, messaging.kafka.destination.partition, messaging.kafka.message.key, error.type | Producer sends; nullable/dynamic attributes omitted when unavailable. |
| poll | Client | messaging.system, messaging.destination.name, messaging.client.id, messaging.consumer.group.name, messaging.destination.partition.id, messaging.operation.name, messaging.operation.type, messaging.kafka.offset, messaging.kafka.message.key, messaging.kafka.message.tombstone, error.type | Consumer poll; generated when a consumed record is available. |
| process | Consumer | messaging.system, messaging.destination.name, messaging.client.id, messaging.consumer.group.name, messaging.destination.partition.id, messaging.operation.name, messaging.operation.type, messaging.kafka.offset, messaging.kafka.message.key, messaging.kafka.message.tombstone, error.type | Consume-and-process helper; links message context. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| messaging.client.operation.duration | Histogram | s | messaging.system, messaging.destination.name, messaging.client.id, messaging.operation.name, messaging.operation.type, error.type | Metrics opt-in via instrumentation/builder Metrics or EnableMetrics option. |
| messaging.client.sent.messages | Counter | {message} | messaging.system, messaging.destination.name, messaging.client.id, messaging.operation.name, messaging.operation.type, error.type | Metrics opt-in via instrumentation/builder Metrics or EnableMetrics option. |
| messaging.client.consumed.messages | Counter | {message} | messaging.system, messaging.destination.name, messaging.client.id, messaging.consumer.group.name, messaging.destination.partition.id, messaging.operation.name, messaging.operation.type, error.type | Metrics opt-in via instrumentation/builder Metrics or EnableMetrics option. |

## Sources

- src/OpenTelemetry.Instrumentation.ConfluentKafka/ConfluentKafkaCommon.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/InstrumentedProducer.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/InstrumentedConsumer.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/OpenTelemetryConsumeResultExtensions.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/TracerProviderBuilderExtensions.Producer.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/TracerProviderBuilderExtensions.Consumer.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/MeterProviderBuilderExtensions.Producer.cs
- src/OpenTelemetry.Instrumentation.ConfluentKafka/MeterProviderBuilderExtensions.Consumer.cs
      • OpenTelemetry.Instrumentation.EntityFrameworkCore
        • v1.15.1-beta.1.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.EntityFrameworkCore
version: v1.15.1-beta.1
scope_name: OpenTelemetry.Instrumentation.EntityFrameworkCore.EntityFrameworkDiagnosticListener
commit_sha: 5dfb07cac7c70b07ac745cebea3611a01c7b2c90
last_verified: 2026-06-10
---

# Entity Framework Core instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| OpenTelemetry.Instrumentation.EntityFrameworkCore.EntityFrameworkDiagnosticListener.Execute | CLIENT | `db.system` / `db.system.name`, `db.name` / `db.namespace`, `peer.service` / `server.address`, `server.port`, `db.statement` / `db.query.text`, `db.query.summary`, `db.operation.name`, `db.stored_procedure.name`; optionally `db.query.parameter.{key}`; custom `ef.provider`; user enrichment tags | `OTEL_SEMCONV_STABILITY_OPT_IN` selects old (`database`, default), new (`database`), or both (`database/dup`) attributes. `server.port` requires new attributes. Query text and operation attributes depend on command type; query parameters require `OTEL_DOTNET_EXPERIMENTAL_EFCORE_ENABLE_TRACE_DB_QUERY_PARAMETERS=true`. `Filter` can suppress collection. Exceptions set span status to ERROR. |

## Sources

- `src/OpenTelemetry.Instrumentation.EntityFrameworkCore/Implementation/EntityFrameworkDiagnosticListener.cs`
- `src/OpenTelemetry.Instrumentation.EntityFrameworkCore/EntityFrameworkInstrumentationOptions.cs`
- `src/Shared/DatabaseSemanticConventionHelper.cs`
- `src/Shared/SqlParameterProcessor.cs`
- `src/OpenTelemetry.Instrumentation.EntityFrameworkCore/TracerProviderBuilderExtensions.cs`
        • v1.16.0-beta.1.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.EntityFrameworkCore
version: v1.16.0-beta.1
scope_name: OpenTelemetry.Instrumentation.EntityFrameworkCore.EntityFrameworkDiagnosticListener
commit_sha: cf93a30270e7a7f1864136e113afff15aeb88314
last_verified: null
---

# Entity Framework Core instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| OpenTelemetry.Instrumentation.EntityFrameworkCore.EntityFrameworkDiagnosticListener.Execute | CLIENT | `db.system` / `db.system.name`, `db.name` / `db.namespace`, `peer.service` / `server.address`, `server.port`, `db.statement` / `db.query.text`, `db.query.summary`, `db.operation.name`, `db.stored_procedure.name`; optionally `db.query.parameter.{key}`; custom `ef.provider`; user enrichment tags | `OTEL_SEMCONV_STABILITY_OPT_IN` selects old (`database`, default), new (`database`), or both (`database/dup`) attributes. `server.port` requires new attributes. Query text and operation attributes depend on command type; query parameters require `OTEL_DOTNET_EXPERIMENTAL_EFCORE_ENABLE_TRACE_DB_QUERY_PARAMETERS=true`. `Filter` can suppress collection. Exceptions set span status to ERROR. |

## Sources

- `src/OpenTelemetry.Instrumentation.EntityFrameworkCore/Implementation/EntityFrameworkDiagnosticListener.cs`
- `src/OpenTelemetry.Instrumentation.EntityFrameworkCore/EntityFrameworkInstrumentationOptions.cs`
- `src/Shared/DatabaseSemanticConventionHelper.cs`
- `src/Shared/SqlParameterProcessor.cs`
- `src/OpenTelemetry.Instrumentation.EntityFrameworkCore/TracerProviderBuilderExtensions.cs`
        • v1.17.0-beta.1.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.EntityFrameworkCore
version: v1.17.0-beta.1
scope_name: OpenTelemetry.Instrumentation.EntityFrameworkCore.EntityFrameworkDiagnosticListener
commit_sha: 5164fec68e194d6aff28aaa61f537aee62b16ca5
last_verified: null
---

# Entity Framework Core instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| OpenTelemetry.Instrumentation.EntityFrameworkCore.EntityFrameworkDiagnosticListener.Execute | CLIENT | `db.system` / `db.system.name`, `db.name` / `db.namespace`, `peer.service` / `server.address`, `server.port`, `db.statement` / `db.query.text`, `db.query.summary`, `db.operation.name`, `db.stored_procedure.name`; optionally `db.query.parameter.{key}`; custom `ef.provider`; user enrichment tags | `OTEL_SEMCONV_STABILITY_OPT_IN` selects old (`database`, default), new (`database`), or both (`database/dup`) attributes. `server.port` requires new attributes. Query text and operation attributes depend on command type; query parameters require `OTEL_DOTNET_EXPERIMENTAL_EFCORE_ENABLE_TRACE_DB_QUERY_PARAMETERS=true`. `Filter` can suppress collection. Exceptions set span status to ERROR. |

## Sources

- `src/OpenTelemetry.Instrumentation.EntityFrameworkCore/Implementation/EntityFrameworkDiagnosticListener.cs`
- `src/OpenTelemetry.Instrumentation.EntityFrameworkCore/EntityFrameworkInstrumentationOptions.cs`
- `src/Shared/DatabaseSemanticConventionHelper.cs`
- `src/Shared/SqlParameterProcessor.cs`
- `src/OpenTelemetry.Instrumentation.EntityFrameworkCore/TracerProviderBuilderExtensions.cs`
        • v1.18.0-beta.1.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.EntityFrameworkCore
version: v1.18.0-beta.1
scope_name: OpenTelemetry.Instrumentation.EntityFrameworkCore.EntityFrameworkDiagnosticListener
commit_sha: c3273f64a153f845e859bfa64bac8f8a660eb9b9
last_verified: null
---

# Entity Framework Core instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| OpenTelemetry.Instrumentation.EntityFrameworkCore.EntityFrameworkDiagnosticListener.Execute | CLIENT | `db.system` / `db.system.name`, `db.name` / `db.namespace`, `peer.service` / `server.address`, `server.port`, `db.statement` / `db.query.text`, `db.query.summary`, `db.operation.name`, `db.stored_procedure.name`; optionally `db.query.parameter.{key}`; custom `ef.provider`; user enrichment tags | `OTEL_SEMCONV_STABILITY_OPT_IN` selects old (`database`, default), new (`database`), or both (`database/dup`) attributes. `server.port` requires new attributes. Query text and operation attributes depend on command type; query parameters require `OTEL_DOTNET_EXPERIMENTAL_EFCORE_ENABLE_TRACE_DB_QUERY_PARAMETERS=true`. `Filter` can suppress collection. Exceptions set span status to ERROR. |

## Sources

- `src/OpenTelemetry.Instrumentation.EntityFrameworkCore/Implementation/EntityFrameworkDiagnosticListener.cs`
- `src/OpenTelemetry.Instrumentation.EntityFrameworkCore/EntityFrameworkInstrumentationOptions.cs`
- `src/Shared/DatabaseSemanticConventionHelper.cs`
- `src/Shared/SqlParameterProcessor.cs`
- `src/OpenTelemetry.Instrumentation.EntityFrameworkCore/TracerProviderBuilderExtensions.cs`
        • v1.19.0-beta.1.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.EntityFrameworkCore
version: v1.19.0-beta.1
scope_name: OpenTelemetry.Instrumentation.EntityFrameworkCore.EntityFrameworkDiagnosticListener
commit_sha: 4f0c34f7d05707b8c8d5ee83aced99f224e91f48
last_verified: null
---

# Entity Framework Core instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| OpenTelemetry.Instrumentation.EntityFrameworkCore.EntityFrameworkDiagnosticListener.Execute | CLIENT | `db.system` / `db.system.name`, `db.name` / `db.namespace`, `peer.service` / `server.address`, `server.port`, `db.statement` / `db.query.text`, `db.query.summary`, `db.operation.name`, `db.stored_procedure.name`; optionally `db.query.parameter.{key}`; custom `ef.provider`; user enrichment tags | `OTEL_SEMCONV_STABILITY_OPT_IN` selects old (`database`, default), new (`database`), or both (`database/dup`) attributes. `server.port` requires new attributes. Query text and operation attributes depend on command type; query parameters require `OTEL_DOTNET_EXPERIMENTAL_EFCORE_ENABLE_TRACE_DB_QUERY_PARAMETERS=true`. `Filter` can suppress collection. Exceptions set span status to ERROR. |

## Sources

- `src/OpenTelemetry.Instrumentation.EntityFrameworkCore/Implementation/EntityFrameworkDiagnosticListener.cs`
- `src/OpenTelemetry.Instrumentation.EntityFrameworkCore/EntityFrameworkInstrumentationOptions.cs`
- `src/Shared/DatabaseSemanticConventionHelper.cs`
- `src/Shared/SqlParameterProcessor.cs`
- `src/OpenTelemetry.Instrumentation.EntityFrameworkCore/TracerProviderBuilderExtensions.cs`
        • v1.19.1-beta.1.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.EntityFrameworkCore
version: v1.19.1-beta.1
scope_name: OpenTelemetry.Instrumentation.EntityFrameworkCore.EntityFrameworkDiagnosticListener
commit_sha: 2c9111f07e6238139ddea9991bae1a4f9baba4bc
last_verified: null
---

# Entity Framework Core instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| OpenTelemetry.Instrumentation.EntityFrameworkCore.EntityFrameworkDiagnosticListener.Execute | CLIENT | `db.system` / `db.system.name`, `db.name` / `db.namespace`, `peer.service` / `server.address`, `server.port`, `db.statement` / `db.query.text`, `db.query.summary`, `db.operation.name`, `db.stored_procedure.name`; optionally `db.query.parameter.{key}`; custom `ef.provider`; user enrichment tags | `OTEL_SEMCONV_STABILITY_OPT_IN` selects old (`database`, default), new (`database`), or both (`database/dup`) attributes. `server.port` requires new attributes. Query text and operation attributes depend on command type; query parameters require `OTEL_DOTNET_EXPERIMENTAL_EFCORE_ENABLE_TRACE_DB_QUERY_PARAMETERS=true`. `Filter` can suppress collection. Exceptions set span status to ERROR. |

## Sources

- `src/OpenTelemetry.Instrumentation.EntityFrameworkCore/Implementation/EntityFrameworkDiagnosticListener.cs`
- `src/OpenTelemetry.Instrumentation.EntityFrameworkCore/EntityFrameworkInstrumentationOptions.cs`
- `src/Shared/DatabaseSemanticConventionHelper.cs`
- `src/Shared/SqlParameterProcessor.cs`
- `src/OpenTelemetry.Instrumentation.EntityFrameworkCore/TracerProviderBuilderExtensions.cs`
      • OpenTelemetry.Instrumentation.GrpcNetClient
        • v1.15.1-beta.1.md 1 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.GrpcNetClient
version: v1.15.1-beta.1
scope_name: OpenTelemetry.Instrumentation.GrpcNetClient
commit_sha: f2cafeb888a9ed7cc3cc6c71cf14f95c3e0e3e69
last_verified: 2026-10-02
---

# GrpcNetClient instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| gRPC method (activity operation name) | CLIENT | rpc.system=grpc; rpc.service; rpc.method; server.address; server.port; network.peer.address and network.peer.port for IP hosts; rpc.grpc.status_code | Existing Grpc.Net.Client activity enriched when sampled and event filter accepts request; optional request/response enrichment callbacks. |

## Sources

- `src/OpenTelemetry.Instrumentation.GrpcNetClient/Implementation/GrpcClientDiagnosticListener.cs`
- `src/OpenTelemetry.Instrumentation.GrpcNetClient/GrpcClientTraceInstrumentationOptions.cs`
- `src/OpenTelemetry.Instrumentation.GrpcNetClient/Implementation/GrpcInstrumentationEventSource.cs`
        • v1.16.0-beta.1.md 1 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.GrpcNetClient
version: v1.16.0-beta.1
scope_name: OpenTelemetry.Instrumentation.GrpcNetClient
commit_sha: ccb70116f430f7add50e952c056787cf8897e697
last_verified: 2026-10-02
---

# GrpcNetClient instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| gRPC method (activity operation name) | CLIENT | rpc.system=grpc; rpc.service; rpc.method; server.address; server.port; network.peer.address and network.peer.port for IP hosts; rpc.grpc.status_code | Existing Grpc.Net.Client activity enriched when sampled and event filter accepts request; optional request/response enrichment callbacks. |

## Sources

- `src/OpenTelemetry.Instrumentation.GrpcNetClient/Implementation/GrpcClientDiagnosticListener.cs`
- `src/OpenTelemetry.Instrumentation.GrpcNetClient/GrpcClientTraceInstrumentationOptions.cs`
- `src/OpenTelemetry.Instrumentation.GrpcNetClient/Implementation/GrpcInstrumentationEventSource.cs`
        • v1.17.0-beta.1.md 1 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.GrpcNetClient
version: v1.17.0-beta.1
scope_name: OpenTelemetry.Instrumentation.GrpcNetClient
commit_sha: 5a6e94662f3937435870a5a80bd3c002e15dbda0
last_verified: 2026-10-02
---

# GrpcNetClient instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| gRPC method (activity operation name) | CLIENT | rpc.system=grpc; rpc.method; server.address; server.port; network.peer.address and network.peer.port for IP hosts; rpc.response.status_code; error.type on error | Existing Grpc.Net.Client activity enriched when sampled and event filter accepts request; optional request/response enrichment callbacks. |

## Sources

- `src/OpenTelemetry.Instrumentation.GrpcNetClient/Implementation/GrpcClientDiagnosticListener.cs`
- `src/OpenTelemetry.Instrumentation.GrpcNetClient/GrpcClientTraceInstrumentationOptions.cs`
- `src/OpenTelemetry.Instrumentation.GrpcNetClient/Implementation/GrpcInstrumentationEventSource.cs`
        • v1.18.0-beta.1.md 1 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.GrpcNetClient
version: v1.18.0-beta.1
scope_name: OpenTelemetry.Instrumentation.GrpcNetClient
commit_sha: ae142a92ace30fb96d139a52c0275a060860162c
last_verified: 2026-10-02
---

# GrpcNetClient instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| gRPC method (activity operation name) | CLIENT | rpc.system=grpc; rpc.method; server.address; server.port; network.peer.address and network.peer.port for IP hosts; rpc.response.status_code; error.type on error | Existing Grpc.Net.Client activity enriched when sampled and event filter accepts request; optional request/response enrichment callbacks. |

## Sources

- `src/OpenTelemetry.Instrumentation.GrpcNetClient/Implementation/GrpcClientDiagnosticListener.cs`
- `src/OpenTelemetry.Instrumentation.GrpcNetClient/GrpcClientTraceInstrumentationOptions.cs`
- `src/OpenTelemetry.Instrumentation.GrpcNetClient/Implementation/GrpcInstrumentationEventSource.cs`
        • v1.19.0-beta.1.md 1 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.GrpcNetClient
version: v1.19.0-beta.1
scope_name: OpenTelemetry.Instrumentation.GrpcNetClient
commit_sha: 1925c5c4053104a7f169e7d6eef490046546027c
last_verified: 2026-10-02
---

# GrpcNetClient instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| gRPC method (activity operation name) | CLIENT | rpc.system=grpc; rpc.method; server.address; server.port; network.peer.address and network.peer.port for IP hosts; rpc.response.status_code; error.type on error | Existing Grpc.Net.Client activity enriched when sampled and event filter accepts request; optional request/response enrichment callbacks. |

## Sources

- `src/OpenTelemetry.Instrumentation.GrpcNetClient/Implementation/GrpcClientDiagnosticListener.cs`
- `src/OpenTelemetry.Instrumentation.GrpcNetClient/GrpcClientTraceInstrumentationOptions.cs`
- `src/OpenTelemetry.Instrumentation.GrpcNetClient/Implementation/GrpcInstrumentationEventSource.cs`
        • v1.19.1-beta.1.md 1 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.GrpcNetClient
version: v1.19.1-beta.1
scope_name: OpenTelemetry.Instrumentation.GrpcNetClient
commit_sha: 3aa64b95a71734759da0ea169165be793bceb3c9
last_verified: 2026-10-02
---

# GrpcNetClient instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| gRPC method (activity operation name) | CLIENT | rpc.system=grpc; rpc.method; server.address; server.port; network.peer.address and network.peer.port for IP hosts; rpc.response.status_code; error.type on error | Existing Grpc.Net.Client activity enriched when sampled and event filter accepts request; optional request/response enrichment callbacks. |

## Sources

- `src/OpenTelemetry.Instrumentation.GrpcNetClient/Implementation/GrpcClientDiagnosticListener.cs`
- `src/OpenTelemetry.Instrumentation.GrpcNetClient/GrpcClientTraceInstrumentationOptions.cs`
- `src/OpenTelemetry.Instrumentation.GrpcNetClient/Implementation/GrpcInstrumentationEventSource.cs`
      • OpenTelemetry.Instrumentation.Http
        • v1.19.0.md 2.3 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.Http
version: v1.19.0
scope_name: OpenTelemetry.Instrumentation.Http.HttpClient (older .NET), System.Net.Http (.NET 7+ traces and .NET 8+ metrics), System.Net.NameResolution (.NET 8+ metrics)
commit_sha: 295327c4352523fbc4f4c8b182f09ae8794cc65e
last_verified: 2026-10-14
---

# HttpClient instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| HTTP method (or `HTTP` for an unrecognized method) | CLIENT | http.request.method, http.request.method_original (when normalized), server.address, server.port, url.full, network.protocol.version, http.response.status_code, error.type | Attributes shown are populated by package enrichment before .NET 9; .NET 9+ supplies native trace attributes. `RecordException` adds an exception event; URL query redaction can be disabled by `DisableUrlQueryRedaction` or `OTEL_DOTNET_EXPERIMENTAL_HTTPCLIENT_DISABLE_URL_QUERY_REDACTION`. |

## Metrics

The row below describes the package-owned duration metric on .NET Framework, .NET 6, and .NET 7. On .NET 8+, `AddHttpClientInstrumentation` subscribes to the native `System.Net.Http` and `System.Net.NameResolution` meters, including additional runtime-defined instruments; consult the pinned package README and the installed runtime documentation for those emissions.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| http.client.request.duration | Histogram | s | http.request.method, server.address, url.scheme, server.port, network.protocol.version, http.response.status_code, error.type | HTTP client metrics instrumentation enabled; response/error attributes only when available. |

## Sources

- `src/OpenTelemetry.Instrumentation.Http/README.md`
- `src/Shared/RequestDataHelper.cs`

- `src/OpenTelemetry.Instrumentation.Http/Implementation/HttpHandlerDiagnosticListener.cs`
- `src/OpenTelemetry.Instrumentation.Http/Implementation/HttpHandlerMetricsDiagnosticListener.cs`
- `src/OpenTelemetry.Instrumentation.Http/Implementation/HttpWebRequestActivitySource.netfx.cs`
- `src/OpenTelemetry.Instrumentation.Http/HttpClientTraceInstrumentationOptions.cs`
- `src/OpenTelemetry.Instrumentation.Http/HttpClientInstrumentationTracerProviderBuilderExtensions.cs`
- `src/OpenTelemetry.Instrumentation.Http/HttpClientInstrumentationMeterProviderBuilderExtensions.cs`
      • OpenTelemetry.Instrumentation.Runtime
        • v1.15.0.md 2.5 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.Runtime
version: v1.15.0
scope_name: OpenTelemetry.Instrumentation.Runtime (before .NET 9), System.Runtime (.NET 9+)
commit_sha: c2eebbab1bfb073568db270bea38d5824fa23176
last_verified: 2026-10-14
---

# OpenTelemetry .NET Runtime Instrumentation

## Metrics

The table below describes the package-owned metrics used before .NET 9. On .NET 9+, `AddRuntimeInstrumentation` subscribes to the native `System.Runtime` meter and does not instantiate `RuntimeMetrics`; the metric names and attributes come from the installed runtime. See the pinned package README for that runtime telemetry boundary.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `process.runtime.dotnet.exceptions.count` | Counter | {exception} | - | First-chance managed exceptions; emitted after at least one exception since initialization. |
| `process.runtime.dotnet.gc.collections.count` | Counter | {collection} | generation | - |
| `process.runtime.dotnet.gc.objects.size` | UpDownCounter | bytes | - | - |
| `process.runtime.dotnet.gc.allocations.size` | Counter | bytes | - | - |
| `process.runtime.dotnet.gc.committed_memory.size` | UpDownCounter | bytes | - | Value unavailable until a GC has occurred. |
| `process.runtime.dotnet.gc.heap.size` | UpDownCounter | bytes | generation | Value unavailable until a GC has occurred. |
| `process.runtime.dotnet.gc.heap.fragmentation.size` | UpDownCounter | bytes | generation | Value unavailable until a GC has occurred. |
| `process.runtime.dotnet.gc.duration` | Counter | ns | - | - |
| `process.runtime.dotnet.jit.il_compiled.size` | Counter | bytes | - | - |
| `process.runtime.dotnet.jit.methods_compiled.count` | Counter | {method} | - | - |
| `process.runtime.dotnet.jit.compilation_time` | Counter | ns | - | - |
| `process.runtime.dotnet.monitor.lock_contention.count` | Counter | {count} | - | - |
| `process.runtime.dotnet.thread_pool.threads.count` | UpDownCounter | {thread} | - | - |
| `process.runtime.dotnet.thread_pool.completed_items.count` | Counter | {item} | - | - |
| `process.runtime.dotnet.thread_pool.queue.length` | UpDownCounter | {item} | - | - |
| `process.runtime.dotnet.timer.count` | UpDownCounter | {timer} | - | - |
| `process.runtime.dotnet.assemblies.count` | UpDownCounter | {assembly} | - | - |

## Sources

- `src/OpenTelemetry.Instrumentation.Runtime/README.md`

- `src/OpenTelemetry.Instrumentation.Runtime/RuntimeMetrics.cs`
- `src/OpenTelemetry.Instrumentation.Runtime/MeterProviderBuilderExtensions.cs`
        • v1.15.1.md 2.5 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.Runtime
version: v1.15.1
scope_name: OpenTelemetry.Instrumentation.Runtime (before .NET 9), System.Runtime (.NET 9+)
commit_sha: b89c765905dbc6db1421ff0a098127d44665c71f
last_verified: 2026-10-14
---

# OpenTelemetry .NET Runtime Instrumentation

## Metrics

The table below describes the package-owned metrics used before .NET 9. On .NET 9+, `AddRuntimeInstrumentation` subscribes to the native `System.Runtime` meter and does not instantiate `RuntimeMetrics`; the metric names and attributes come from the installed runtime. See the pinned package README for that runtime telemetry boundary.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `process.runtime.dotnet.exceptions.count` | Counter | {exception} | - | First-chance managed exceptions; emitted after at least one exception since initialization. |
| `process.runtime.dotnet.gc.collections.count` | Counter | {collection} | generation | - |
| `process.runtime.dotnet.gc.objects.size` | UpDownCounter | bytes | - | - |
| `process.runtime.dotnet.gc.allocations.size` | Counter | bytes | - | - |
| `process.runtime.dotnet.gc.committed_memory.size` | UpDownCounter | bytes | - | Value unavailable until a GC has occurred. |
| `process.runtime.dotnet.gc.heap.size` | UpDownCounter | bytes | generation | Value unavailable until a GC has occurred. |
| `process.runtime.dotnet.gc.heap.fragmentation.size` | UpDownCounter | bytes | generation | Value unavailable until a GC has occurred. |
| `process.runtime.dotnet.gc.duration` | Counter | ns | - | - |
| `process.runtime.dotnet.jit.il_compiled.size` | Counter | bytes | - | - |
| `process.runtime.dotnet.jit.methods_compiled.count` | Counter | {method} | - | - |
| `process.runtime.dotnet.jit.compilation_time` | Counter | ns | - | - |
| `process.runtime.dotnet.monitor.lock_contention.count` | Counter | {count} | - | - |
| `process.runtime.dotnet.thread_pool.threads.count` | UpDownCounter | {thread} | - | - |
| `process.runtime.dotnet.thread_pool.completed_items.count` | Counter | {item} | - | - |
| `process.runtime.dotnet.thread_pool.queue.length` | UpDownCounter | {item} | - | - |
| `process.runtime.dotnet.timer.count` | UpDownCounter | {timer} | - | - |
| `process.runtime.dotnet.assemblies.count` | UpDownCounter | {assembly} | - | - |

## Sources

- `src/OpenTelemetry.Instrumentation.Runtime/README.md`

- `src/OpenTelemetry.Instrumentation.Runtime/RuntimeMetrics.cs`
- `src/OpenTelemetry.Instrumentation.Runtime/MeterProviderBuilderExtensions.cs`
        • v1.16.0.md 2.5 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.Runtime
version: v1.16.0
scope_name: OpenTelemetry.Instrumentation.Runtime (before .NET 9), System.Runtime (.NET 9+)
commit_sha: 903a7ad07fffe9ed7f7c29388123ff8b7cf7b369
last_verified: 2026-10-14
---

# OpenTelemetry .NET Runtime Instrumentation

## Metrics

The table below describes the package-owned metrics used before .NET 9. On .NET 9+, `AddRuntimeInstrumentation` subscribes to the native `System.Runtime` meter and does not instantiate `RuntimeMetrics`; the metric names and attributes come from the installed runtime. See the pinned package README for that runtime telemetry boundary.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `process.runtime.dotnet.exceptions.count` | Counter | {exception} | - | First-chance managed exceptions; emitted after at least one exception since initialization. |
| `process.runtime.dotnet.gc.collections.count` | Counter | {collection} | generation | - |
| `process.runtime.dotnet.gc.objects.size` | UpDownCounter | bytes | - | - |
| `process.runtime.dotnet.gc.allocations.size` | Counter | bytes | - | - |
| `process.runtime.dotnet.gc.committed_memory.size` | UpDownCounter | bytes | - | Value unavailable until a GC has occurred. |
| `process.runtime.dotnet.gc.heap.size` | UpDownCounter | bytes | generation | Value unavailable until a GC has occurred. |
| `process.runtime.dotnet.gc.heap.fragmentation.size` | UpDownCounter | bytes | generation | Value unavailable until a GC has occurred. |
| `process.runtime.dotnet.gc.duration` | Counter | ns | - | - |
| `process.runtime.dotnet.jit.il_compiled.size` | Counter | bytes | - | - |
| `process.runtime.dotnet.jit.methods_compiled.count` | Counter | {method} | - | - |
| `process.runtime.dotnet.jit.compilation_time` | Counter | ns | - | - |
| `process.runtime.dotnet.monitor.lock_contention.count` | Counter | {count} | - | - |
| `process.runtime.dotnet.thread_pool.threads.count` | UpDownCounter | {thread} | - | - |
| `process.runtime.dotnet.thread_pool.completed_items.count` | Counter | {item} | - | - |
| `process.runtime.dotnet.thread_pool.queue.length` | UpDownCounter | {item} | - | - |
| `process.runtime.dotnet.timer.count` | UpDownCounter | {timer} | - | - |
| `process.runtime.dotnet.assemblies.count` | UpDownCounter | {assembly} | - | - |

## Sources

- `src/OpenTelemetry.Instrumentation.Runtime/README.md`

- `src/OpenTelemetry.Instrumentation.Runtime/RuntimeMetrics.cs`
- `src/OpenTelemetry.Instrumentation.Runtime/MeterProviderBuilderExtensions.cs`
        • v1.17.0.md 2.5 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.Runtime
version: v1.17.0
scope_name: OpenTelemetry.Instrumentation.Runtime (before .NET 9), System.Runtime (.NET 9+)
commit_sha: b168b28c759e901b16fd6b43f98a5a628c6c4dc2
last_verified: 2026-10-14
---

# OpenTelemetry .NET Runtime Instrumentation

## Metrics

The table below describes the package-owned metrics used before .NET 9. On .NET 9+, `AddRuntimeInstrumentation` subscribes to the native `System.Runtime` meter and does not instantiate `RuntimeMetrics`; the metric names and attributes come from the installed runtime. See the pinned package README for that runtime telemetry boundary.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `process.runtime.dotnet.exceptions.count` | Counter | {exception} | - | First-chance managed exceptions; emitted after at least one exception since initialization. |
| `process.runtime.dotnet.gc.collections.count` | Counter | {collection} | generation | - |
| `process.runtime.dotnet.gc.objects.size` | UpDownCounter | bytes | - | - |
| `process.runtime.dotnet.gc.allocations.size` | Counter | bytes | - | - |
| `process.runtime.dotnet.gc.committed_memory.size` | UpDownCounter | bytes | - | Value unavailable until a GC has occurred. |
| `process.runtime.dotnet.gc.heap.size` | UpDownCounter | bytes | generation | Value unavailable until a GC has occurred. |
| `process.runtime.dotnet.gc.heap.fragmentation.size` | UpDownCounter | bytes | generation | Value unavailable until a GC has occurred. |
| `process.runtime.dotnet.gc.duration` | Counter | ns | - | - |
| `process.runtime.dotnet.jit.il_compiled.size` | Counter | bytes | - | - |
| `process.runtime.dotnet.jit.methods_compiled.count` | Counter | {method} | - | - |
| `process.runtime.dotnet.jit.compilation_time` | Counter | ns | - | - |
| `process.runtime.dotnet.monitor.lock_contention.count` | Counter | {count} | - | - |
| `process.runtime.dotnet.thread_pool.threads.count` | UpDownCounter | {thread} | - | - |
| `process.runtime.dotnet.thread_pool.completed_items.count` | Counter | {item} | - | - |
| `process.runtime.dotnet.thread_pool.queue.length` | UpDownCounter | {item} | - | - |
| `process.runtime.dotnet.timer.count` | UpDownCounter | {timer} | - | - |
| `process.runtime.dotnet.assemblies.count` | UpDownCounter | {assembly} | - | - |

## Sources

- `src/OpenTelemetry.Instrumentation.Runtime/README.md`

- `src/OpenTelemetry.Instrumentation.Runtime/RuntimeMetrics.cs`
- `src/OpenTelemetry.Instrumentation.Runtime/MeterProviderBuilderExtensions.cs`
        • v1.18.0.md 2.5 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.Runtime
version: v1.18.0
scope_name: OpenTelemetry.Instrumentation.Runtime (before .NET 9), System.Runtime (.NET 9+)
commit_sha: 955f0f7c984d9267a27d00f2fab74765d48cb9c6
last_verified: 2026-10-14
---

# OpenTelemetry .NET Runtime Instrumentation

## Metrics

The table below describes the package-owned metrics used before .NET 9. On .NET 9+, `AddRuntimeInstrumentation` subscribes to the native `System.Runtime` meter and does not instantiate `RuntimeMetrics`; the metric names and attributes come from the installed runtime. See the pinned package README for that runtime telemetry boundary.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `process.runtime.dotnet.exceptions.count` | Counter | {exception} | - | First-chance managed exceptions; emitted after at least one exception since initialization. |
| `process.runtime.dotnet.gc.collections.count` | Counter | {collection} | generation | - |
| `process.runtime.dotnet.gc.objects.size` | UpDownCounter | bytes | - | - |
| `process.runtime.dotnet.gc.allocations.size` | Counter | bytes | - | - |
| `process.runtime.dotnet.gc.committed_memory.size` | UpDownCounter | bytes | - | Value unavailable until a GC has occurred. |
| `process.runtime.dotnet.gc.heap.size` | UpDownCounter | bytes | generation | Value unavailable until a GC has occurred. |
| `process.runtime.dotnet.gc.heap.fragmentation.size` | UpDownCounter | bytes | generation | Value unavailable until a GC has occurred. |
| `process.runtime.dotnet.gc.duration` | Counter | ns | - | - |
| `process.runtime.dotnet.jit.il_compiled.size` | Counter | bytes | - | - |
| `process.runtime.dotnet.jit.methods_compiled.count` | Counter | {method} | - | - |
| `process.runtime.dotnet.jit.compilation_time` | Counter | ns | - | - |
| `process.runtime.dotnet.monitor.lock_contention.count` | Counter | {count} | - | - |
| `process.runtime.dotnet.thread_pool.threads.count` | UpDownCounter | {thread} | - | - |
| `process.runtime.dotnet.thread_pool.completed_items.count` | Counter | {item} | - | - |
| `process.runtime.dotnet.thread_pool.queue.length` | UpDownCounter | {item} | - | - |
| `process.runtime.dotnet.timer.count` | UpDownCounter | {timer} | - | - |
| `process.runtime.dotnet.assemblies.count` | UpDownCounter | {assembly} | - | - |

## Sources

- `src/OpenTelemetry.Instrumentation.Runtime/README.md`

- `src/OpenTelemetry.Instrumentation.Runtime/RuntimeMetrics.cs`
- `src/OpenTelemetry.Instrumentation.Runtime/MeterProviderBuilderExtensions.cs`
        • v1.19.0.md 2.5 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.Runtime
version: v1.19.0
scope_name: OpenTelemetry.Instrumentation.Runtime (before .NET 9), System.Runtime (.NET 9+)
commit_sha: a14fa97f08b38c032dba44197f17e5cea78afe6f
last_verified: 2026-10-14
---

# OpenTelemetry .NET Runtime Instrumentation

## Metrics

The table below describes the package-owned metrics used before .NET 9. On .NET 9+, `AddRuntimeInstrumentation` subscribes to the native `System.Runtime` meter and does not instantiate `RuntimeMetrics`; the metric names and attributes come from the installed runtime. See the pinned package README for that runtime telemetry boundary.

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `process.runtime.dotnet.exceptions.count` | Counter | {exception} | - | First-chance managed exceptions; emitted after at least one exception since initialization. |
| `process.runtime.dotnet.gc.collections.count` | Counter | {collection} | generation | - |
| `process.runtime.dotnet.gc.objects.size` | UpDownCounter | bytes | - | - |
| `process.runtime.dotnet.gc.allocations.size` | Counter | bytes | - | - |
| `process.runtime.dotnet.gc.committed_memory.size` | UpDownCounter | bytes | - | Value unavailable until a GC has occurred. |
| `process.runtime.dotnet.gc.heap.size` | UpDownCounter | bytes | generation | Value unavailable until a GC has occurred. |
| `process.runtime.dotnet.gc.heap.fragmentation.size` | UpDownCounter | bytes | generation | Value unavailable until a GC has occurred. |
| `process.runtime.dotnet.gc.duration` | Counter | ns | - | - |
| `process.runtime.dotnet.jit.il_compiled.size` | Counter | bytes | - | - |
| `process.runtime.dotnet.jit.methods_compiled.count` | Counter | {method} | - | - |
| `process.runtime.dotnet.jit.compilation_time` | Counter | ns | - | - |
| `process.runtime.dotnet.monitor.lock_contention.count` | Counter | {count} | - | - |
| `process.runtime.dotnet.thread_pool.threads.count` | UpDownCounter | {thread} | - | - |
| `process.runtime.dotnet.thread_pool.completed_items.count` | Counter | {item} | - | - |
| `process.runtime.dotnet.thread_pool.queue.length` | UpDownCounter | {item} | - | - |
| `process.runtime.dotnet.timer.count` | UpDownCounter | {timer} | - | - |
| `process.runtime.dotnet.assemblies.count` | UpDownCounter | {assembly} | - | - |

## Sources

- `src/OpenTelemetry.Instrumentation.Runtime/README.md`

- `src/OpenTelemetry.Instrumentation.Runtime/RuntimeMetrics.cs`
- `src/OpenTelemetry.Instrumentation.Runtime/MeterProviderBuilderExtensions.cs`
      • OpenTelemetry.Instrumentation.SqlClient
        • v1.15.1.md 1.5 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.SqlClient
version: v1.15.1
scope_name: OpenTelemetry.Instrumentation.SqlClient
commit_sha: f7db7a2fd53218d174a7549b791afdf44e0d3d73
last_verified: 2026-04-15
---

# SqlClient

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| SQL operation name (SQL text operation summary or stored-procedure name) | Client | `db.system.name`, `db.namespace`, `server.address`, `server.port`, `db.query.text`, `db.query.summary`, `db.operation.name`, `db.stored_procedure.name`, `db.query.parameter.{key}`, `db.response.status_code`, `error.type` | Query parameter attributes require `SetDbQueryParameters`; exception event requires `RecordException`; conventions controlled by `OTEL_SEMCONV_STABILITY_OPT_IN` (`database`/`database/dup`); error attributes only on failure. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `db.client.operation.duration` | Histogram | `s` | `db.system.name`, `db.namespace`, `db.operation.name`, `db.stored_procedure.name`, `db.query.summary`, `db.response.status_code`, `error.type`, `server.address`, `server.port` | - |

## Sources

- `src/OpenTelemetry.Instrumentation.SqlClient/Implementation/SqlClientDiagnosticListener.cs`
- `src/OpenTelemetry.Instrumentation.SqlClient/Implementation/SqlEventSourceListener.netfx.cs`
- `src/OpenTelemetry.Instrumentation.SqlClient/Implementation/SqlTelemetryHelper.cs`
- `src/OpenTelemetry.Instrumentation.SqlClient/SqlClientTraceInstrumentationOptions.cs`
        • v1.15.2.md 1.5 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.SqlClient
version: v1.15.2
scope_name: OpenTelemetry.Instrumentation.SqlClient
commit_sha: 4853e648b96422c8e6cf35ccdc68a73a83f671e4
last_verified: null
---

# SqlClient

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| SQL operation name (SQL text operation summary or stored-procedure name) | Client | `db.system.name`, `db.namespace`, `server.address`, `server.port`, `db.query.text`, `db.query.summary`, `db.operation.name`, `db.stored_procedure.name`, `db.query.parameter.{key}`, `db.response.status_code`, `error.type` | Query parameter attributes require `SetDbQueryParameters`; exception event requires `RecordException`; conventions controlled by `OTEL_SEMCONV_STABILITY_OPT_IN` (`database`/`database/dup`); error attributes only on failure. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `db.client.operation.duration` | Histogram | `s` | `db.system.name`, `db.namespace`, `db.operation.name`, `db.stored_procedure.name`, `db.query.summary`, `db.response.status_code`, `error.type`, `server.address`, `server.port` | - |

## Sources

- `src/OpenTelemetry.Instrumentation.SqlClient/Implementation/SqlClientDiagnosticListener.cs`
- `src/OpenTelemetry.Instrumentation.SqlClient/Implementation/SqlEventSourceListener.netfx.cs`
- `src/OpenTelemetry.Instrumentation.SqlClient/Implementation/SqlTelemetryHelper.cs`
- `src/OpenTelemetry.Instrumentation.SqlClient/SqlClientTraceInstrumentationOptions.cs`
        • v1.16.0.md 1.5 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.SqlClient
version: v1.16.0
scope_name: OpenTelemetry.Instrumentation.SqlClient
commit_sha: d2fdcae86f3b2ad97087279ae5dc796d4cb7d204
last_verified: null
---

# SqlClient

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| SQL operation name (SQL text operation summary or stored-procedure name) | Client | `db.system.name`, `db.namespace`, `server.address`, `server.port`, `db.query.text`, `db.query.summary`, `db.operation.name`, `db.stored_procedure.name`, `db.query.parameter.{key}`, `db.response.status_code`, `error.type` | Query parameter attributes require `SetDbQueryParameters`; exception event requires `RecordException`; conventions controlled by `OTEL_SEMCONV_STABILITY_OPT_IN` (`database`/`database/dup`); error attributes only on failure. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `db.client.operation.duration` | Histogram | `s` | `db.system.name`, `db.namespace`, `db.operation.name`, `db.stored_procedure.name`, `db.query.summary`, `db.response.status_code`, `error.type`, `server.address`, `server.port` | - |

## Sources

- `src/OpenTelemetry.Instrumentation.SqlClient/Implementation/SqlClientDiagnosticListener.cs`
- `src/OpenTelemetry.Instrumentation.SqlClient/Implementation/SqlEventSourceListener.netfx.cs`
- `src/OpenTelemetry.Instrumentation.SqlClient/Implementation/SqlTelemetryHelper.cs`
- `src/OpenTelemetry.Instrumentation.SqlClient/SqlClientTraceInstrumentationOptions.cs`
        • v1.17.0.md 1.5 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.SqlClient
version: v1.17.0
scope_name: OpenTelemetry.Instrumentation.SqlClient
commit_sha: 59e42f217a8804da87dfca61695bd9ea33a90a49
last_verified: null
---

# SqlClient

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| SQL operation name (SQL text operation summary or stored-procedure name) | Client | `db.system.name`, `db.namespace`, `server.address`, `server.port`, `db.query.text`, `db.query.summary`, `db.operation.name`, `db.stored_procedure.name`, `db.query.parameter.{key}`, `db.response.status_code`, `error.type` | Query parameter attributes require `SetDbQueryParameters`; exception event requires `RecordException`; conventions controlled by `OTEL_SEMCONV_STABILITY_OPT_IN` (`database`/`database/dup`); error attributes only on failure. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `db.client.operation.duration` | Histogram | `s` | `db.system.name`, `db.namespace`, `db.operation.name`, `db.stored_procedure.name`, `db.query.summary`, `db.response.status_code`, `error.type`, `server.address`, `server.port` | - |

## Sources

- `src/OpenTelemetry.Instrumentation.SqlClient/Implementation/SqlClientDiagnosticListener.cs`
- `src/OpenTelemetry.Instrumentation.SqlClient/Implementation/SqlEventSourceListener.netfx.cs`
- `src/OpenTelemetry.Instrumentation.SqlClient/Implementation/SqlTelemetryHelper.cs`
- `src/OpenTelemetry.Instrumentation.SqlClient/SqlClientTraceInstrumentationOptions.cs`
        • v1.18.0.md 1.5 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.SqlClient
version: v1.18.0
scope_name: OpenTelemetry.Instrumentation.SqlClient
commit_sha: 10ed94644ab4b8eb5031049b5ffd8fdfe50584bc
last_verified: null
---

# SqlClient

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| SQL operation name (SQL text operation summary or stored-procedure name) | Client | `db.system.name`, `db.namespace`, `server.address`, `server.port`, `db.query.text`, `db.query.summary`, `db.operation.name`, `db.stored_procedure.name`, `db.query.parameter.{key}`, `db.response.status_code`, `error.type` | Query parameter attributes require `SetDbQueryParameters`; exception event requires `RecordException`; conventions controlled by `OTEL_SEMCONV_STABILITY_OPT_IN` (`database`/`database/dup`); error attributes only on failure. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `db.client.operation.duration` | Histogram | `s` | `db.system.name`, `db.namespace`, `db.operation.name`, `db.stored_procedure.name`, `db.query.summary`, `db.response.status_code`, `error.type`, `server.address`, `server.port` | - |

## Sources

- `src/OpenTelemetry.Instrumentation.SqlClient/Implementation/SqlClientDiagnosticListener.cs`
- `src/OpenTelemetry.Instrumentation.SqlClient/Implementation/SqlEventSourceListener.netfx.cs`
- `src/OpenTelemetry.Instrumentation.SqlClient/Implementation/SqlTelemetryHelper.cs`
- `src/OpenTelemetry.Instrumentation.SqlClient/SqlClientTraceInstrumentationOptions.cs`
        • v1.19.0.md 1.5 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.SqlClient
version: v1.19.0
scope_name: OpenTelemetry.Instrumentation.SqlClient
commit_sha: ba9dff87f2750bd7b6ff65a3489552bc940e7255
last_verified: null
---

# SqlClient

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| SQL operation name (SQL text operation summary or stored-procedure name) | Client | `db.system.name`, `db.namespace`, `server.address`, `server.port`, `db.query.text`, `db.query.summary`, `db.operation.name`, `db.stored_procedure.name`, `db.query.parameter.{key}`, `db.response.status_code`, `error.type` | Query parameter attributes require `SetDbQueryParameters`; exception event requires `RecordException`; conventions controlled by `OTEL_SEMCONV_STABILITY_OPT_IN` (`database`/`database/dup`); error attributes only on failure. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `db.client.operation.duration` | Histogram | `s` | `db.system.name`, `db.namespace`, `db.operation.name`, `db.stored_procedure.name`, `db.query.summary`, `db.response.status_code`, `error.type`, `server.address`, `server.port` | - |

## Sources

- `src/OpenTelemetry.Instrumentation.SqlClient/Implementation/SqlClientDiagnosticListener.cs`
- `src/OpenTelemetry.Instrumentation.SqlClient/Implementation/SqlEventSourceListener.netfx.cs`
- `src/OpenTelemetry.Instrumentation.SqlClient/Implementation/SqlTelemetryHelper.cs`
- `src/OpenTelemetry.Instrumentation.SqlClient/SqlClientTraceInstrumentationOptions.cs`
      • OpenTelemetry.Instrumentation.StackExchangeRedis
        • v1.16.0-beta.1.md 1.3 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.StackExchangeRedis
version: v1.16.0-beta.1
scope_name: OpenTelemetry.Instrumentation.StackExchangeRedis
commit_sha: b8338ce62e5c45bee13241bed1f6ea367873e337
last_verified: null
---

# StackExchange.Redis instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `OpenTelemetry.Instrumentation.StackExchangeRedis.Execute` | CLIENT | `db.system` (`redis`) or `db.system.name` (`redis`); optionally `db.redis.database_index`, `db.statement`; optionally `db.operation.name`, `db.namespace`, `db.query.text`; endpoint-dependent server/network address and port attributes | Old/new attribute sets controlled by `EmitOldAttributes` / `EmitNewAttributes`; verbose query text by `SetVerboseDatabaseStatements`. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `Enqueued`, `Sent`, `ResponseReceived` | — | Activity events when `EnrichActivityWithTimingEvents` is true (default true). |

## Sources

- `src/OpenTelemetry.Instrumentation.StackExchangeRedis/Implementation/RedisProfilerEntryToActivityConverter.cs`
- `src/OpenTelemetry.Instrumentation.StackExchangeRedis/StackExchangeRedisConnectionInstrumentation.cs`
- `src/OpenTelemetry.Instrumentation.StackExchangeRedis/StackExchangeRedisInstrumentationOptions.cs`
        • v1.17.0-beta.1.md 1.3 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.StackExchangeRedis
version: v1.17.0-beta.1
scope_name: OpenTelemetry.Instrumentation.StackExchangeRedis
commit_sha: f19a5eb4b76465c6b485042c8b1945324b86918f
last_verified: null
---

# StackExchange.Redis instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `OpenTelemetry.Instrumentation.StackExchangeRedis.Execute` | CLIENT | `db.system` (`redis`) or `db.system.name` (`redis`); optionally `db.redis.database_index`, `db.statement`; optionally `db.operation.name`, `db.namespace`, `db.query.text`; endpoint-dependent server/network address and port attributes | Old/new attribute sets controlled by `EmitOldAttributes` / `EmitNewAttributes`; verbose query text by `SetVerboseDatabaseStatements`. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `Enqueued`, `Sent`, `ResponseReceived` | — | Activity events when `EnrichActivityWithTimingEvents` is true (default true). |

## Sources

- `src/OpenTelemetry.Instrumentation.StackExchangeRedis/Implementation/RedisProfilerEntryToActivityConverter.cs`
- `src/OpenTelemetry.Instrumentation.StackExchangeRedis/StackExchangeRedisConnectionInstrumentation.cs`
- `src/OpenTelemetry.Instrumentation.StackExchangeRedis/StackExchangeRedisInstrumentationOptions.cs`
        • v1.18.0-beta.1.md 1.3 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.StackExchangeRedis
version: v1.18.0-beta.1
scope_name: OpenTelemetry.Instrumentation.StackExchangeRedis
commit_sha: 6e2e02ea57debebeb9cc4bb2b941da5b7e885e2e
last_verified: null
---

# StackExchange.Redis instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `OpenTelemetry.Instrumentation.StackExchangeRedis.Execute` | CLIENT | `db.system` (`redis`) or `db.system.name` (`redis`); optionally `db.redis.database_index`, `db.statement`; optionally `db.operation.name`, `db.namespace`, `db.query.text`; endpoint-dependent server/network address and port attributes | Old/new attribute sets controlled by `EmitOldAttributes` / `EmitNewAttributes`; verbose query text by `SetVerboseDatabaseStatements`. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `Enqueued`, `Sent`, `ResponseReceived` | — | Activity events when `EnrichActivityWithTimingEvents` is true (default true). |

## Sources

- `src/OpenTelemetry.Instrumentation.StackExchangeRedis/Implementation/RedisProfilerEntryToActivityConverter.cs`
- `src/OpenTelemetry.Instrumentation.StackExchangeRedis/StackExchangeRedisConnectionInstrumentation.cs`
- `src/OpenTelemetry.Instrumentation.StackExchangeRedis/StackExchangeRedisInstrumentationOptions.cs`
        • v1.18.0-beta.2.md 1.3 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.StackExchangeRedis
version: v1.18.0-beta.2
scope_name: OpenTelemetry.Instrumentation.StackExchangeRedis
commit_sha: 3bfc00d31b3788efff09b5991f54cbb338bdaa13
last_verified: null
---

# StackExchange.Redis instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `OpenTelemetry.Instrumentation.StackExchangeRedis.Execute` | CLIENT | `db.system` (`redis`) or `db.system.name` (`redis`); optionally `db.redis.database_index`, `db.statement`; optionally `db.operation.name`, `db.namespace`, `db.query.text`; endpoint-dependent server/network address and port attributes | Old/new attribute sets controlled by `EmitOldAttributes` / `EmitNewAttributes`; verbose query text by `SetVerboseDatabaseStatements`. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `Enqueued`, `Sent`, `ResponseReceived` | — | Activity events when `EnrichActivityWithTimingEvents` is true (default true). |

## Sources

- `src/OpenTelemetry.Instrumentation.StackExchangeRedis/Implementation/RedisProfilerEntryToActivityConverter.cs`
- `src/OpenTelemetry.Instrumentation.StackExchangeRedis/StackExchangeRedisConnectionInstrumentation.cs`
- `src/OpenTelemetry.Instrumentation.StackExchangeRedis/StackExchangeRedisInstrumentationOptions.cs`
        • v1.18.0-beta.3.md 1.3 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.StackExchangeRedis
version: v1.18.0-beta.3
scope_name: OpenTelemetry.Instrumentation.StackExchangeRedis
commit_sha: 7a20d95b5acdcd8ab8599a67aa8d40f47224dae9
last_verified: null
---

# StackExchange.Redis instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `OpenTelemetry.Instrumentation.StackExchangeRedis.Execute` | CLIENT | `db.system` (`redis`) or `db.system.name` (`redis`); optionally `db.redis.database_index`, `db.statement`; optionally `db.operation.name`, `db.namespace`, `db.query.text`; endpoint-dependent server/network address and port attributes | Old/new attribute sets controlled by `EmitOldAttributes` / `EmitNewAttributes`; verbose query text by `SetVerboseDatabaseStatements`. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `Enqueued`, `Sent`, `ResponseReceived` | — | Activity events when `EnrichActivityWithTimingEvents` is true (default true). |

## Sources

- `src/OpenTelemetry.Instrumentation.StackExchangeRedis/Implementation/RedisProfilerEntryToActivityConverter.cs`
- `src/OpenTelemetry.Instrumentation.StackExchangeRedis/StackExchangeRedisConnectionInstrumentation.cs`
- `src/OpenTelemetry.Instrumentation.StackExchangeRedis/StackExchangeRedisInstrumentationOptions.cs`
        • v1.19.0-beta.1.md 1.8 KB 
          ---
repo: open-telemetry/opentelemetry-dotnet-contrib
path: src/OpenTelemetry.Instrumentation.StackExchangeRedis
version: v1.19.0-beta.1
scope_name: OpenTelemetry.Instrumentation.StackExchangeRedis
commit_sha: 18759cddb2ce52db0a721a95698b28e9e690a239
last_verified: null
---

# StackExchange.Redis instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `OpenTelemetry.Instrumentation.StackExchangeRedis.Execute` | CLIENT | `db.system` (`redis`) or `db.system.name` (`redis`); conditionally `db.redis.database_index`, `db.statement` (old conventions); conditionally `db.operation.name`, `db.namespace`, `db.query.text` (new conventions); conditionally `server.address`, `server.port`, `network.peer.address`, `network.peer.port` based on endpoint type | Old/new semantic convention attribute sets controlled by `EmitOldAttributes` / `EmitNewAttributes`; verbose statement enrichment by `SetVerboseDatabaseStatements`. Endpoint attributes only when endpoint is available. |

| Span name | Kind | Attributes | Notes |
|---|---|---|---|

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `Enqueued` | — | Activity event; emitted when `EnrichActivityWithTimingEvents` is true (default true). |
| `Sent` | — | Activity event; emitted when `EnrichActivityWithTimingEvents` is true (default true). |
| `ResponseReceived` | — | Activity event; emitted when `EnrichActivityWithTimingEvents` is true (default true). |

## Sources

- `src/OpenTelemetry.Instrumentation.StackExchangeRedis/Implementation/RedisProfilerEntryToActivityConverter.cs`
- `src/OpenTelemetry.Instrumentation.StackExchangeRedis/StackExchangeRedisConnectionInstrumentation.cs`
- `src/OpenTelemetry.Instrumentation.StackExchangeRedis/StackExchangeRedisInstrumentationOptions.cs`
  • opentelemetry-go-contrib
    • instrumentation
      • github.com
        • gin-gonic
          • gin
            • otelgin
              • v0.65.0.md 2.7 KB 
                ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/github.com/gin-gonic/gin/otelgin
version: v0.65.0
scope_name: go.opentelemetry.io/contrib/instrumentation/github.com/gin-gonic/gin/otelgin
commit_sha: a89d958e7a2575cf539ffca09657cfd90821d6e4
last_verified: 2026-08-11
---

# Gin OpenTelemetry instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `{HTTP method} {route}` (or `{HTTP method}` when no route) | SERVER | `server.address`, `http.request.method`, `url.scheme`, `server.port`, `http.request.method.original`, `network.peer.address`, `network.peer.port`, `user_agent.original`, `client.address`, `url.path`, `network.protocol.name`, `network.protocol.version`, `http.route`, `http.response.status_code`, `http.response.body.size` | Request attributes are conditional on request data; `server.port`, `network.peer.port`, `http.response.body.size`, and `http.route` are omitted when unavailable. `network.protocol.name` is omitted for `http`. Response attributes are set after the handler. Filters can suppress the span. |
| `gin.renderer.html` | INTERNAL | `go.template` | Emitted by the `HTML` helper. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.server.request.body.size` | Histogram (Int64) | By | `http.request.method`, `url.scheme`, `server.address`, `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, plus user-supplied metric attributes | Recorded after every non-filtered request. Optional attributes are omitted when unavailable. |
| `http.server.response.body.size` | Histogram (Int64) | By | `http.request.method`, `url.scheme`, `server.address`, `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, plus user-supplied metric attributes | Recorded after every non-filtered request. Optional attributes are omitted when unavailable. |
| `http.server.request.duration` | Histogram (Float64) | s | `http.request.method`, `url.scheme`, `server.address`, `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, plus user-supplied metric attributes | Recorded after every non-filtered request. Explicit duration buckets are configured. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `exception` | `exception.type`, `exception.message` | Emitted on the request span once for each Gin error via `Span.RecordError`. |

## Sources

- `instrumentation/github.com/gin-gonic/gin/otelgin/gin.go`
- `instrumentation/github.com/gin-gonic/gin/otelgin/internal/semconv/server.go`
- `instrumentation/github.com/gin-gonic/gin/otelgin/config.go`
              • v0.66.0.md 2.7 KB 
                ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/github.com/gin-gonic/gin/otelgin
version: v0.66.0
scope_name: go.opentelemetry.io/contrib/instrumentation/github.com/gin-gonic/gin/otelgin
commit_sha: 07fa42463ccd05b067b0939aa4f1c57673ac6d6d
last_verified: 2026-08-11
---

# Gin OpenTelemetry instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `{HTTP method} {route}` (or `{HTTP method}` when no route) | SERVER | `server.address`, `http.request.method`, `url.scheme`, `server.port`, `http.request.method.original`, `network.peer.address`, `network.peer.port`, `user_agent.original`, `client.address`, `url.path`, `network.protocol.name`, `network.protocol.version`, `http.route`, `http.response.status_code`, `http.response.body.size` | Request attributes are conditional on request data; `server.port`, `network.peer.port`, `http.response.body.size`, and `http.route` are omitted when unavailable. `network.protocol.name` is omitted for `http`. Response attributes are set after the handler. Filters can suppress the span. |
| `gin.renderer.html` | INTERNAL | `go.template` | Emitted by the `HTML` helper. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.server.request.body.size` | Histogram (Int64) | By | `http.request.method`, `url.scheme`, `server.address`, `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, plus user-supplied metric attributes | Recorded after every non-filtered request. Optional attributes are omitted when unavailable. |
| `http.server.response.body.size` | Histogram (Int64) | By | `http.request.method`, `url.scheme`, `server.address`, `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, plus user-supplied metric attributes | Recorded after every non-filtered request. Optional attributes are omitted when unavailable. |
| `http.server.request.duration` | Histogram (Float64) | s | `http.request.method`, `url.scheme`, `server.address`, `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, plus user-supplied metric attributes | Recorded after every non-filtered request. Explicit duration buckets are configured. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `exception` | `exception.type`, `exception.message` | Emitted on the request span once for each Gin error via `Span.RecordError`. |

## Sources

- `instrumentation/github.com/gin-gonic/gin/otelgin/gin.go`
- `instrumentation/github.com/gin-gonic/gin/otelgin/internal/semconv/server.go`
- `instrumentation/github.com/gin-gonic/gin/otelgin/config.go`
              • v0.67.0.md 2.7 KB 
                ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/github.com/gin-gonic/gin/otelgin
version: v0.67.0
scope_name: go.opentelemetry.io/contrib/instrumentation/github.com/gin-gonic/gin/otelgin
commit_sha: d8dabf67361a4619c353ad0637432f3d0d16ba63
last_verified: 2026-08-11
---

# Gin OpenTelemetry instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `{HTTP method} {route}` (or `{HTTP method}` when no route) | SERVER | `server.address`, `http.request.method`, `url.scheme`, `server.port`, `http.request.method.original`, `network.peer.address`, `network.peer.port`, `user_agent.original`, `client.address`, `url.path`, `network.protocol.name`, `network.protocol.version`, `http.route`, `http.response.status_code`, `http.response.body.size` | Request attributes are conditional on request data; `server.port`, `network.peer.port`, `http.response.body.size`, and `http.route` are omitted when unavailable. `network.protocol.name` is omitted for `http`. Response attributes are set after the handler. Filters can suppress the span. |
| `gin.renderer.html` | INTERNAL | `go.template` | Emitted by the `HTML` helper. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.server.request.body.size` | Histogram (Int64) | By | `http.request.method`, `url.scheme`, `server.address`, `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, plus user-supplied metric attributes | Recorded after every non-filtered request. Optional attributes are omitted when unavailable. |
| `http.server.response.body.size` | Histogram (Int64) | By | `http.request.method`, `url.scheme`, `server.address`, `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, plus user-supplied metric attributes | Recorded after every non-filtered request. Optional attributes are omitted when unavailable. |
| `http.server.request.duration` | Histogram (Float64) | s | `http.request.method`, `url.scheme`, `server.address`, `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, plus user-supplied metric attributes | Recorded after every non-filtered request. Explicit duration buckets are configured. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `exception` | `exception.type`, `exception.message` | Emitted on the request span once for each Gin error via `Span.RecordError`. |

## Sources

- `instrumentation/github.com/gin-gonic/gin/otelgin/gin.go`
- `instrumentation/github.com/gin-gonic/gin/otelgin/internal/semconv/server.go`
- `instrumentation/github.com/gin-gonic/gin/otelgin/config.go`
              • v0.68.0.md 2.7 KB 
                ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/github.com/gin-gonic/gin/otelgin
version: v0.68.0
scope_name: go.opentelemetry.io/contrib/instrumentation/github.com/gin-gonic/gin/otelgin
commit_sha: 45977a4b9cf4a60effd1ee07367043f7e9bcae66
last_verified: null
---

# Gin OpenTelemetry instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `{HTTP method} {route}` (or `{HTTP method}` when no route) | SERVER | `server.address`, `http.request.method`, `url.scheme`, `server.port`, `http.request.method.original`, `network.peer.address`, `network.peer.port`, `user_agent.original`, `client.address`, `url.path`, `network.protocol.name`, `network.protocol.version`, `http.route`, `http.response.status_code`, `http.response.body.size` | Request attributes are conditional on request data; `server.port`, `network.peer.port`, `http.response.body.size`, and `http.route` are omitted when unavailable. `network.protocol.name` is omitted for `http`. Response attributes are set after the handler. Filters can suppress the span. |
| `gin.renderer.html` | INTERNAL | `go.template` | Emitted by the `HTML` helper. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.server.request.body.size` | Histogram (Int64) | By | `http.request.method`, `url.scheme`, `server.address`, `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, plus user-supplied metric attributes | Recorded after every non-filtered request. Optional attributes are omitted when unavailable. |
| `http.server.response.body.size` | Histogram (Int64) | By | `http.request.method`, `url.scheme`, `server.address`, `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, plus user-supplied metric attributes | Recorded after every non-filtered request. Optional attributes are omitted when unavailable. |
| `http.server.request.duration` | Histogram (Float64) | s | `http.request.method`, `url.scheme`, `server.address`, `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, plus user-supplied metric attributes | Recorded after every non-filtered request. Explicit duration buckets are configured. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `exception` | `exception.type`, `exception.message` | Emitted on the request span once for each Gin error via `Span.RecordError`. |

## Sources

- `instrumentation/github.com/gin-gonic/gin/otelgin/gin.go`
- `instrumentation/github.com/gin-gonic/gin/otelgin/internal/semconv/server.go`
- `instrumentation/github.com/gin-gonic/gin/otelgin/config.go`
              • v0.69.0.md 2.7 KB 
                ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/github.com/gin-gonic/gin/otelgin
version: v0.69.0
scope_name: go.opentelemetry.io/contrib/instrumentation/github.com/gin-gonic/gin/otelgin
commit_sha: 03b2bcdb54b3dde73c9ff91ae216aec262f6c8f5
last_verified: null
---

# Gin OpenTelemetry instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `{HTTP method} {route}` (or `{HTTP method}` when no route) | SERVER | `server.address`, `http.request.method`, `url.scheme`, `server.port`, `http.request.method.original`, `network.peer.address`, `network.peer.port`, `user_agent.original`, `client.address`, `url.path`, `network.protocol.name`, `network.protocol.version`, `http.route`, `http.response.status_code`, `http.response.body.size` | Request attributes are conditional on request data; `server.port`, `network.peer.port`, `http.response.body.size`, and `http.route` are omitted when unavailable. `network.protocol.name` is omitted for `http`. Response attributes are set after the handler. Filters can suppress the span. |
| `gin.renderer.html` | INTERNAL | `go.template` | Emitted by the `HTML` helper. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.server.request.body.size` | Histogram (Int64) | By | `http.request.method`, `url.scheme`, `server.address`, `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, plus user-supplied metric attributes | Recorded after every non-filtered request. Optional attributes are omitted when unavailable. |
| `http.server.response.body.size` | Histogram (Int64) | By | `http.request.method`, `url.scheme`, `server.address`, `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, plus user-supplied metric attributes | Recorded after every non-filtered request. Optional attributes are omitted when unavailable. |
| `http.server.request.duration` | Histogram (Float64) | s | `http.request.method`, `url.scheme`, `server.address`, `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, plus user-supplied metric attributes | Recorded after every non-filtered request. Explicit duration buckets are configured. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `exception` | `exception.type`, `exception.message` | Emitted on the request span once for each Gin error via `Span.RecordError`. |

## Sources

- `instrumentation/github.com/gin-gonic/gin/otelgin/gin.go`
- `instrumentation/github.com/gin-gonic/gin/otelgin/internal/semconv/server.go`
- `instrumentation/github.com/gin-gonic/gin/otelgin/config.go`
              • v0.70.0.md 2.6 KB 
                ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/github.com/gin-gonic/gin/otelgin
version: v0.70.0
scope_name: go.opentelemetry.io/contrib/instrumentation/github.com/gin-gonic/gin/otelgin
commit_sha: c8a87a60ba1b3374fd16df11fc3eeae6c41abbc9
last_verified: null
---

# Gin OpenTelemetry instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `{HTTP method} {route}` (or `{HTTP method}` when no route) | SERVER | `server.address`, `http.request.method`, `url.scheme`, `server.port`, `http.request.method.original`, `network.peer.address`, `network.peer.port`, `user_agent.original`, `client.address`, `url.path`, `network.protocol.name`, `network.protocol.version`, `http.route`, `http.response.status_code`, `http.response.body.size`, `error.type` | Request attributes are conditional on request data; `server.port`, `network.peer.port`, `http.response.body.size`, and `http.route` are omitted when unavailable. `network.protocol.name` is omitted for `http`. Response attributes are set after the handler. `error.type` is emitted when Gin has one or more errors; it is the individual error type for one error and `other` for multiple errors. Filters can suppress the span. |
| `gin.renderer.html` | INTERNAL | `go.template` | Emitted by the `HTML` helper. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.server.request.body.size` | Histogram (Int64) | By | `http.request.method`, `url.scheme`, `server.address`, `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, plus user-supplied metric attributes | Recorded after every non-filtered request. Optional attributes are omitted when unavailable. |
| `http.server.response.body.size` | Histogram (Int64) | By | `http.request.method`, `url.scheme`, `server.address`, `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, plus user-supplied metric attributes | Recorded after every non-filtered request. Optional attributes are omitted when unavailable. |
| `http.server.request.duration` | Histogram (Float64) | s | `http.request.method`, `url.scheme`, `server.address`, `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, plus user-supplied metric attributes | Recorded after every non-filtered request. Explicit duration buckets are configured. |

## Sources

- `instrumentation/github.com/gin-gonic/gin/otelgin/gin.go`
- `instrumentation/github.com/gin-gonic/gin/otelgin/internal/semconv/server.go`
- `instrumentation/github.com/gin-gonic/gin/otelgin/config.go`
              • v0.71.0.md 2.6 KB 
                ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/github.com/gin-gonic/gin/otelgin
version: v0.71.0
scope_name: go.opentelemetry.io/contrib/instrumentation/github.com/gin-gonic/gin/otelgin
commit_sha: c4c6248ec2289133b6a51f554ca9367ece1de8e7
last_verified: 2026-09-03
---

# Gin OpenTelemetry instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `{HTTP method} {route}` (or `{HTTP method}` when no route) | SERVER | `server.address`, `http.request.method`, `url.scheme`, `server.port`, `http.request.method.original`, `network.peer.address`, `network.peer.port`, `user_agent.original`, `client.address`, `url.path`, `network.protocol.name`, `network.protocol.version`, `http.route`, `http.response.status_code`, `http.response.body.size`, `error.type` | Request attributes are conditional on request data; `server.port`, `network.peer.port`, `http.response.body.size`, and `http.route` are omitted when unavailable. `network.protocol.name` is omitted for `http`. Response attributes are set after the handler. `error.type` is emitted when Gin has one or more errors; it is the individual error type for one error and `other` for multiple errors. Filters can suppress the span. |
| `gin.renderer.html` | INTERNAL | `go.template` | Emitted by the `HTML` helper. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.server.request.body.size` | Histogram (Int64) | By | `http.request.method`, `url.scheme`, `server.address`, `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, plus user-supplied metric attributes | Recorded after every non-filtered request. Optional attributes are omitted when unavailable. |
| `http.server.response.body.size` | Histogram (Int64) | By | `http.request.method`, `url.scheme`, `server.address`, `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, plus user-supplied metric attributes | Recorded after every non-filtered request. Optional attributes are omitted when unavailable. |
| `http.server.request.duration` | Histogram (Float64) | s | `http.request.method`, `url.scheme`, `server.address`, `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, plus user-supplied metric attributes | Recorded after every non-filtered request. Explicit duration buckets are configured. |

## Sources

- `instrumentation/github.com/gin-gonic/gin/otelgin/gin.go`
- `instrumentation/github.com/gin-gonic/gin/otelgin/internal/semconv/server.go`
- `instrumentation/github.com/gin-gonic/gin/otelgin/config.go`
              • v0.72.0.md 3.1 KB 
                ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/github.com/gin-gonic/gin/otelgin
version: v0.72.0
scope_name: go.opentelemetry.io/contrib/instrumentation/github.com/gin-gonic/gin/otelgin
commit_sha: 0c76f6137a2ceea80984d55e3de165924d823f71
last_verified: 2026-10-03
---

# Gin OpenTelemetry instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `{HTTP method} {route}` (or `{HTTP method}` when no route) | SERVER | `server.address`, `http.request.method`, `url.scheme`, `server.port`, `http.request.method_original`, `network.peer.address`, `network.peer.port`, `user_agent.original`, `client.address`, `url.path`, `network.protocol.name`, `network.protocol.version`, `http.route`, `http.response.status_code`, `http.response.body.size`, `error.type` | Request attributes are conditional on request data; `server.port`, `network.peer.port`, `http.response.body.size`, and `http.route` are omitted when unavailable. `network.protocol.name` is omitted for `http`. Response attributes are set after the handler. `error.type` is emitted when Gin has one or more errors (the individual error type for one error, `other` for multiple), or, with no Gin error, when the client disconnected mid-request (classified from the request context's cancellation error, with span status Error). Filters can suppress the span. |
| `gin.renderer.html` | INTERNAL | `go.template` | Emitted by the `HTML` helper. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.server.request.body.size` | Histogram (Int64) | By | `http.request.method`, `url.scheme`, `server.address`, `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, `error.type` (when the span records one), plus user-supplied metric attributes | Recorded after every non-filtered request. Optional attributes are omitted when unavailable; a user-supplied `error.type` overrides the detected one. |
| `http.server.response.body.size` | Histogram (Int64) | By | `http.request.method`, `url.scheme`, `server.address`, `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, `error.type` (when the span records one), plus user-supplied metric attributes | Recorded after every non-filtered request. Optional attributes are omitted when unavailable; a user-supplied `error.type` overrides the detected one. |
| `http.server.request.duration` | Histogram (Float64) | s | `http.request.method`, `url.scheme`, `server.address`, `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, `error.type` (when the span records one), plus user-supplied metric attributes | Recorded after every non-filtered request. Explicit duration buckets are configured; a user-supplied `error.type` overrides the detected one. |

## Sources

- `instrumentation/github.com/gin-gonic/gin/otelgin/gin.go`
- `instrumentation/github.com/gin-gonic/gin/otelgin/internal/semconv/server.go`
- `instrumentation/github.com/gin-gonic/gin/otelgin/config.go`
      • google.golang.org
        • grpc
          • otelgrpc
            • v0.65.0.md 2.6 KB 
              ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/google.golang.org/grpc/otelgrpc
version: v0.65.0
scope_name: go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc
commit_sha: a89d958e7a2575cf539ffca09657cfd90821d6e4
last_verified: 2026-08-11
---

# otelgrpc

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `<package.service>/<method>` (full gRPC method without the leading slash) | Client or server | `rpc.method` (fully-qualified method), `rpc.system.name=grpc`, `rpc.response.status_code`; `server.address` and `server.port` when the gRPC peer address is available; custom `WithSpanAttributes` attributes | Spans are gated by `WithFilter`; kind defaults to client or server. The response status is the canonical gRPC code; server status is Error for Unknown, DeadlineExceeded, Unimplemented, Internal, Unavailable, and DataLoss. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `rpc.client.call.duration` | Histogram | s | `rpc.method`, `rpc.system.name=grpc`, `rpc.response.status_code`; custom `WithMetricAttributes`/`WithMetricAttributesFn` attributes | Emitted at RPC end. Filtered RPCs are not recorded. |
| `rpc.client.request.size` | Histogram | By | `rpc.method`, `rpc.system.name=grpc`; custom `WithMetricAttributes`/`WithMetricAttributesFn` attributes | Recorded for each outbound payload. Filtered RPCs are not recorded. |
| `rpc.client.response.size` | Histogram | By | `rpc.method`, `rpc.system.name=grpc`; custom `WithMetricAttributes`/`WithMetricAttributesFn` attributes | Recorded for each inbound payload. Filtered RPCs are not recorded. |
| `rpc.server.call.duration` | Histogram | s | `rpc.method`, `rpc.system.name=grpc`, `rpc.response.status_code`; custom `WithMetricAttributes`/`WithMetricAttributesFn` attributes | Emitted at RPC end. Filtered RPCs are not recorded. |
| `rpc.server.request.size` | Histogram | By | `rpc.method`, `rpc.system.name=grpc`; custom `WithMetricAttributes`/`WithMetricAttributesFn` attributes | Recorded for each inbound payload. Filtered RPCs are not recorded. |
| `rpc.server.response.size` | Histogram | By | `rpc.method`, `rpc.system.name=grpc`; custom `WithMetricAttributes`/`WithMetricAttributesFn` attributes | Recorded for each outbound payload. Filtered RPCs are not recorded. |

## Sources

- `instrumentation/google.golang.org/grpc/otelgrpc/stats_handler.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/config.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/interceptor.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/internal/parse.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/grpc_stats_handler_test.go`
            • v0.66.0.md 2.6 KB 
              ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/google.golang.org/grpc/otelgrpc
version: v0.66.0
scope_name: go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc
commit_sha: 07fa42463ccd05b067b0939aa4f1c57673ac6d6d
last_verified: 2026-08-11
---

# otelgrpc

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `<package.service>/<method>` (full gRPC method without the leading slash) | Client or server | `rpc.method` (fully-qualified method), `rpc.system.name=grpc`, `rpc.response.status_code`; `server.address` and `server.port` when the gRPC peer address is available; custom `WithSpanAttributes` attributes | Spans are gated by `WithFilter`; kind defaults to client or server. The response status is the canonical gRPC code; server status is Error for Unknown, DeadlineExceeded, Unimplemented, Internal, Unavailable, and DataLoss. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `rpc.client.call.duration` | Histogram | s | `rpc.method`, `rpc.system.name=grpc`, `rpc.response.status_code`; custom `WithMetricAttributes`/`WithMetricAttributesFn` attributes | Emitted at RPC end. Filtered RPCs are not recorded. |
| `rpc.client.request.size` | Histogram | By | `rpc.method`, `rpc.system.name=grpc`; custom `WithMetricAttributes`/`WithMetricAttributesFn` attributes | Recorded for each outbound payload. Filtered RPCs are not recorded. |
| `rpc.client.response.size` | Histogram | By | `rpc.method`, `rpc.system.name=grpc`; custom `WithMetricAttributes`/`WithMetricAttributesFn` attributes | Recorded for each inbound payload. Filtered RPCs are not recorded. |
| `rpc.server.call.duration` | Histogram | s | `rpc.method`, `rpc.system.name=grpc`, `rpc.response.status_code`; custom `WithMetricAttributes`/`WithMetricAttributesFn` attributes | Emitted at RPC end. Filtered RPCs are not recorded. |
| `rpc.server.request.size` | Histogram | By | `rpc.method`, `rpc.system.name=grpc`; custom `WithMetricAttributes`/`WithMetricAttributesFn` attributes | Recorded for each inbound payload. Filtered RPCs are not recorded. |
| `rpc.server.response.size` | Histogram | By | `rpc.method`, `rpc.system.name=grpc`; custom `WithMetricAttributes`/`WithMetricAttributesFn` attributes | Recorded for each outbound payload. Filtered RPCs are not recorded. |

## Sources

- `instrumentation/google.golang.org/grpc/otelgrpc/stats_handler.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/config.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/interceptor.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/internal/parse.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/grpc_stats_handler_test.go`
            • v0.67.0.md 1.8 KB 
              ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/google.golang.org/grpc/otelgrpc
version: v0.67.0
scope_name: go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc
commit_sha: d8dabf67361a4619c353ad0637432f3d0d16ba63
last_verified: 2026-08-11
---

# otelgrpc

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `<package.service>/<method>` (full gRPC method without the leading slash) | Client or server | `rpc.method` (fully-qualified method), `rpc.system.name=grpc`, `rpc.response.status_code`; `server.address` and `server.port` when the gRPC peer address is available; custom `WithSpanAttributes` attributes | Spans are gated by `WithFilter`; kind defaults to client or server. The response status is the canonical gRPC code; server status is Error for Unknown, DeadlineExceeded, Unimplemented, Internal, Unavailable, and DataLoss. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `rpc.client.call.duration` | Histogram | s | `rpc.method`, `rpc.system.name=grpc`, `rpc.response.status_code`; custom `WithMetricAttributes`/`WithMetricAttributesFn` attributes | Emitted at RPC end. Filtered RPCs are not recorded. |
| `rpc.server.call.duration` | Histogram | s | `rpc.method`, `rpc.system.name=grpc`, `rpc.response.status_code`; custom `WithMetricAttributes`/`WithMetricAttributesFn` attributes | Emitted at RPC end. Filtered RPCs are not recorded. |

## Sources

- `instrumentation/google.golang.org/grpc/otelgrpc/stats_handler.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/config.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/interceptor.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/internal/parse.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/grpc_stats_handler_test.go`
            • v0.68.0.md 3.1 KB 
              ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/google.golang.org/grpc/otelgrpc
version: v0.68.0
scope_name: go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc
commit_sha: 45977a4b9cf4a60effd1ee07367043f7e9bcae66
last_verified: 2026-08-06
---

# otelgrpc

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `<package.service>/<method>` (full gRPC method without the leading slash) | Client or server (configurable; defaults to client/server respectively) | New conventions (default): `rpc.method` (fully-qualified method), `rpc.system.name=grpc`, `rpc.response.status_code`; client spans additionally get `server.address` and `server.port` from the remote address, and server spans get them from the local address. Old conventions: `rpc.system=grpc`, `rpc.service`, `rpc.method` (method segment), plus the same response/address attributes. Custom `WithSpanAttributes` are also included. | Spans are gated by `WithFilter`; `OTEL_SEMCONV_STABILITY_OPT_IN=rpc/old` selects old attributes, and `rpc/dup` emits both. Address attributes are emitted only when the corresponding stats address is available. The response status is the canonical gRPC code; server status is Error for Unknown, DeadlineExceeded, Unimplemented, Internal, Unavailable, and DataLoss. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `rpc.client.call.duration` | Histogram | s | `rpc.method`, `rpc.system.name=grpc`, `rpc.response.status_code`, `server.address`, `server.port`; custom `WithMetricAttributes`/`WithMetricAttributesFn` attributes | Default new RPC semantic conventions; emitted at RPC end. `server.address`/`server.port` are included when the remote address is available. `OTEL_SEMCONV_STABILITY_OPT_IN=rpc/dup` emits this alongside the old metric. Filtered RPCs are not recorded. |
| `rpc.server.call.duration` | Histogram | s | `rpc.method`, `rpc.system.name=grpc`, `rpc.response.status_code`; custom `WithMetricAttributes`/`WithMetricAttributesFn` attributes | Default new RPC semantic conventions; emitted at RPC end. `OTEL_SEMCONV_STABILITY_OPT_IN=rpc/dup` emits this alongside the old metric. Filtered RPCs are not recorded. |
| `rpc.client.duration` | Histogram | ms | `rpc.system=grpc`, `rpc.service`, `rpc.method` (method segment), `rpc.response.status_code`, `server.address`, `server.port`; custom metric attributes | Only with `OTEL_SEMCONV_STABILITY_OPT_IN=rpc/old` or `rpc/dup`; emitted at RPC end. Address attributes are included when the remote address is available. |
| `rpc.server.duration` | Histogram | ms | `rpc.system=grpc`, `rpc.service`, `rpc.method` (method segment), `rpc.response.status_code`; custom metric attributes | Only with `OTEL_SEMCONV_STABILITY_OPT_IN=rpc/old` or `rpc/dup`; emitted at RPC end. |

## Sources

- `instrumentation/google.golang.org/grpc/otelgrpc/stats_handler.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/config.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/interceptor.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/internal/parse.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/grpc_stats_handler_test.go`
            • v0.69.0.md 3.1 KB 
              ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/google.golang.org/grpc/otelgrpc
version: v0.69.0
scope_name: go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc
commit_sha: 03b2bcdb54b3dde73c9ff91ae216aec262f6c8f5
last_verified: 2026-08-06
---

# otelgrpc

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `<package.service>/<method>` (full gRPC method without the leading slash) | Client or server (configurable; defaults to client/server respectively) | New conventions (default): `rpc.method` (fully-qualified method), `rpc.system.name=grpc`, `rpc.response.status_code`; client spans additionally get `server.address` and `server.port` from the remote address, and server spans get them from the local address. Old conventions: `rpc.system=grpc`, `rpc.service`, `rpc.method` (method segment), plus the same response/address attributes. Custom `WithSpanAttributes` are also included. | Spans are gated by `WithFilter`; `OTEL_SEMCONV_STABILITY_OPT_IN=rpc/old` selects old attributes, and `rpc/dup` emits both. Address attributes are emitted only when the corresponding stats address is available. The response status is the canonical gRPC code; server status is Error for Unknown, DeadlineExceeded, Unimplemented, Internal, Unavailable, and DataLoss. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `rpc.client.call.duration` | Histogram | s | `rpc.method`, `rpc.system.name=grpc`, `rpc.response.status_code`, `server.address`, `server.port`; custom `WithMetricAttributes`/`WithMetricAttributesFn` attributes | Default new RPC semantic conventions; emitted at RPC end. `server.address`/`server.port` are included when the remote address is available. `OTEL_SEMCONV_STABILITY_OPT_IN=rpc/dup` emits this alongside the old metric. Filtered RPCs are not recorded. |
| `rpc.server.call.duration` | Histogram | s | `rpc.method`, `rpc.system.name=grpc`, `rpc.response.status_code`; custom `WithMetricAttributes`/`WithMetricAttributesFn` attributes | Default new RPC semantic conventions; emitted at RPC end. `OTEL_SEMCONV_STABILITY_OPT_IN=rpc/dup` emits this alongside the old metric. Filtered RPCs are not recorded. |
| `rpc.client.duration` | Histogram | ms | `rpc.system=grpc`, `rpc.service`, `rpc.method` (method segment), `rpc.response.status_code`, `server.address`, `server.port`; custom metric attributes | Only with `OTEL_SEMCONV_STABILITY_OPT_IN=rpc/old` or `rpc/dup`; emitted at RPC end. Address attributes are included when the remote address is available. |
| `rpc.server.duration` | Histogram | ms | `rpc.system=grpc`, `rpc.service`, `rpc.method` (method segment), `rpc.response.status_code`; custom metric attributes | Only with `OTEL_SEMCONV_STABILITY_OPT_IN=rpc/old` or `rpc/dup`; emitted at RPC end. |

## Sources

- `instrumentation/google.golang.org/grpc/otelgrpc/stats_handler.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/config.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/interceptor.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/internal/parse.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/grpc_stats_handler_test.go`
            • v0.70.0.md 3.1 KB 
              ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/google.golang.org/grpc/otelgrpc
version: v0.70.0
scope_name: go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc
commit_sha: c8a87a60ba1b3374fd16df11fc3eeae6c41abbc9
last_verified: 2026-08-06
---

# otelgrpc

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `<package.service>/<method>` (full gRPC method without the leading slash) | Client or server (configurable; defaults to client/server respectively) | New conventions (default): `rpc.method` (fully-qualified method), `rpc.system.name=grpc`, `rpc.response.status_code`; client spans additionally get `server.address` and `server.port` from the remote address, and server spans get them from the local address. Old conventions: `rpc.system=grpc`, `rpc.service`, `rpc.method` (method segment), plus the same response/address attributes. Custom `WithSpanAttributes` are also included. | Spans are gated by `WithFilter`; `OTEL_SEMCONV_STABILITY_OPT_IN=rpc/old` selects old attributes, and `rpc/dup` emits both. Address attributes are emitted only when the corresponding stats address is available. The response status is the canonical gRPC code; server status is Error for Unknown, DeadlineExceeded, Unimplemented, Internal, Unavailable, and DataLoss. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `rpc.client.call.duration` | Histogram | s | `rpc.method`, `rpc.system.name=grpc`, `rpc.response.status_code`, `server.address`, `server.port`; custom `WithMetricAttributes`/`WithMetricAttributesFn` attributes | Default new RPC semantic conventions; emitted at RPC end. `server.address`/`server.port` are included when the remote address is available. `OTEL_SEMCONV_STABILITY_OPT_IN=rpc/dup` emits this alongside the old metric. Filtered RPCs are not recorded. |
| `rpc.server.call.duration` | Histogram | s | `rpc.method`, `rpc.system.name=grpc`, `rpc.response.status_code`; custom `WithMetricAttributes`/`WithMetricAttributesFn` attributes | Default new RPC semantic conventions; emitted at RPC end. `OTEL_SEMCONV_STABILITY_OPT_IN=rpc/dup` emits this alongside the old metric. Filtered RPCs are not recorded. |
| `rpc.client.duration` | Histogram | ms | `rpc.system=grpc`, `rpc.service`, `rpc.method` (method segment), `rpc.response.status_code`, `server.address`, `server.port`; custom metric attributes | Only with `OTEL_SEMCONV_STABILITY_OPT_IN=rpc/old` or `rpc/dup`; emitted at RPC end. Address attributes are included when the remote address is available. |
| `rpc.server.duration` | Histogram | ms | `rpc.system=grpc`, `rpc.service`, `rpc.method` (method segment), `rpc.response.status_code`; custom metric attributes | Only with `OTEL_SEMCONV_STABILITY_OPT_IN=rpc/old` or `rpc/dup`; emitted at RPC end. |

## Sources

- `instrumentation/google.golang.org/grpc/otelgrpc/stats_handler.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/config.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/interceptor.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/internal/parse.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/grpc_stats_handler_test.go`
            • v0.71.0.md 3.2 KB 
              ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/google.golang.org/grpc/otelgrpc
version: v0.71.0
scope_name: go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc
commit_sha: c4c6248ec2289133b6a51f554ca9367ece1de8e7
last_verified: 2026-09-03
---

# otelgrpc

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `<package.service>/<method>` (full gRPC method without the leading slash) | Client or server (configurable; defaults to client/server respectively) | New conventions (default): `rpc.method` (fully-qualified method), `rpc.system.name=grpc`, `rpc.response.status_code`; client spans additionally get `server.address` and `server.port` from the remote address, and server spans get them from the local address. Old conventions: `rpc.system=grpc`, `rpc.service`, `rpc.method` (method segment), plus the same response/address attributes. Custom `WithSpanAttributes` are also included. | Spans are gated by `WithFilter`; `OTEL_SEMCONV_STABILITY_OPT_IN=rpc/old` selects old attributes, and `rpc/dup` emits both. Address attributes are emitted only when the corresponding stats address is available. The response status is the canonical gRPC code; server status is Error for Unknown, DeadlineExceeded, Unimplemented, Internal, Unavailable, and DataLoss. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `rpc.client.call.duration` | Histogram | s | `rpc.method`, `rpc.system.name=grpc`, `rpc.response.status_code`, `error.type` (failed RPCs only), `server.address`, `server.port`; custom `WithMetricAttributes`/`WithMetricAttributesFn` attributes | Default new RPC semantic conventions; emitted at RPC end. `server.address`/`server.port` are included when the remote address is available. `OTEL_SEMCONV_STABILITY_OPT_IN=rpc/dup` emits this alongside the old metric. Filtered RPCs are not recorded. |
| `rpc.server.call.duration` | Histogram | s | `rpc.method`, `rpc.system.name=grpc`, `rpc.response.status_code`, `error.type` (failed RPCs only); custom `WithMetricAttributes`/`WithMetricAttributesFn` attributes | Default new RPC semantic conventions; emitted at RPC end. `OTEL_SEMCONV_STABILITY_OPT_IN=rpc/dup` emits this alongside the old metric. Filtered RPCs are not recorded. |
| `rpc.client.duration` | Histogram | ms | `rpc.system=grpc`, `rpc.service`, `rpc.method` (method segment), `rpc.response.status_code`, `server.address`, `server.port`; custom metric attributes | Only with `OTEL_SEMCONV_STABILITY_OPT_IN=rpc/old` or `rpc/dup`; emitted at RPC end. Address attributes are included when the remote address is available. |
| `rpc.server.duration` | Histogram | ms | `rpc.system=grpc`, `rpc.service`, `rpc.method` (method segment), `rpc.response.status_code`; custom metric attributes | Only with `OTEL_SEMCONV_STABILITY_OPT_IN=rpc/old` or `rpc/dup`; emitted at RPC end. |

## Sources

- `instrumentation/google.golang.org/grpc/otelgrpc/stats_handler.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/config.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/interceptor.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/internal/parse.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/grpc_stats_handler_test.go`
            • v0.72.0.md 3.2 KB 
              ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/google.golang.org/grpc/otelgrpc
version: v0.72.0
scope_name: go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc
commit_sha: 0c76f6137a2ceea80984d55e3de165924d823f71
last_verified: 2026-10-03
---

# otelgrpc

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `<package.service>/<method>` (full gRPC method without the leading slash) | Client or server (configurable; defaults to client/server respectively) | New conventions (default): `rpc.method` (fully-qualified method), `rpc.system.name=grpc`, `rpc.response.status_code`; client spans additionally get `server.address` and `server.port` from the remote address, and server spans get them from the local address. Old conventions: `rpc.system=grpc`, `rpc.service`, `rpc.method` (method segment), plus the same response/address attributes. Custom `WithSpanAttributes` are also included. | Spans are gated by `WithFilter`; `OTEL_SEMCONV_STABILITY_OPT_IN=rpc/old` selects old attributes, and `rpc/dup` emits both. Address attributes are emitted only when the corresponding stats address is available. The response status is the canonical gRPC code; server status is Error for Unknown, DeadlineExceeded, Unimplemented, Internal, Unavailable, and DataLoss. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `rpc.client.call.duration` | Histogram | s | `rpc.method`, `rpc.system.name=grpc`, `rpc.response.status_code`, `error.type` (failed RPCs only), `server.address`, `server.port`; custom `WithMetricAttributes`/`WithMetricAttributesFn` attributes | Default new RPC semantic conventions; emitted at RPC end. `server.address`/`server.port` are included when the remote address is available. `OTEL_SEMCONV_STABILITY_OPT_IN=rpc/dup` emits this alongside the old metric. Filtered RPCs are not recorded. |
| `rpc.server.call.duration` | Histogram | s | `rpc.method`, `rpc.system.name=grpc`, `rpc.response.status_code`, `error.type` (failed RPCs only); custom `WithMetricAttributes`/`WithMetricAttributesFn` attributes | Default new RPC semantic conventions; emitted at RPC end. `OTEL_SEMCONV_STABILITY_OPT_IN=rpc/dup` emits this alongside the old metric. Filtered RPCs are not recorded. |
| `rpc.client.duration` | Histogram | ms | `rpc.system=grpc`, `rpc.service`, `rpc.method` (method segment), `rpc.response.status_code`, `server.address`, `server.port`; custom metric attributes | Only with `OTEL_SEMCONV_STABILITY_OPT_IN=rpc/old` or `rpc/dup`; emitted at RPC end. Address attributes are included when the remote address is available. |
| `rpc.server.duration` | Histogram | ms | `rpc.system=grpc`, `rpc.service`, `rpc.method` (method segment), `rpc.response.status_code`; custom metric attributes | Only with `OTEL_SEMCONV_STABILITY_OPT_IN=rpc/old` or `rpc/dup`; emitted at RPC end. |

## Sources

- `instrumentation/google.golang.org/grpc/otelgrpc/stats_handler.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/config.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/interceptor.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/internal/parse.go`
- `instrumentation/google.golang.org/grpc/otelgrpc/grpc_stats_handler_test.go`
      • net
        • http
          • otelhttp
            • v0.65.0.md 2.7 KB 
              ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/net/http/otelhttp
version: v0.65.0
scope_name: go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp
commit_sha: a89d958e7a2575cf539ffca09657cfd90821d6e4
last_verified: 2026-08-11
---

# otelhttp

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| operation (or the formatted operation and route) | SERVER | `http.request.method`, `url.scheme`, `server.address`, optionally `server.port`, `http.request.method_original`, `network.peer.address`, `network.peer.port`, `user_agent.original`, `client.address`, `url.path`, `network.protocol.name`, `network.protocol.version`, `http.route`, `http.response.status_code`, `http.request.body.size`, `http.response.body.size` | Created by `Handler`/`NewMiddleware`; custom `WithSpanNameFormatter` can replace the name. `ReadEvents` and `WriteEvents` opt in via `WithMessageEvents`, adding `read`/`write` events with `http.read_bytes`/`http.wrote_bytes`. `WithPublicEndpointFn` can make the span a new root and link a valid remote context. |
| HTTP {method} | CLIENT | `http.request.method`, `http.request.method_original`, `url.full`, `server.address`, optionally `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `error.type` | Created by `Transport`; response status and status-derived `error.type` are emitted on responses, while transport, response-body read, and protocol-switch write errors set `error.type` and error status. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.server.request.body.size` | Histogram | By | `http.request.method`, `url.scheme`, `server.address`, optionally `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, labeler/custom attributes | Recorded by the handler for every accepted request. |
| `http.server.response.body.size` | Histogram | By | Same as `http.server.request.body.size` | - |
| `http.server.request.duration` | Histogram | s | Same as `http.server.request.body.size` | - |
| `http.client.request.body.size` | Histogram | By | `http.request.method`, `server.address`, `url.scheme`, optionally `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, labeler/custom attributes | Recorded by `Transport`, including round-trip failures. |
| `http.client.request.duration` | Histogram | s | Same as `http.client.request.body.size` | - |

## Sources

- `instrumentation/net/http/otelhttp/handler.go`
- `instrumentation/net/http/otelhttp/transport.go`
- `instrumentation/net/http/otelhttp/config.go`
- `instrumentation/net/http/otelhttp/internal/semconv/server.go`
- `instrumentation/net/http/otelhttp/internal/semconv/client.go`
            • v0.66.0.md 2.7 KB 
              ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/net/http/otelhttp
version: v0.66.0
scope_name: go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp
commit_sha: 07fa42463ccd05b067b0939aa4f1c57673ac6d6d
last_verified: 2026-08-11
---

# otelhttp

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| operation (or the formatted operation and route) | SERVER | `http.request.method`, `url.scheme`, `server.address`, optionally `server.port`, `http.request.method_original`, `network.peer.address`, `network.peer.port`, `user_agent.original`, `client.address`, `url.path`, `network.protocol.name`, `network.protocol.version`, `http.route`, `http.response.status_code`, `http.request.body.size`, `http.response.body.size` | Created by `Handler`/`NewMiddleware`; custom `WithSpanNameFormatter` can replace the name. `ReadEvents` and `WriteEvents` opt in via `WithMessageEvents`, adding `read`/`write` events with `http.read_bytes`/`http.wrote_bytes`. `WithPublicEndpointFn` can make the span a new root and link a valid remote context. |
| HTTP {method} | CLIENT | `http.request.method`, `http.request.method_original`, `url.full`, `server.address`, optionally `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `error.type` | Created by `Transport`; response status and status-derived `error.type` are emitted on responses, while transport, response-body read, and protocol-switch write errors set `error.type` and error status. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.server.request.body.size` | Histogram | By | `http.request.method`, `url.scheme`, `server.address`, optionally `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, labeler/custom attributes | Recorded by the handler for every accepted request. |
| `http.server.response.body.size` | Histogram | By | Same as `http.server.request.body.size` | - |
| `http.server.request.duration` | Histogram | s | Same as `http.server.request.body.size` | - |
| `http.client.request.body.size` | Histogram | By | `http.request.method`, `server.address`, `url.scheme`, optionally `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, labeler/custom attributes | Recorded by `Transport`, including round-trip failures. |
| `http.client.request.duration` | Histogram | s | Same as `http.client.request.body.size` | - |

## Sources

- `instrumentation/net/http/otelhttp/handler.go`
- `instrumentation/net/http/otelhttp/transport.go`
- `instrumentation/net/http/otelhttp/config.go`
- `instrumentation/net/http/otelhttp/internal/semconv/server.go`
- `instrumentation/net/http/otelhttp/internal/semconv/client.go`
            • v0.67.0.md 2.7 KB 
              ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/net/http/otelhttp
version: v0.67.0
scope_name: go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp
commit_sha: d8dabf67361a4619c353ad0637432f3d0d16ba63
last_verified: 2026-08-11
---

# otelhttp

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| operation (or the formatted operation and route) | SERVER | `http.request.method`, `url.scheme`, `server.address`, optionally `server.port`, `http.request.method_original`, `network.peer.address`, `network.peer.port`, `user_agent.original`, `client.address`, `url.path`, `network.protocol.name`, `network.protocol.version`, `http.route`, `http.response.status_code`, `http.request.body.size`, `http.response.body.size` | Created by `Handler`/`NewMiddleware`; custom `WithSpanNameFormatter` can replace the name. `ReadEvents` and `WriteEvents` opt in via `WithMessageEvents`, adding `read`/`write` events with `http.read_bytes`/`http.wrote_bytes`. `WithPublicEndpointFn` can make the span a new root and link a valid remote context. |
| HTTP {method} | CLIENT | `http.request.method`, `http.request.method_original`, `url.full`, `server.address`, optionally `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `error.type` | Created by `Transport`; response status and status-derived `error.type` are emitted on responses, while transport, response-body read, and protocol-switch write errors set `error.type` and error status. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.server.request.body.size` | Histogram | By | `http.request.method`, `url.scheme`, `server.address`, optionally `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, labeler/custom attributes | Recorded by the handler for every accepted request. |
| `http.server.response.body.size` | Histogram | By | Same as `http.server.request.body.size` | - |
| `http.server.request.duration` | Histogram | s | Same as `http.server.request.body.size` | - |
| `http.client.request.body.size` | Histogram | By | `http.request.method`, `server.address`, `url.scheme`, optionally `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, labeler/custom attributes | Recorded by `Transport`, including round-trip failures. |
| `http.client.request.duration` | Histogram | s | Same as `http.client.request.body.size` | - |

## Sources

- `instrumentation/net/http/otelhttp/handler.go`
- `instrumentation/net/http/otelhttp/transport.go`
- `instrumentation/net/http/otelhttp/config.go`
- `instrumentation/net/http/otelhttp/internal/semconv/server.go`
- `instrumentation/net/http/otelhttp/internal/semconv/client.go`
            • v0.68.0.md 2.7 KB 
              ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/net/http/otelhttp
version: v0.68.0
scope_name: go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp
commit_sha: 45977a4b9cf4a60effd1ee07367043f7e9bcae66
last_verified: 2026-08-06
---

# otelhttp

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| operation (the `operation` argument) | SERVER | `http.request.method`, `url.scheme`, `server.address`, optionally `server.port`, `http.request.method_original`, `network.peer.address`, `network.peer.port`, `user_agent.original`, `client.address`, `url.path`, `network.protocol.name`, `network.protocol.version`, `http.route`, `http.response.status_code`, `http.request.body.size`, `http.response.body.size` | Server span; default name is the configured operation (custom `WithSpanNameFormatter` can replace it). `ReadEvents` and `WriteEvents` opt-in via `WithMessageEvents` add `read`/`write` events with `http.read_bytes`/`http.wrote_bytes`. Public endpoints configured with `WithPublicEndpointFn` create a new root and link a valid remote context. |
| HTTP {method} | CLIENT | `http.request.method`, `http.request.method_original`, `url.full`, `server.address`, optionally `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `error.type` | Created by `Transport`; response status and status-derived `error.type` are set on successful responses; transport/read/write errors set `error.type` and error status. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.server.request.body.size` | Histogram | By | `http.request.method`, `url.scheme`, `server.address`, optionally `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, labeler/custom attributes | Recorded by `Handler` for every accepted request. |
| `http.server.response.body.size` | Histogram | By | Same as `http.server.request.body.size` | - |
| `http.server.request.duration` | Histogram | s | Same as `http.server.request.body.size` | - |
| `http.client.request.body.size` | Histogram | By | `http.request.method`, `server.address`, `url.scheme`, optionally `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `error.type` on transport error, labeler/custom attributes | Recorded by `Transport`, including failures. |
| `http.client.request.duration` | Histogram | s | Same as `http.client.request.body.size` | - |

## Sources

- `instrumentation/net/http/otelhttp/handler.go`
- `instrumentation/net/http/otelhttp/transport.go`
- `instrumentation/net/http/otelhttp/config.go`
- `instrumentation/net/http/otelhttp/internal/semconv/server.go`
- `instrumentation/net/http/otelhttp/internal/semconv/client.go`
            • v0.69.0.md 2.7 KB 
              ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/net/http/otelhttp
version: v0.69.0
scope_name: go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp
commit_sha: 03b2bcdb54b3dde73c9ff91ae216aec262f6c8f5
last_verified: 2026-08-06
---

# otelhttp

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `{method}` or `{method} {route}` | SERVER | `http.request.method`, `url.scheme`, `server.address`, optionally `server.port`, `http.request.method_original`, `network.peer.address`, `network.peer.port`, `user_agent.original`, `client.address`, `url.path`, `network.protocol.name`, `network.protocol.version`, `http.route`, `http.response.status_code`, `http.request.body.size`, `http.response.body.size` | Default semantic-convention name; custom `WithSpanNameFormatter` can replace it. `ReadEvents` and `WriteEvents` opt-in via `WithMessageEvents` add `read`/`write` events with `http.read_bytes`/`http.wrote_bytes`. Public endpoints configured with `WithPublicEndpointFn` create a new root and link a valid remote context. |
| HTTP {method} | CLIENT | `http.request.method`, `http.request.method_original`, `url.full`, `server.address`, optionally `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `error.type` | Created by `Transport`; response status and status-derived `error.type` are set on successful responses; transport/read/write errors set `error.type` and error status. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.server.request.body.size` | Histogram | By | `http.request.method`, `url.scheme`, `server.address`, optionally `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, labeler/custom attributes | Recorded by `Handler` for every accepted request. |
| `http.server.response.body.size` | Histogram | By | Same as `http.server.request.body.size` | - |
| `http.server.request.duration` | Histogram | s | Same as `http.server.request.body.size` | - |
| `http.client.request.body.size` | Histogram | By | `http.request.method`, `server.address`, `url.scheme`, optionally `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `error.type` on transport error, labeler/custom attributes | Recorded by `Transport`, including failures. |
| `http.client.request.duration` | Histogram | s | Same as `http.client.request.body.size` | - |

## Sources

- `instrumentation/net/http/otelhttp/handler.go`
- `instrumentation/net/http/otelhttp/transport.go`
- `instrumentation/net/http/otelhttp/config.go`
- `instrumentation/net/http/otelhttp/internal/semconv/server.go`
- `instrumentation/net/http/otelhttp/internal/semconv/client.go`
            • v0.70.0.md 2.8 KB 
              ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/net/http/otelhttp
version: v0.70.0
scope_name: go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp
commit_sha: c8a87a60ba1b3374fd16df11fc3eeae6c41abbc9
last_verified: 2026-08-06
---

# otelhttp

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `{method}` or `{method} {route}` | SERVER | `http.request.method`, `url.scheme`, `server.address`, optionally `server.port`, `http.request.method_original`, `network.peer.address`, `network.peer.port`, `user_agent.original`, `client.address`, `url.path`, `network.protocol.name`, `network.protocol.version`, `http.route`, `http.response.status_code`, `http.request.body.size`, `http.response.body.size` | Default semantic-convention name; custom `WithSpanNameFormatter` can replace it. `ReadEvents` and `WriteEvents` opt-in via `WithMessageEvents` add `read`/`write` events with `http.read_bytes`/`http.wrote_bytes`. Public endpoints configured with `WithPublicEndpointFn` create a new root and link a valid remote context. |
| HTTP {method} | CLIENT | `http.request.method`, `http.request.method_original`, `url.full`, `server.address`, optionally `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `error.type` | Created by `Transport`; negotiated response protocol name/version are added when available. Response status and status-derived `error.type` are set on successful responses; transport/read/write errors set `error.type` and error status. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.server.request.body.size` | Histogram | By | `http.request.method`, `url.scheme`, `server.address`, optionally `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, labeler/custom attributes | Recorded by `Handler` for every accepted request. |
| `http.server.response.body.size` | Histogram | By | Same as `http.server.request.body.size` | - |
| `http.server.request.duration` | Histogram | s | Same as `http.server.request.body.size` | - |
| `http.client.request.body.size` | Histogram | By | `http.request.method`, `server.address`, `url.scheme`, optionally `server.port`, negotiated `network.protocol.name`, negotiated `network.protocol.version`, `http.response.status_code`, `error.type` on transport error, labeler/custom attributes | Recorded by `Transport`, including failures. |
| `http.client.request.duration` | Histogram | s | Same as `http.client.request.body.size` | - |

## Sources

- `instrumentation/net/http/otelhttp/handler.go`
- `instrumentation/net/http/otelhttp/transport.go`
- `instrumentation/net/http/otelhttp/config.go`
- `instrumentation/net/http/otelhttp/internal/semconv/server.go`
- `instrumentation/net/http/otelhttp/internal/semconv/client.go`
            • v0.71.0.md 2.8 KB 
              ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/net/http/otelhttp
version: v0.71.0
scope_name: go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp
commit_sha: c4c6248ec2289133b6a51f554ca9367ece1de8e7
last_verified: 2026-09-03
---

# otelhttp

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `{method}` or `{method} {route}` | SERVER | `http.request.method`, `url.scheme`, `server.address`, optionally `server.port`, `http.request.method_original`, `network.peer.address`, `network.peer.port`, `user_agent.original`, `client.address`, `url.path`, `network.protocol.name`, `network.protocol.version`, `http.route`, `http.response.status_code`, `http.request.body.size`, `http.response.body.size` | Default semantic-convention name; custom `WithSpanNameFormatter` can replace it. `ReadEvents` and `WriteEvents` opt-in via `WithMessageEvents` add `read`/`write` events with `http.read_bytes`/`http.wrote_bytes`. Public endpoints configured with `WithPublicEndpointFn` create a new root and link a valid remote context. |
| HTTP {method} | CLIENT | `http.request.method`, `http.request.method_original`, `url.full`, `server.address`, optionally `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `error.type` | Created by `Transport`; negotiated response protocol name/version are added when available. Response status and status-derived `error.type` are set on successful responses; transport/read/write errors set `error.type` and error status. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.server.request.body.size` | Histogram | By | `http.request.method`, `url.scheme`, `server.address`, optionally `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, labeler/custom attributes | Recorded by `Handler` for every accepted request. |
| `http.server.response.body.size` | Histogram | By | Same as `http.server.request.body.size` | - |
| `http.server.request.duration` | Histogram | s | Same as `http.server.request.body.size` | - |
| `http.client.request.body.size` | Histogram | By | `http.request.method`, `server.address`, `url.scheme`, optionally `server.port`, negotiated `network.protocol.name`, negotiated `network.protocol.version`, `http.response.status_code`, `error.type` on transport error, labeler/custom attributes | Recorded by `Transport`, including failures. |
| `http.client.request.duration` | Histogram | s | Same as `http.client.request.body.size` | - |

## Sources

- `instrumentation/net/http/otelhttp/handler.go`
- `instrumentation/net/http/otelhttp/transport.go`
- `instrumentation/net/http/otelhttp/config.go`
- `instrumentation/net/http/otelhttp/internal/semconv/server.go`
- `instrumentation/net/http/otelhttp/internal/semconv/client.go`
            • v0.72.0.md 3.1 KB 
              ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/net/http/otelhttp
version: v0.72.0
scope_name: go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp
commit_sha: 0c76f6137a2ceea80984d55e3de165924d823f71
last_verified: 2026-10-03
---

# otelhttp

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `{method}` or `{method} {route}` | SERVER | `http.request.method`, `url.scheme`, `server.address`, optionally `server.port`, `http.request.method_original`, `network.peer.address`, `network.peer.port`, `user_agent.original`, `client.address`, `url.path`, `network.protocol.name`, `network.protocol.version`, `http.route`, `http.response.status_code`, `http.request.body.size`, `http.response.body.size` | Default semantic-convention name; custom `WithSpanNameFormatter` can replace it. `ReadEvents` and `WriteEvents` opt-in via `WithMessageEvents` add attribute-less `read`/`write` events (the legacy `http.read_bytes`/`http.wrote_bytes` event attributes are no longer emitted). Public endpoints configured with `WithPublicEndpointFn` create a new root and link a valid remote context. |
| HTTP {method} | CLIENT | `http.request.method`, `http.request.method_original`, `url.full`, `server.address`, optionally `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `error.type` | Created by `Transport`; negotiated response protocol name/version are added when available. Response status and status-derived `error.type` are set on successful responses; transport/read/write errors set `error.type` and error status. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.server.request.body.size` | Histogram | By | `http.request.method`, `url.scheme`, `server.address`, optionally `server.port`, `network.protocol.name`, `network.protocol.version`, `http.response.status_code`, `http.route`, labeler/custom attributes | Recorded by `Handler` for every accepted request. |
| `http.server.response.body.size` | Histogram | By | Same as `http.server.request.body.size` | - |
| `http.server.request.duration` | Histogram | s | Same as `http.server.request.body.size` | - |
| `http.client.request.body.size` | Histogram | By | `http.request.method`, `server.address`, `url.scheme`, optionally `server.port`, negotiated `network.protocol.name`, negotiated `network.protocol.version`, `http.response.status_code`, `error.type` on transport error, client-labeler/custom attributes | Recorded by `Transport`, including failures. Extra attributes come only from the client labeler (`ContextWithClientLabeler`) or `WithMetricAttributesFn`; server-side `Labeler` attributes such as `http.route` are no longer added. |
| `http.client.request.duration` | Histogram | s | Same as `http.client.request.body.size` | - |

## Sources

- `instrumentation/net/http/otelhttp/handler.go`
- `instrumentation/net/http/otelhttp/transport.go`
- `instrumentation/net/http/otelhttp/config.go`
- `instrumentation/net/http/otelhttp/labeler.go`
- `CHANGELOG.md` (0.72.0)
- `instrumentation/net/http/otelhttp/internal/semconv/server.go`
- `instrumentation/net/http/otelhttp/internal/semconv/client.go`
      • runtime
        • v0.65.0.md 2.7 KB 
          ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/runtime
version: v0.65.0
scope_name: go.opentelemetry.io/contrib/instrumentation/runtime
commit_sha: a89d958e7a2575cf539ffca09657cfd90821d6e4
last_verified: 2026-08-11
---

# Go runtime instrumentation

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| go.memory.used | UpDownCounter | By | go.memory.type (`stack`, `other`) | - |
| go.memory.limit | UpDownCounter | By | - | Only observed when a Go runtime memory limit exists. |
| go.memory.allocated | Counter | By | - | - |
| go.memory.allocations | Counter | {allocation} | - | - |
| go.memory.gc.goal | UpDownCounter | By | - | - |
| go.goroutine.count | UpDownCounter | {goroutine} | - | - |
| go.processor.limit | UpDownCounter | {thread} | - | - |
| go.config.gogc | UpDownCounter | % | - | - |
| go.schedule.duration | Histogram | s | - | - |
| runtime.uptime | Counter | ms | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.goroutines | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.cgo.calls | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_alloc | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_idle | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_inuse | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_objects | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_released | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_sys | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.live_objects | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.lookups | Counter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.gc.count | Counter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.gc.pause_total_ns | Counter | ns | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.gc.pause_ns | Histogram | ns | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |

## Sources

- `instrumentation/runtime/runtime.go`
- `instrumentation/runtime/producer.go`
- `instrumentation/runtime/internal/deprecatedruntime/runtime.go`
- `instrumentation/runtime/internal/x/x.go`
- `instrumentation/runtime/version.go`
        • v0.66.0.md 2.7 KB 
          ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/runtime
version: v0.66.0
scope_name: go.opentelemetry.io/contrib/instrumentation/runtime
commit_sha: 07fa42463ccd05b067b0939aa4f1c57673ac6d6d
last_verified: 2026-08-11
---

# Go runtime instrumentation

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| go.memory.used | UpDownCounter | By | go.memory.type (`stack`, `other`) | - |
| go.memory.limit | UpDownCounter | By | - | Only observed when a Go runtime memory limit exists. |
| go.memory.allocated | Counter | By | - | - |
| go.memory.allocations | Counter | {allocation} | - | - |
| go.memory.gc.goal | UpDownCounter | By | - | - |
| go.goroutine.count | UpDownCounter | {goroutine} | - | - |
| go.processor.limit | UpDownCounter | {thread} | - | - |
| go.config.gogc | UpDownCounter | % | - | - |
| go.schedule.duration | Histogram | s | - | - |
| runtime.uptime | Counter | ms | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.goroutines | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.cgo.calls | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_alloc | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_idle | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_inuse | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_objects | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_released | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_sys | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.live_objects | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.lookups | Counter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.gc.count | Counter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.gc.pause_total_ns | Counter | ns | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.gc.pause_ns | Histogram | ns | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |

## Sources

- `instrumentation/runtime/runtime.go`
- `instrumentation/runtime/producer.go`
- `instrumentation/runtime/internal/deprecatedruntime/runtime.go`
- `instrumentation/runtime/internal/x/x.go`
- `instrumentation/runtime/version.go`
        • v0.67.0.md 2.7 KB 
          ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/runtime
version: v0.67.0
scope_name: go.opentelemetry.io/contrib/instrumentation/runtime
commit_sha: d8dabf67361a4619c353ad0637432f3d0d16ba63
last_verified: 2026-08-11
---

# Go runtime instrumentation

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| go.memory.used | UpDownCounter | By | go.memory.type (`stack`, `other`) | - |
| go.memory.limit | UpDownCounter | By | - | Only observed when a Go runtime memory limit exists. |
| go.memory.allocated | Counter | By | - | - |
| go.memory.allocations | Counter | {allocation} | - | - |
| go.memory.gc.goal | UpDownCounter | By | - | - |
| go.goroutine.count | UpDownCounter | {goroutine} | - | - |
| go.processor.limit | UpDownCounter | {thread} | - | - |
| go.config.gogc | UpDownCounter | % | - | - |
| go.schedule.duration | Histogram | s | - | - |
| runtime.uptime | Counter | ms | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.goroutines | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.cgo.calls | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_alloc | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_idle | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_inuse | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_objects | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_released | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_sys | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.live_objects | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.lookups | Counter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.gc.count | Counter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.gc.pause_total_ns | Counter | ns | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.gc.pause_ns | Histogram | ns | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |

## Sources

- `instrumentation/runtime/runtime.go`
- `instrumentation/runtime/producer.go`
- `instrumentation/runtime/internal/deprecatedruntime/runtime.go`
- `instrumentation/runtime/internal/x/x.go`
- `instrumentation/runtime/version.go`
        • v0.68.0.md 2.7 KB 
          ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/runtime
version: v0.68.0
scope_name: go.opentelemetry.io/contrib/instrumentation/runtime
commit_sha: 45977a4b9cf4a60effd1ee07367043f7e9bcae66
last_verified: 2026-08-06
---

# Go runtime instrumentation

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| go.memory.used | UpDownCounter | By | go.memory.type (`stack`, `other`) | - |
| go.memory.limit | UpDownCounter | By | - | Only observed when a Go runtime memory limit exists. |
| go.memory.allocated | Counter | By | - | - |
| go.memory.allocations | Counter | {allocation} | - | - |
| go.memory.gc.goal | UpDownCounter | By | - | - |
| go.goroutine.count | UpDownCounter | {goroutine} | - | - |
| go.processor.limit | UpDownCounter | {thread} | - | - |
| go.config.gogc | UpDownCounter | % | - | - |
| go.schedule.duration | Histogram | s | - | - |
| runtime.uptime | Counter | ms | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.goroutines | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.cgo.calls | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_alloc | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_idle | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_inuse | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_objects | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_released | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_sys | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.live_objects | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.lookups | Counter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.gc.count | Counter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.gc.pause_total_ns | Counter | ns | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.gc.pause_ns | Histogram | ns | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |

## Sources

- `instrumentation/runtime/runtime.go`
- `instrumentation/runtime/producer.go`
- `instrumentation/runtime/internal/deprecatedruntime/runtime.go`
- `instrumentation/runtime/internal/x/x.go`
- `instrumentation/runtime/version.go`
        • v0.69.0.md 2.7 KB 
          ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/runtime
version: v0.69.0
scope_name: go.opentelemetry.io/contrib/instrumentation/runtime
commit_sha: 03b2bcdb54b3dde73c9ff91ae216aec262f6c8f5
last_verified: 2026-08-06
---

# Go runtime instrumentation

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| go.memory.used | UpDownCounter | By | go.memory.type (`stack`, `other`) | - |
| go.memory.limit | UpDownCounter | By | - | Only observed when a Go runtime memory limit exists. |
| go.memory.allocated | Counter | By | - | - |
| go.memory.allocations | Counter | {allocation} | - | - |
| go.memory.gc.goal | UpDownCounter | By | - | - |
| go.goroutine.count | UpDownCounter | {goroutine} | - | - |
| go.processor.limit | UpDownCounter | {thread} | - | - |
| go.config.gogc | UpDownCounter | % | - | - |
| go.schedule.duration | Histogram | s | - | - |
| runtime.uptime | Counter | ms | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.goroutines | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.cgo.calls | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_alloc | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_idle | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_inuse | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_objects | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_released | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_sys | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.live_objects | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.lookups | Counter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.gc.count | Counter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.gc.pause_total_ns | Counter | ns | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.gc.pause_ns | Histogram | ns | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |

## Sources

- `instrumentation/runtime/runtime.go`
- `instrumentation/runtime/producer.go`
- `instrumentation/runtime/internal/deprecatedruntime/runtime.go`
- `instrumentation/runtime/internal/x/x.go`
- `instrumentation/runtime/version.go`
        • v0.70.0.md 2.7 KB 
          ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/runtime
version: v0.70.0
scope_name: go.opentelemetry.io/contrib/instrumentation/runtime
commit_sha: c8a87a60ba1b3374fd16df11fc3eeae6c41abbc9
last_verified: 2026-08-06
---

# Go runtime instrumentation

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| go.memory.used | UpDownCounter | By | go.memory.type (`stack`, `other`) | - |
| go.memory.limit | UpDownCounter | By | - | Only observed when a Go runtime memory limit exists. |
| go.memory.allocated | Counter | By | - | - |
| go.memory.allocations | Counter | {allocation} | - | - |
| go.memory.gc.goal | UpDownCounter | By | - | - |
| go.goroutine.count | UpDownCounter | {goroutine} | - | - |
| go.processor.limit | UpDownCounter | {thread} | - | - |
| go.config.gogc | UpDownCounter | % | - | - |
| go.schedule.duration | Histogram | s | - | - |
| runtime.uptime | Counter | ms | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.goroutines | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.cgo.calls | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_alloc | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_idle | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_inuse | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_objects | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_released | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_sys | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.live_objects | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.lookups | Counter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.gc.count | Counter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.gc.pause_total_ns | Counter | ns | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.gc.pause_ns | Histogram | ns | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |

## Sources

- `instrumentation/runtime/runtime.go`
- `instrumentation/runtime/producer.go`
- `instrumentation/runtime/internal/deprecatedruntime/runtime.go`
- `instrumentation/runtime/internal/x/x.go`
- `instrumentation/runtime/version.go`
        • v0.71.0.md 2.7 KB 
          ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/runtime
version: v0.71.0
scope_name: go.opentelemetry.io/contrib/instrumentation/runtime
commit_sha: c4c6248ec2289133b6a51f554ca9367ece1de8e7
last_verified: 2026-09-03
---

# Go runtime instrumentation

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| go.memory.used | UpDownCounter | By | go.memory.type (`stack`, `other`) | - |
| go.memory.limit | UpDownCounter | By | - | Only observed when a Go runtime memory limit exists. |
| go.memory.allocated | Counter | By | - | - |
| go.memory.allocations | Counter | {allocation} | - | - |
| go.memory.gc.goal | UpDownCounter | By | - | - |
| go.goroutine.count | UpDownCounter | {goroutine} | - | - |
| go.processor.limit | UpDownCounter | {thread} | - | - |
| go.config.gogc | UpDownCounter | % | - | - |
| go.schedule.duration | Histogram | s | - | - |
| runtime.uptime | Counter | ms | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.goroutines | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.cgo.calls | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_alloc | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_idle | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_inuse | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_objects | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_released | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_sys | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.live_objects | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.lookups | Counter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.gc.count | Counter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.gc.pause_total_ns | Counter | ns | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.gc.pause_ns | Histogram | ns | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |

## Sources

- `instrumentation/runtime/runtime.go`
- `instrumentation/runtime/producer.go`
- `instrumentation/runtime/internal/deprecatedruntime/runtime.go`
- `instrumentation/runtime/internal/x/x.go`
- `instrumentation/runtime/version.go`
        • v0.72.0.md 2.8 KB 
          ---
repo: open-telemetry/opentelemetry-go-contrib
path: instrumentation/runtime
version: v0.72.0
scope_name: go.opentelemetry.io/contrib/instrumentation/runtime
commit_sha: 0c76f6137a2ceea80984d55e3de165924d823f71
last_verified: 2026-10-03
---

# Go runtime instrumentation

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| go.memory.used | UpDownCounter | By | go.memory.type (`stack`, `other`) | - |
| go.memory.limit | UpDownCounter | By | - | Only observed when a Go runtime memory limit exists. |
| go.memory.allocated | Counter | By | - | - |
| go.memory.allocations | Counter | {allocation} | - | - |
| go.memory.gc.goal | UpDownCounter | By | - | - |
| go.goroutine.count | UpDownCounter | {goroutine} | - | - |
| go.processor.limit | UpDownCounter | {thread} | - | - |
| go.config.gogc | UpDownCounter | % | - | - |
| go.schedule.duration | Histogram | s | - | Only from the `runtime.NewProducer` producer when registered with a metric reader; `runtime.Start` does not emit it. |
| runtime.uptime | Counter | ms | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.goroutines | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.cgo.calls | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_alloc | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_idle | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_inuse | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_objects | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_released | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.heap_sys | UpDownCounter | By | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.live_objects | UpDownCounter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.mem.lookups | Counter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.gc.count | Counter | - | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.gc.pause_total_ns | Counter | ns | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |
| process.runtime.go.gc.pause_ns | Histogram | ns | - | Only when `OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true`. |

## Sources

- `instrumentation/runtime/runtime.go`
- `instrumentation/runtime/producer.go`
- `instrumentation/runtime/internal/deprecatedruntime/runtime.go`
- `instrumentation/runtime/internal/x/x.go`
- `instrumentation/runtime/version.go`
  • opentelemetry-java-instrumentation
    • instrumentation
      • grpc-1.6
        • v2.28.1.md 3.1 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/grpc-1.6
version: v2.28.1
scope_name: io.opentelemetry.grpc-1.6
commit_sha: 7ad453a58de282ea04fd88f4178d70a65468b93c
last_verified: 2026-07-03
---

# gRPC

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `{service}/{method}` | CLIENT | `rpc.system.name` / legacy `rpc.system`; `rpc.service`; `rpc.method`; `server.address`; `server.port`; network attributes; `rpc.response.status_code` / legacy `rpc.grpc.status_code`; configured request metadata attributes | Stable and legacy RPC semantic conventions are selected by semconv stability configuration; metadata capture requires client request-metadata selector. |
| `{service}/{method}` | SERVER | `rpc.system.name` / legacy `rpc.system`; `rpc.service`; `rpc.method`; `server.address`; `server.port`; network attributes; `rpc.response.status_code` / legacy `rpc.grpc.status_code`; configured request metadata attributes | Stable and legacy RPC semantic conventions are selected by semconv stability configuration; metadata capture requires server request-metadata selector. |
| `message` | — | `message.type` (`SENT`/`RECEIVED`), `message.id` | Event controlled by `otel.instrumentation.grpc.emit-message-events` (default true). |
| `{service}/{method}` | SERVER span attributes | `grpc.canceled`, `grpc.received.message_count`, `grpc.sent.message_count` | Experimental attributes require `otel.instrumentation.grpc.experimental-span-attributes`; canceled attribute only on cancellation. |
| `{service}/{method}` | CLIENT span attributes | `grpc.received.message_count`, `grpc.sent.message_count` | Experimental attributes require `otel.instrumentation.grpc.experimental-span-attributes`. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `rpc.client.call.duration` | Histogram | s | RPC client attributes | Stable RPC metric; legacy metric may also emit depending on semconv stability configuration. |
| `rpc.server.call.duration` | Histogram | s | RPC server attributes | Stable RPC metric; legacy metric may also emit depending on semconv stability configuration. |
| `rpc.client.request.size` | Histogram | By convention | RPC client attributes | Experimental operation size metric. |
| `rpc.client.response.size` | Histogram | By convention | RPC client attributes | Experimental operation size metric. |
| `rpc.server.request.size` | Histogram | By convention | RPC server attributes | Experimental operation size metric. |
| `rpc.server.response.size` | Histogram | By convention | RPC server attributes | Experimental operation size metric. |

## Sources

- `instrumentation/grpc-1.6/metadata.yaml`
- `instrumentation/grpc-1.6/library/src/main/java/io/opentelemetry/instrumentation/grpc/v1_6/GrpcTelemetryBuilder.java`
- `instrumentation/grpc-1.6/library/src/main/java/io/opentelemetry/instrumentation/grpc/v1_6/GrpcAttributesExtractor.java`
- `instrumentation/grpc-1.6/library/src/main/java/io/opentelemetry/instrumentation/grpc/v1_6/TracingClientInterceptor.java`
- `instrumentation/grpc-1.6/library/src/main/java/io/opentelemetry/instrumentation/grpc/v1_6/TracingServerInterceptor.java`
        • v2.29.0.md 3.1 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/grpc-1.6
version: v2.29.0
scope_name: io.opentelemetry.grpc-1.6
commit_sha: c215cb489a90d95c2ea5808fbdcd2f7d81d2f2ae
last_verified: 2026-07-03
---

# gRPC

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `{service}/{method}` | CLIENT | `rpc.system.name` / legacy `rpc.system`; `rpc.service`; `rpc.method`; `server.address`; `server.port`; network attributes; `rpc.response.status_code` / legacy `rpc.grpc.status_code`; configured request metadata attributes | Stable and legacy RPC semantic conventions are selected by semconv stability configuration; metadata capture requires client request-metadata selector. |
| `{service}/{method}` | SERVER | `rpc.system.name` / legacy `rpc.system`; `rpc.service`; `rpc.method`; `server.address`; `server.port`; network attributes; `rpc.response.status_code` / legacy `rpc.grpc.status_code`; configured request metadata attributes | Stable and legacy RPC semantic conventions are selected by semconv stability configuration; metadata capture requires server request-metadata selector. |
| `message` | — | `message.type` (`SENT`/`RECEIVED`), `message.id` | Event controlled by `otel.instrumentation.grpc.emit-message-events` (default true). |
| `{service}/{method}` | SERVER span attributes | `grpc.canceled`, `grpc.received.message_count`, `grpc.sent.message_count` | Experimental attributes require `otel.instrumentation.grpc.experimental-span-attributes`; canceled attribute only on cancellation. |
| `{service}/{method}` | CLIENT span attributes | `grpc.received.message_count`, `grpc.sent.message_count` | Experimental attributes require `otel.instrumentation.grpc.experimental-span-attributes`. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `rpc.client.call.duration` | Histogram | s | RPC client attributes | Stable RPC metric; legacy metric may also emit depending on semconv stability configuration. |
| `rpc.server.call.duration` | Histogram | s | RPC server attributes | Stable RPC metric; legacy metric may also emit depending on semconv stability configuration. |
| `rpc.client.request.size` | Histogram | By convention | RPC client attributes | Experimental operation size metric. |
| `rpc.client.response.size` | Histogram | By convention | RPC client attributes | Experimental operation size metric. |
| `rpc.server.request.size` | Histogram | By convention | RPC server attributes | Experimental operation size metric. |
| `rpc.server.response.size` | Histogram | By convention | RPC server attributes | Experimental operation size metric. |

## Sources

- `instrumentation/grpc-1.6/metadata.yaml`
- `instrumentation/grpc-1.6/library/src/main/java/io/opentelemetry/instrumentation/grpc/v1_6/GrpcTelemetryBuilder.java`
- `instrumentation/grpc-1.6/library/src/main/java/io/opentelemetry/instrumentation/grpc/v1_6/GrpcAttributesExtractor.java`
- `instrumentation/grpc-1.6/library/src/main/java/io/opentelemetry/instrumentation/grpc/v1_6/TracingClientInterceptor.java`
- `instrumentation/grpc-1.6/library/src/main/java/io/opentelemetry/instrumentation/grpc/v1_6/TracingServerInterceptor.java`
        • v2.30.0.md 3.1 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/grpc-1.6
version: v2.30.0
scope_name: io.opentelemetry.grpc-1.6
commit_sha: 080c1d32ca676ba7b0210c21b60cce8e7ac39058
last_verified: null
---

# gRPC

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `{service}/{method}` | CLIENT | `rpc.system.name` / legacy `rpc.system`; `rpc.service`; `rpc.method`; `server.address`; `server.port`; network attributes; `rpc.response.status_code` / legacy `rpc.grpc.status_code`; configured request metadata attributes | Stable and legacy RPC semantic conventions are selected by semconv stability configuration; metadata capture requires client request-metadata selector. |
| `{service}/{method}` | SERVER | `rpc.system.name` / legacy `rpc.system`; `rpc.service`; `rpc.method`; `server.address`; `server.port`; network attributes; `rpc.response.status_code` / legacy `rpc.grpc.status_code`; configured request metadata attributes | Stable and legacy RPC semantic conventions are selected by semconv stability configuration; metadata capture requires server request-metadata selector. |
| `message` | — | `message.type` (`SENT`/`RECEIVED`), `message.id` | Event controlled by `otel.instrumentation.grpc.emit-message-events` (default true). |
| `{service}/{method}` | SERVER span attributes | `grpc.canceled`, `grpc.received.message_count`, `grpc.sent.message_count` | Experimental attributes require `otel.instrumentation.grpc.experimental-span-attributes`; canceled attribute only on cancellation. |
| `{service}/{method}` | CLIENT span attributes | `grpc.received.message_count`, `grpc.sent.message_count` | Experimental attributes require `otel.instrumentation.grpc.experimental-span-attributes`. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `rpc.client.call.duration` | Histogram | s | RPC client attributes | Stable RPC metric; legacy metric may also emit depending on semconv stability configuration. |
| `rpc.server.call.duration` | Histogram | s | RPC server attributes | Stable RPC metric; legacy metric may also emit depending on semconv stability configuration. |
| `rpc.client.request.size` | Histogram | By convention | RPC client attributes | Experimental operation size metric. |
| `rpc.client.response.size` | Histogram | By convention | RPC client attributes | Experimental operation size metric. |
| `rpc.server.request.size` | Histogram | By convention | RPC server attributes | Experimental operation size metric. |
| `rpc.server.response.size` | Histogram | By convention | RPC server attributes | Experimental operation size metric. |

## Sources

- `instrumentation/grpc-1.6/metadata.yaml`
- `instrumentation/grpc-1.6/library/src/main/java/io/opentelemetry/instrumentation/grpc/v1_6/GrpcTelemetryBuilder.java`
- `instrumentation/grpc-1.6/library/src/main/java/io/opentelemetry/instrumentation/grpc/v1_6/GrpcAttributesExtractor.java`
- `instrumentation/grpc-1.6/library/src/main/java/io/opentelemetry/instrumentation/grpc/v1_6/TracingClientInterceptor.java`
- `instrumentation/grpc-1.6/library/src/main/java/io/opentelemetry/instrumentation/grpc/v1_6/TracingServerInterceptor.java`
        • v2.31.0.md 3.1 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/grpc-1.6
version: v2.31.0
scope_name: io.opentelemetry.grpc-1.6
commit_sha: 18da99bef6a5f1becdeb8091136f12c43742b9b7
last_verified: null
---

# gRPC

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `{service}/{method}` | CLIENT | `rpc.system.name` / legacy `rpc.system`; `rpc.service`; `rpc.method`; `server.address`; `server.port`; network attributes; `rpc.response.status_code` / legacy `rpc.grpc.status_code`; configured request metadata attributes | Stable and legacy RPC semantic conventions are selected by semconv stability configuration; metadata capture requires client request-metadata selector. |
| `{service}/{method}` | SERVER | `rpc.system.name` / legacy `rpc.system`; `rpc.service`; `rpc.method`; `server.address`; `server.port`; network attributes; `rpc.response.status_code` / legacy `rpc.grpc.status_code`; configured request metadata attributes | Stable and legacy RPC semantic conventions are selected by semconv stability configuration; metadata capture requires server request-metadata selector. |
| `message` | — | `message.type` (`SENT`/`RECEIVED`), `message.id` | Event controlled by `otel.instrumentation.grpc.emit-message-events` (default true). |
| `{service}/{method}` | SERVER span attributes | `grpc.canceled`, `grpc.received.message_count`, `grpc.sent.message_count` | Experimental attributes require `otel.instrumentation.grpc.experimental-span-attributes`; canceled attribute only on cancellation. |
| `{service}/{method}` | CLIENT span attributes | `grpc.received.message_count`, `grpc.sent.message_count` | Experimental attributes require `otel.instrumentation.grpc.experimental-span-attributes`. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `rpc.client.call.duration` | Histogram | s | RPC client attributes | Stable RPC metric; legacy metric may also emit depending on semconv stability configuration. |
| `rpc.server.call.duration` | Histogram | s | RPC server attributes | Stable RPC metric; legacy metric may also emit depending on semconv stability configuration. |
| `rpc.client.request.size` | Histogram | By convention | RPC client attributes | Experimental operation size metric. |
| `rpc.client.response.size` | Histogram | By convention | RPC client attributes | Experimental operation size metric. |
| `rpc.server.request.size` | Histogram | By convention | RPC server attributes | Experimental operation size metric. |
| `rpc.server.response.size` | Histogram | By convention | RPC server attributes | Experimental operation size metric. |

## Sources

- `instrumentation/grpc-1.6/metadata.yaml`
- `instrumentation/grpc-1.6/library/src/main/java/io/opentelemetry/instrumentation/grpc/v1_6/GrpcTelemetryBuilder.java`
- `instrumentation/grpc-1.6/library/src/main/java/io/opentelemetry/instrumentation/grpc/v1_6/GrpcAttributesExtractor.java`
- `instrumentation/grpc-1.6/library/src/main/java/io/opentelemetry/instrumentation/grpc/v1_6/TracingClientInterceptor.java`
- `instrumentation/grpc-1.6/library/src/main/java/io/opentelemetry/instrumentation/grpc/v1_6/TracingServerInterceptor.java`
        • v2.31.1.md 3.1 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/grpc-1.6
version: v2.31.1
scope_name: io.opentelemetry.grpc-1.6
commit_sha: 8ad06a082e051f366f19c16ad95a7b68edf30afd
last_verified: null
---

# gRPC

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `{service}/{method}` | CLIENT | `rpc.system.name` / legacy `rpc.system`; `rpc.service`; `rpc.method`; `server.address`; `server.port`; network attributes; `rpc.response.status_code` / legacy `rpc.grpc.status_code`; configured request metadata attributes | Stable and legacy RPC semantic conventions are selected by semconv stability configuration; metadata capture requires client request-metadata selector. |
| `{service}/{method}` | SERVER | `rpc.system.name` / legacy `rpc.system`; `rpc.service`; `rpc.method`; `server.address`; `server.port`; network attributes; `rpc.response.status_code` / legacy `rpc.grpc.status_code`; configured request metadata attributes | Stable and legacy RPC semantic conventions are selected by semconv stability configuration; metadata capture requires server request-metadata selector. |
| `message` | — | `message.type` (`SENT`/`RECEIVED`), `message.id` | Event controlled by `otel.instrumentation.grpc.emit-message-events` (default true). |
| `{service}/{method}` | SERVER span attributes | `grpc.canceled`, `grpc.received.message_count`, `grpc.sent.message_count` | Experimental attributes require `otel.instrumentation.grpc.experimental-span-attributes`; canceled attribute only on cancellation. |
| `{service}/{method}` | CLIENT span attributes | `grpc.received.message_count`, `grpc.sent.message_count` | Experimental attributes require `otel.instrumentation.grpc.experimental-span-attributes`. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `rpc.client.call.duration` | Histogram | s | RPC client attributes | Stable RPC metric; legacy metric may also emit depending on semconv stability configuration. |
| `rpc.server.call.duration` | Histogram | s | RPC server attributes | Stable RPC metric; legacy metric may also emit depending on semconv stability configuration. |
| `rpc.client.request.size` | Histogram | By convention | RPC client attributes | Experimental operation size metric. |
| `rpc.client.response.size` | Histogram | By convention | RPC client attributes | Experimental operation size metric. |
| `rpc.server.request.size` | Histogram | By convention | RPC server attributes | Experimental operation size metric. |
| `rpc.server.response.size` | Histogram | By convention | RPC server attributes | Experimental operation size metric. |

## Sources

- `instrumentation/grpc-1.6/metadata.yaml`
- `instrumentation/grpc-1.6/library/src/main/java/io/opentelemetry/instrumentation/grpc/v1_6/GrpcTelemetryBuilder.java`
- `instrumentation/grpc-1.6/library/src/main/java/io/opentelemetry/instrumentation/grpc/v1_6/GrpcAttributesExtractor.java`
- `instrumentation/grpc-1.6/library/src/main/java/io/opentelemetry/instrumentation/grpc/v1_6/TracingClientInterceptor.java`
- `instrumentation/grpc-1.6/library/src/main/java/io/opentelemetry/instrumentation/grpc/v1_6/TracingServerInterceptor.java`
        • v2.32.0.md 3.9 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/grpc-1.6
version: v2.32.0
scope_name: io.opentelemetry.grpc-1.6
commit_sha: 1b8644f8eb11d90295b1c313391aa84edeeec6e2
last_verified: null
---

# gRPC

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `{service}/{method}` | CLIENT | `rpc.system.name` / legacy `rpc.system`; `rpc.service`; `rpc.method`; `server.address`; `server.port`; network attributes; `rpc.response.status_code` / legacy `rpc.grpc.status_code`; configured request metadata attributes | Stable and legacy RPC semantic conventions are selected by semconv stability configuration; metadata capture requires client request-metadata selector. |
| `{service}/{method}` | SERVER | `rpc.system.name` / legacy `rpc.system`; `rpc.service`; `rpc.method`; `server.address`; `server.port`; network attributes; `rpc.response.status_code` / legacy `rpc.grpc.status_code`; configured request metadata attributes | Stable and legacy RPC semantic conventions are selected by semconv stability configuration; metadata capture requires server request-metadata selector. |
| `message` (event) | — | `message.type` (`SENT`/`RECEIVED`), `message.id` | Controlled by `otel.instrumentation.grpc.emit-message-events` (default true; library builder default true). |
| `{service}/{method}` | SERVER span attributes | `grpc.canceled`, `grpc.received.message_count`, `grpc.sent.message_count` | `grpc.canceled` only when cancelled; experimental attributes require `otel.instrumentation.grpc.experimental-span-attributes`. |
| `{service}/{method}` | CLIENT span attributes | `grpc.received.message_count`, `grpc.sent.message_count` | Experimental attributes require `otel.instrumentation.grpc.experimental-span-attributes`. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `rpc.client.call.duration` | Histogram | s | RPC client attributes (`rpc.system.name`, `rpc.method`, `server.address`, `server.port`, and applicable error/status attributes) | Stable RPC metric; legacy dual-emission can also produce `rpc.client.duration` (ms) under semconv stability configuration. |
| `rpc.server.call.duration` | Histogram | s | RPC server attributes (`rpc.system.name`, `rpc.method`, `server.address`, `server.port`, and applicable error/status attributes) | Stable RPC metric; legacy dual-emission can also produce `rpc.server.duration` (ms) under semconv stability configuration. |
| `rpc.client.request.size` | Histogram | By convention | RPC client attributes | Experimental operation size metric; emitted when operation size extraction is enabled by the instrumentation API. |
| `rpc.client.response.size` | Histogram | By convention | RPC client attributes | Experimental operation size metric; emitted when operation size extraction is enabled by the instrumentation API. |
| `rpc.server.request.size` | Histogram | By convention | RPC server attributes | Experimental operation size metric; emitted when operation size extraction is enabled by the instrumentation API. |
| `rpc.server.response.size` | Histogram | By convention | RPC server attributes | Experimental operation size metric; emitted when operation size extraction is enabled by the instrumentation API. |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `exception` span event | `exception.type`, `exception.message`, `exception.stacktrace` (when available) | RPC client/server exception event extractors; emitted on errors. |

## Sources

- `instrumentation/grpc-1.6/metadata.yaml`
- `instrumentation/grpc-1.6/library/src/main/java/io/opentelemetry/instrumentation/grpc/v1_6/GrpcTelemetryBuilder.java`
- `instrumentation/grpc-1.6/library/src/main/java/io/opentelemetry/instrumentation/grpc/v1_6/GrpcAttributesExtractor.java`
- `instrumentation/grpc-1.6/library/src/main/java/io/opentelemetry/instrumentation/grpc/v1_6/TracingClientInterceptor.java`
- `instrumentation/grpc-1.6/library/src/main/java/io/opentelemetry/instrumentation/grpc/v1_6/TracingServerInterceptor.java`
      • java-http-client
        • v2.26.1.md 3.5 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/java-http-client
version: v2.26.1
scope_name: io.opentelemetry.java-http-client
commit_sha: 9cf4fbaaa9e79226142b2ed42a6f6b4ac0be2197
last_verified: 2026-08-11
---

# Java HTTP Client

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| HTTP request method (for example, `GET`; `_OTHER` for unrecognized methods) | CLIENT | `http.request.method`, `http.request.method_original` (unknown methods), `url.full`, `server.address`, `server.port`, `http.response.status_code`, `error.type`, `network.protocol.version`, `http.request.header.<key>` (configured), `http.response.header.<key>` (configured), `http.request.resend_count` (retries/resends) | `network.protocol.version` is `1.1` or `2`; captured headers require `http.client.capture-request-headers`/`http.client.capture-response-headers`; `url.template`, `http.request.body.size`, and `http.response.body.size` require `http.client.emit-experimental-telemetry`; exception span events are controlled by `otel.semconv.exception.signal.preview` |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.client.request.duration` | Histogram | s | `http.request.method`, `http.response.status_code`, `error.type`, `network.protocol.version`, `server.address`, `server.port`, `url.template` (when present) | `url.template` is emitted only with `http.client.emit-experimental-telemetry` |
| `http.client.request.body.size` | Histogram | By | `http.request.method`, `http.response.status_code`, `error.type`, `network.protocol.version`, `server.address`, `server.port`, `url.template` | Experimental; requires `http.client.emit-experimental-telemetry`; recorded when request `Content-Length` is numeric |
| `http.client.response.body.size` | Histogram | By | `http.request.method`, `http.response.status_code`, `error.type`, `network.protocol.version`, `server.address`, `server.port`, `url.template` | Experimental; requires `http.client.emit-experimental-telemetry`; recorded when response `Content-Length` is numeric |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `http.client.request.exception` | `exception.type`, `exception.message`, `exception.stacktrace` | Exception log with WARN severity; emitted only when `otel.semconv.exception.signal.preview` is `logs` or `logs/dup` |

## Sources

- `instrumentation/java-http-client/metadata.yaml`
- `instrumentation/java-http-client/library/src/main/java/io/opentelemetry/instrumentation/javahttpclient/internal/JavaHttpClientAttributesGetter.java`
- `instrumentation/java-http-client/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/javahttpclient/HttpClientInstrumentation.java`
- `instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpCommonAttributesExtractor.java`
- `instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpClientAttributesExtractor.java`
- `instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpClientMetrics.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/builder/internal/DefaultHttpClientInstrumenterBuilder.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/http/HttpExperimentalAttributesExtractor.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/http/HttpClientExperimentalMetrics.java`
        • v2.27.0.md 3.5 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/java-http-client
version: v2.27.0
scope_name: io.opentelemetry.java-http-client
commit_sha: f1973d410d516461d08e3799343d7e368f309b84
last_verified: 2026-08-11
---

# Java HTTP Client

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| HTTP request method (for example, `GET`; `_OTHER` for unrecognized methods) | CLIENT | `http.request.method`, `http.request.method_original` (unknown methods), `url.full`, `server.address`, `server.port`, `http.response.status_code`, `error.type`, `network.protocol.version`, `http.request.header.<key>` (configured), `http.response.header.<key>` (configured), `http.request.resend_count` (retries/resends) | `network.protocol.version` is `1.1` or `2`; captured headers require `http.client.capture-request-headers`/`http.client.capture-response-headers`; `url.template`, `http.request.body.size`, and `http.response.body.size` require `http.client.emit-experimental-telemetry`; exception span events are controlled by `otel.semconv.exception.signal.preview` |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.client.request.duration` | Histogram | s | `http.request.method`, `http.response.status_code`, `error.type`, `network.protocol.version`, `server.address`, `server.port`, `url.template` (when present) | `url.template` is emitted only with `http.client.emit-experimental-telemetry` |
| `http.client.request.body.size` | Histogram | By | `http.request.method`, `http.response.status_code`, `error.type`, `network.protocol.version`, `server.address`, `server.port`, `url.template` | Experimental; requires `http.client.emit-experimental-telemetry`; recorded when request `Content-Length` is numeric |
| `http.client.response.body.size` | Histogram | By | `http.request.method`, `http.response.status_code`, `error.type`, `network.protocol.version`, `server.address`, `server.port`, `url.template` | Experimental; requires `http.client.emit-experimental-telemetry`; recorded when response `Content-Length` is numeric |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `http.client.request.exception` | `exception.type`, `exception.message`, `exception.stacktrace` | Exception log with WARN severity; emitted only when `otel.semconv.exception.signal.preview` is `logs` or `logs/dup` |

## Sources

- `instrumentation/java-http-client/metadata.yaml`
- `instrumentation/java-http-client/library/src/main/java/io/opentelemetry/instrumentation/javahttpclient/internal/JavaHttpClientAttributesGetter.java`
- `instrumentation/java-http-client/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/javahttpclient/HttpClientInstrumentation.java`
- `instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpCommonAttributesExtractor.java`
- `instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpClientAttributesExtractor.java`
- `instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpClientMetrics.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/builder/internal/DefaultHttpClientInstrumenterBuilder.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/http/HttpExperimentalAttributesExtractor.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/http/HttpClientExperimentalMetrics.java`
        • v2.28.0.md 3.5 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/java-http-client
version: v2.28.0
scope_name: io.opentelemetry.java-http-client
commit_sha: 9ef68e6b114b2d1fc1f6a3fbc576cb37fc71e893
last_verified: 2026-08-11
---

# Java HTTP Client

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| HTTP request method (for example, `GET`; `_OTHER` for unrecognized methods) | CLIENT | `http.request.method`, `http.request.method_original` (unknown methods), `url.full`, `server.address`, `server.port`, `http.response.status_code`, `error.type`, `network.protocol.version`, `http.request.header.<key>` (configured), `http.response.header.<key>` (configured), `http.request.resend_count` (retries/resends) | `network.protocol.version` is `1.1` or `2`; captured headers require `http.client.capture-request-headers`/`http.client.capture-response-headers`; `url.template`, `http.request.body.size`, and `http.response.body.size` require `http.client.emit-experimental-telemetry`; exception span events are controlled by `otel.semconv.exception.signal.preview` |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.client.request.duration` | Histogram | s | `http.request.method`, `http.response.status_code`, `error.type`, `network.protocol.version`, `server.address`, `server.port`, `url.template` (when present) | `url.template` is emitted only with `http.client.emit-experimental-telemetry` |
| `http.client.request.body.size` | Histogram | By | `http.request.method`, `http.response.status_code`, `error.type`, `network.protocol.version`, `server.address`, `server.port`, `url.template` | Experimental; requires `http.client.emit-experimental-telemetry`; recorded when request `Content-Length` is numeric |
| `http.client.response.body.size` | Histogram | By | `http.request.method`, `http.response.status_code`, `error.type`, `network.protocol.version`, `server.address`, `server.port`, `url.template` | Experimental; requires `http.client.emit-experimental-telemetry`; recorded when response `Content-Length` is numeric |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `http.client.request.exception` | `exception.type`, `exception.message`, `exception.stacktrace` | Exception log with WARN severity; emitted only when `otel.semconv.exception.signal.preview` is `logs` or `logs/dup` |

## Sources

- `instrumentation/java-http-client/metadata.yaml`
- `instrumentation/java-http-client/library/src/main/java/io/opentelemetry/instrumentation/javahttpclient/internal/JavaHttpClientAttributesGetter.java`
- `instrumentation/java-http-client/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/javahttpclient/HttpClientInstrumentation.java`
- `instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpCommonAttributesExtractor.java`
- `instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpClientAttributesExtractor.java`
- `instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpClientMetrics.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/builder/internal/DefaultHttpClientInstrumenterBuilder.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/http/HttpExperimentalAttributesExtractor.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/http/HttpClientExperimentalMetrics.java`
        • v2.28.1.md 3.5 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/java-http-client
version: v2.28.1
scope_name: io.opentelemetry.java-http-client
commit_sha: 7ad453a58de282ea04fd88f4178d70a65468b93c
last_verified: 2026-08-11
---

# Java HTTP Client

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| HTTP request method (for example, `GET`; `_OTHER` for unrecognized methods) | CLIENT | `http.request.method`, `http.request.method_original` (unknown methods), `url.full`, `server.address`, `server.port`, `http.response.status_code`, `error.type`, `network.protocol.version`, `http.request.header.<key>` (configured), `http.response.header.<key>` (configured), `http.request.resend_count` (retries/resends) | `network.protocol.version` is `1.1` or `2`; captured headers require `http.client.capture-request-headers`/`http.client.capture-response-headers`; `url.template`, `http.request.body.size`, and `http.response.body.size` require `http.client.emit-experimental-telemetry`; exception span events are controlled by `otel.semconv.exception.signal.preview` |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.client.request.duration` | Histogram | s | `http.request.method`, `http.response.status_code`, `error.type`, `network.protocol.version`, `server.address`, `server.port`, `url.template` (when present) | `url.template` is emitted only with `http.client.emit-experimental-telemetry` |
| `http.client.request.body.size` | Histogram | By | `http.request.method`, `http.response.status_code`, `error.type`, `network.protocol.version`, `server.address`, `server.port`, `url.template` | Experimental; requires `http.client.emit-experimental-telemetry`; recorded when request `Content-Length` is numeric |
| `http.client.response.body.size` | Histogram | By | `http.request.method`, `http.response.status_code`, `error.type`, `network.protocol.version`, `server.address`, `server.port`, `url.template` | Experimental; requires `http.client.emit-experimental-telemetry`; recorded when response `Content-Length` is numeric |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `http.client.request.exception` | `exception.type`, `exception.message`, `exception.stacktrace` | Exception log with WARN severity; emitted only when `otel.semconv.exception.signal.preview` is `logs` or `logs/dup` |

## Sources

- `instrumentation/java-http-client/metadata.yaml`
- `instrumentation/java-http-client/library/src/main/java/io/opentelemetry/instrumentation/javahttpclient/internal/JavaHttpClientAttributesGetter.java`
- `instrumentation/java-http-client/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/javahttpclient/HttpClientInstrumentation.java`
- `instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpCommonAttributesExtractor.java`
- `instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpClientAttributesExtractor.java`
- `instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpClientMetrics.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/builder/internal/DefaultHttpClientInstrumenterBuilder.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/http/HttpExperimentalAttributesExtractor.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/http/HttpClientExperimentalMetrics.java`
        • v2.29.0.md 3.5 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/java-http-client
version: v2.29.0
scope_name: io.opentelemetry.java-http-client
commit_sha: c215cb489a90d95c2ea5808fbdcd2f7d81d2f2ae
last_verified: 2026-08-11
---

# Java HTTP Client

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| HTTP request method (for example, `GET`; `_OTHER` for unrecognized methods) | CLIENT | `http.request.method`, `http.request.method_original` (unknown methods), `url.full`, `server.address`, `server.port`, `http.response.status_code`, `error.type`, `network.protocol.version`, `http.request.header.<key>` (configured), `http.response.header.<key>` (configured), `http.request.resend_count` (retries/resends) | `network.protocol.version` is `1.1` or `2`; captured headers require `http.client.capture-request-headers`/`http.client.capture-response-headers`; `url.template`, `http.request.body.size`, and `http.response.body.size` require `http.client.emit-experimental-telemetry`; exception span events are controlled by `otel.semconv.exception.signal.preview` |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.client.request.duration` | Histogram | s | `http.request.method`, `http.response.status_code`, `error.type`, `network.protocol.version`, `server.address`, `server.port`, `url.template` (when present) | `url.template` is emitted only with `http.client.emit-experimental-telemetry` |
| `http.client.request.body.size` | Histogram | By | `http.request.method`, `http.response.status_code`, `error.type`, `network.protocol.version`, `server.address`, `server.port`, `url.template` | Experimental; requires `http.client.emit-experimental-telemetry`; recorded when request `Content-Length` is numeric |
| `http.client.response.body.size` | Histogram | By | `http.request.method`, `http.response.status_code`, `error.type`, `network.protocol.version`, `server.address`, `server.port`, `url.template` | Experimental; requires `http.client.emit-experimental-telemetry`; recorded when response `Content-Length` is numeric |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `http.client.request.exception` | `exception.type`, `exception.message`, `exception.stacktrace` | Exception log with WARN severity; emitted only when `otel.semconv.exception.signal.preview` is `logs` or `logs/dup` |

## Sources

- `instrumentation/java-http-client/metadata.yaml`
- `instrumentation/java-http-client/library/src/main/java/io/opentelemetry/instrumentation/javahttpclient/internal/JavaHttpClientAttributesGetter.java`
- `instrumentation/java-http-client/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/javahttpclient/HttpClientInstrumentation.java`
- `instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpCommonAttributesExtractor.java`
- `instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpClientAttributesExtractor.java`
- `instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpClientMetrics.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/builder/internal/DefaultHttpClientInstrumenterBuilder.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/http/HttpExperimentalAttributesExtractor.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/http/HttpClientExperimentalMetrics.java`
        • v2.30.0.md 3.5 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/java-http-client
version: v2.30.0
scope_name: io.opentelemetry.java-http-client
commit_sha: 080c1d32ca676ba7b0210c21b60cce8e7ac39058
last_verified: 2026-08-11
---

# Java HTTP Client

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| HTTP request method (for example, `GET`; `_OTHER` for unrecognized methods) | CLIENT | `http.request.method`, `http.request.method_original` (unknown methods), `url.full`, `server.address`, `server.port`, `http.response.status_code`, `error.type`, `network.protocol.version`, `http.request.header.<key>` (configured), `http.response.header.<key>` (configured), `http.request.resend_count` (retries/resends) | `network.protocol.version` is `1.1` or `2`; captured headers require `http.client.capture-request-headers`/`http.client.capture-response-headers`; `url.template`, `http.request.body.size`, and `http.response.body.size` require `http.client.emit-experimental-telemetry`; exception span events are controlled by `otel.semconv.exception.signal.preview` |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.client.request.duration` | Histogram | s | `http.request.method`, `http.response.status_code`, `error.type`, `network.protocol.version`, `server.address`, `server.port`, `url.template` (when present) | `url.template` is emitted only with `http.client.emit-experimental-telemetry` |
| `http.client.request.body.size` | Histogram | By | `http.request.method`, `http.response.status_code`, `error.type`, `network.protocol.version`, `server.address`, `server.port`, `url.template` | Experimental; requires `http.client.emit-experimental-telemetry`; recorded when request `Content-Length` is numeric |
| `http.client.response.body.size` | Histogram | By | `http.request.method`, `http.response.status_code`, `error.type`, `network.protocol.version`, `server.address`, `server.port`, `url.template` | Experimental; requires `http.client.emit-experimental-telemetry`; recorded when response `Content-Length` is numeric |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `http.client.request.exception` | `exception.type`, `exception.message`, `exception.stacktrace` | Exception log with WARN severity; emitted only when `otel.semconv.exception.signal.preview` is `logs` or `logs/dup` |

## Sources

- `instrumentation/java-http-client/metadata.yaml`
- `instrumentation/java-http-client/library/src/main/java/io/opentelemetry/instrumentation/javahttpclient/internal/JavaHttpClientAttributesGetter.java`
- `instrumentation/java-http-client/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/javahttpclient/HttpClientInstrumentation.java`
- `instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpCommonAttributesExtractor.java`
- `instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpClientAttributesExtractor.java`
- `instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpClientMetrics.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/builder/internal/DefaultHttpClientInstrumenterBuilder.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/http/HttpExperimentalAttributesExtractor.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/http/HttpClientExperimentalMetrics.java`
        • v2.31.0.md 3.6 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/java-http-client
version: v2.31.0
scope_name: io.opentelemetry.java-http-client
commit_sha: 18da99bef6a5f1becdeb8091136f12c43742b9b7
last_verified: null
---

# Java HTTP Client

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| HTTP request method (for example, `GET`; `_OTHER` for unrecognized methods) | CLIENT | `http.request.method`, `http.request.method_original` (unknown methods), `url.full`, `server.address`, `server.port`, `http.response.status_code`, `error.type`, `network.protocol.version`, `http.request.header.<key>` (configured), `http.response.header.<key>` (configured), `http.request.resend_count` (retries/resends) | `network.protocol.version` is `1.1` or `2`; captured headers require `http.client.capture-request-headers`/`http.client.capture-response-headers`; `url.template`, `http.request.body.size`, and `http.response.body.size` require `http.client.emit-experimental-telemetry`; exception span events are controlled by `otel.semconv.exception.signal.preview` |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.client.request.duration` | Histogram | s | `http.request.method`, `http.response.status_code`, `error.type`, `network.protocol.version`, `server.address`, `server.port`, `url.template` (when present) | `url.template` is emitted only with `http.client.emit-experimental-telemetry` |
| `http.client.request.body.size` | Histogram | By | `http.request.method`, `http.response.status_code`, `error.type`, `network.protocol.version`, `server.address`, `server.port`, `url.template` | Experimental; requires `http.client.emit-experimental-telemetry`; recorded when request `Content-Length` is numeric |
| `http.client.response.body.size` | Histogram | By | `http.request.method`, `http.response.status_code`, `error.type`, `network.protocol.version`, `server.address`, `server.port`, `url.template` | Experimental; requires `http.client.emit-experimental-telemetry`; recorded when response `Content-Length` is numeric |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `http.client.request.exception` | `exception.type`, `exception.message`, `exception.stacktrace` | Exception log with WARN severity; emitted only when `otel.semconv.exception.signal.preview` is `logs` or `logs/dup` |

## Sources

- `instrumentation/java-http-client/metadata.yaml`
- `instrumentation/java-http-client/library/src/main/java/io/opentelemetry/instrumentation/javahttpclient/internal/JavaHttpClientAttributesGetter.java`
- `instrumentation/java-http-client/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/javahttpclient/HttpClientInstrumentation.java`
- `instrumentation/java-http-client/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/javahttpclient/HttpHeadersInstrumentation.java`
- `instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpCommonAttributesExtractor.java`
- `instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpClientAttributesExtractor.java`
- `instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpClientMetrics.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/builder/internal/DefaultHttpClientInstrumenterBuilder.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/http/HttpExperimentalAttributesExtractor.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/http/HttpClientExperimentalMetrics.java`
        • v2.31.1.md 3.5 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/java-http-client
version: v2.31.1
scope_name: io.opentelemetry.java-http-client
commit_sha: 8ad06a082e051f366f19c16ad95a7b68edf30afd
last_verified: 2026-08-26
---

# Java HTTP Client

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| HTTP request method (for example, `GET`; `_OTHER` for unrecognized methods) | CLIENT | `http.request.method`, `http.request.method_original` (unknown methods), `url.full`, `server.address`, `server.port`, `http.response.status_code`, `error.type`, `network.protocol.version`, `http.request.header.<key>` (configured), `http.response.header.<key>` (configured), `http.request.resend_count` (retries/resends) | `network.protocol.version` is `1.1` or `2`; captured headers are selected through request/response `IncludeExclude` selectors (legacy capture-list APIs remain deprecated compatibility paths); `url.template`, `http.request.body.size`, and `http.response.body.size` require `http.client.emit-experimental-telemetry`; exception span events are controlled by `otel.semconv.exception.signal.preview` |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.client.request.duration` | Histogram | s | `http.request.method`, `http.response.status_code`, `error.type`, `network.protocol.version`, `server.address`, `server.port`, `url.template` (when present) | `url.template` is emitted only with `http.client.emit-experimental-telemetry` |
| `http.client.request.body.size` | Histogram | By | `http.request.method`, `http.response.status_code`, `error.type`, `network.protocol.version`, `server.address`, `server.port`, `url.template` | Experimental; requires `http.client.emit-experimental-telemetry`; recorded when request `Content-Length` is numeric |
| `http.client.response.body.size` | Histogram | By | `http.request.method`, `http.response.status_code`, `error.type`, `network.protocol.version`, `server.address`, `server.port`, `url.template` | Experimental; requires `http.client.emit-experimental-telemetry`; recorded when response `Content-Length` is numeric |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `http.client.request.exception` | `exception.type`, `exception.message`, `exception.stacktrace` | Exception log with WARN severity; emitted only when `otel.semconv.exception.signal.preview` is `logs` or `logs/dup` |

## Sources

- `instrumentation/java-http-client/metadata.yaml`
- `instrumentation/java-http-client/library/src/main/java/io/opentelemetry/instrumentation/javahttpclient/internal/JavaHttpClientAttributesGetter.java`
- `instrumentation/java-http-client/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/javahttpclient/HttpClientInstrumentation.java`
- `instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpCommonAttributesExtractor.java`
- `instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpClientAttributesExtractor.java`
- `instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpClientMetrics.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/builder/internal/DefaultHttpClientInstrumenterBuilder.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/http/HttpExperimentalAttributesExtractor.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/http/HttpClientExperimentalMetrics.java`
        • v2.32.0.md 3.6 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/java-http-client
version: v2.32.0
scope_name: io.opentelemetry.java-http-client
commit_sha: 1b8644f8eb11d90295b1c313391aa84edeeec6e2
last_verified: null
---

# Java HTTP Client

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| HTTP request method (for example, `GET`; `_OTHER` for unrecognized methods) | CLIENT | `http.request.method`, `http.request.method_original` (unknown methods), `url.full`, `server.address`, `server.port`, `http.response.status_code`, `error.type`, `network.protocol.version`, `http.request.header.<key>` (configured), `http.response.header.<key>` (configured), `http.request.resend_count` (retries/resends) | `network.protocol.version` is `1.1` or `2`; captured headers require `http.client.capture-request-headers`/`http.client.capture-response-headers`; `url.template`, `http.request.body.size`, and `http.response.body.size` require `http.client.emit-experimental-telemetry`; exception span events are controlled by `otel.semconv.exception.signal.preview` |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.client.request.duration` | Histogram | s | `http.request.method`, `http.response.status_code`, `error.type`, `network.protocol.version`, `server.address`, `server.port`, `url.template` (when present) | `url.template` is emitted only with `http.client.emit-experimental-telemetry` |
| `http.client.request.body.size` | Histogram | By | `http.request.method`, `http.response.status_code`, `error.type`, `network.protocol.version`, `server.address`, `server.port`, `url.template` | Experimental; requires `http.client.emit-experimental-telemetry`; recorded when request `Content-Length` is numeric |
| `http.client.response.body.size` | Histogram | By | `http.request.method`, `http.response.status_code`, `error.type`, `network.protocol.version`, `server.address`, `server.port`, `url.template` | Experimental; requires `http.client.emit-experimental-telemetry`; recorded when response `Content-Length` is numeric |

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| `http.client.request.exception` | `exception.type`, `exception.message`, `exception.stacktrace` | Exception log with WARN severity; emitted only when `otel.semconv.exception.signal.preview` is `logs` or `logs/dup` |

## Sources

- `instrumentation/java-http-client/metadata.yaml`
- `instrumentation/java-http-client/library/src/main/java/io/opentelemetry/instrumentation/javahttpclient/internal/JavaHttpClientAttributesGetter.java`
- `instrumentation/java-http-client/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/javahttpclient/HttpClientInstrumentation.java`
- `instrumentation/java-http-client/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/javahttpclient/HttpHeadersInstrumentation.java`
- `instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpCommonAttributesExtractor.java`
- `instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpClientAttributesExtractor.java`
- `instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/semconv/http/HttpClientMetrics.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/builder/internal/DefaultHttpClientInstrumenterBuilder.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/http/HttpExperimentalAttributesExtractor.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/http/HttpClientExperimentalMetrics.java`
      • jdbc
        • v2.28.1.md 3.4 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/jdbc
version: v2.28.1
scope_name: io.opentelemetry.jdbc
commit_sha: 7ad453a58de282ea04fd88f4178d70a65468b93c
last_verified: 2026-10-14
---

# JDBC

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| Database operation (derived from SQL; stable query summary when available) | CLIENT | Legacy: `db.system`, `db.name`, `db.user`, `db.statement`, `db.operation`, `db.connection_string`, `net.peer.name`, `net.peer.port`. Stable: `db.system.name`, `db.namespace`, `db.query.text`, `db.query.summary`, `db.operation.name`, `db.collection.name`, `db.stored_procedure.name`, `db.operation.batch.size`, `server.address`, `server.port`, `error.type`; opt-in `db.query.parameter.<key>` | Legacy is the default; `OTEL_SEMCONV_STABILITY_OPT_IN=database` selects stable conventions and `database/dup` emits both. SQL-derived attributes are conditional on parsed query and database metadata. Query parameter capture requires `otel.instrumentation.jdbc.experimental.capture-query-parameters` and disables query sanitization. |

Java agent datasource-connection spans are disabled by default and require `otel.instrumentation.jdbc-datasource.enabled`; they use the datasource class and `getConnection` for naming, with code attributes and available database metadata. `COMMIT` and `ROLLBACK` client spans require `otel.instrumentation.jdbc.experimental.transaction.enabled`; database naming follows the same semantic-convention selection.

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `db.client.operation.duration` | Histogram | s | Attribute advice: `db.system.name`, `db.namespace`, `db.operation.name`, `db.collection.name`, `db.query.summary`, `server.address`, `server.port`, `network.peer.address`, `network.peer.port`, `error.type` (when available) | Only when stable database conventions are enabled (`database` or `database/dup`). Recorded for enabled statement/transaction instrumenters. The instrumenter passes extracted operation attributes; SDK attribute advice/views determine which are retained. |

## Sources

- `instrumentation/jdbc/metadata.yaml`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/db/SqlClientAttributesExtractor.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/db/DbClientAttributesExtractor.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/db/DbClientMetrics.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/db/DbClientMetricsAdvice.java`
- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/TransactionAttributeExtractor.java`
- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/DataSourceDbAttributesExtractor.java`
- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/DataSourceCodeAttributesGetter.java`

- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/JdbcInstrumenterFactory.java`
- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/JdbcAttributesGetter.java`
- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/OpenTelemetryStatement.java`
        • v2.29.0.md 3.4 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/jdbc
version: v2.29.0
scope_name: io.opentelemetry.jdbc
commit_sha: c215cb489a90d95c2ea5808fbdcd2f7d81d2f2ae
last_verified: 2026-10-14
---

# JDBC

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| Database operation (derived from SQL; stable query summary when available) | CLIENT | Legacy: `db.system`, `db.name`, `db.user`, `db.statement`, `db.operation`, `db.connection_string`, `net.peer.name`, `net.peer.port`. Stable: `db.system.name`, `db.namespace`, `db.query.text`, `db.query.summary`, `db.operation.name`, `db.collection.name`, `db.stored_procedure.name`, `db.operation.batch.size`, `server.address`, `server.port`, `error.type`; opt-in `db.query.parameter.<key>` | Legacy is the default; `OTEL_SEMCONV_STABILITY_OPT_IN=database` selects stable conventions and `database/dup` emits both. SQL-derived attributes are conditional on parsed query and database metadata. Query parameter capture requires `otel.instrumentation.jdbc.experimental.capture-query-parameters` and disables query sanitization. |

Java agent datasource-connection spans are disabled by default and require `otel.instrumentation.jdbc-datasource.enabled`; they use the datasource class and `getConnection` for naming, with code attributes and available database metadata. `COMMIT` and `ROLLBACK` client spans require `otel.instrumentation.jdbc.experimental.transaction.enabled`; database naming follows the same semantic-convention selection.

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `db.client.operation.duration` | Histogram | s | Attribute advice: `db.system.name`, `db.namespace`, `db.operation.name`, `db.collection.name`, `db.query.summary`, `server.address`, `server.port`, `network.peer.address`, `network.peer.port`, `error.type` (when available) | Only when stable database conventions are enabled (`database` or `database/dup`). Recorded for enabled statement/transaction instrumenters. The instrumenter passes extracted operation attributes; SDK attribute advice/views determine which are retained. |

## Sources

- `instrumentation/jdbc/metadata.yaml`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/db/SqlClientAttributesExtractor.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/db/DbClientAttributesExtractor.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/db/DbClientMetrics.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/db/DbClientMetricsAdvice.java`
- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/TransactionAttributeExtractor.java`
- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/DataSourceDbAttributesExtractor.java`
- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/DataSourceCodeAttributesGetter.java`

- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/JdbcInstrumenterFactory.java`
- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/JdbcAttributesGetter.java`
- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/OpenTelemetryStatement.java`
        • v2.30.0.md 3.4 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/jdbc
version: v2.30.0
scope_name: io.opentelemetry.jdbc
commit_sha: 080c1d32ca676ba7b0210c21b60cce8e7ac39058
last_verified: 2026-10-14
---

# JDBC

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| Database operation (derived from SQL; stable query summary when available) | CLIENT | Legacy: `db.system`, `db.name`, `db.user`, `db.statement`, `db.operation`, `db.connection_string`, `net.peer.name`, `net.peer.port`. Stable: `db.system.name`, `db.namespace`, `db.query.text`, `db.query.summary`, `db.operation.name`, `db.collection.name`, `db.stored_procedure.name`, `db.operation.batch.size`, `server.address`, `server.port`, `error.type`; opt-in `db.query.parameter.<key>` | Legacy is the default; `OTEL_SEMCONV_STABILITY_OPT_IN=database` selects stable conventions and `database/dup` emits both. SQL-derived attributes are conditional on parsed query and database metadata. Query parameter capture requires `otel.instrumentation.jdbc.experimental.capture-query-parameters` and disables query sanitization. |

Java agent datasource-connection spans are disabled by default and require `otel.instrumentation.jdbc-datasource.enabled`; they use the datasource class and `getConnection` for naming, with code attributes and available database metadata. `COMMIT` and `ROLLBACK` client spans require `otel.instrumentation.jdbc.experimental.transaction.enabled`; database naming follows the same semantic-convention selection.

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `db.client.operation.duration` | Histogram | s | Attribute advice: `db.system.name`, `db.namespace`, `db.operation.name`, `db.collection.name`, `db.query.summary`, `server.address`, `server.port`, `network.peer.address`, `network.peer.port`, `error.type` (when available) | Only when stable database conventions are enabled (`database` or `database/dup`). Recorded for enabled statement/transaction instrumenters. The instrumenter passes extracted operation attributes; SDK attribute advice/views determine which are retained. |

## Sources

- `instrumentation/jdbc/metadata.yaml`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/db/SqlClientAttributesExtractor.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/db/DbClientAttributesExtractor.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/db/DbClientMetrics.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/db/DbClientMetricsAdvice.java`
- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/TransactionAttributeExtractor.java`
- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/DataSourceDbAttributesExtractor.java`
- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/DataSourceCodeAttributesGetter.java`

- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/JdbcInstrumenterFactory.java`
- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/JdbcAttributesGetter.java`
- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/OpenTelemetryStatement.java`
        • v2.31.0.md 3.4 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/jdbc
version: v2.31.0
scope_name: io.opentelemetry.jdbc
commit_sha: 18da99bef6a5f1becdeb8091136f12c43742b9b7
last_verified: 2026-10-14
---

# JDBC

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| Database operation (derived from SQL; stable query summary when available) | CLIENT | Legacy: `db.system`, `db.name`, `db.user`, `db.statement`, `db.operation`, `db.connection_string`, `net.peer.name`, `net.peer.port`. Stable: `db.system.name`, `db.namespace`, `db.query.text`, `db.query.summary`, `db.operation.name`, `db.collection.name`, `db.stored_procedure.name`, `db.operation.batch.size`, `server.address`, `server.port`, `error.type`; opt-in `db.query.parameter.<key>` | Legacy is the default; `OTEL_SEMCONV_STABILITY_OPT_IN=database` selects stable conventions and `database/dup` emits both. SQL-derived attributes are conditional on parsed query and database metadata. Query parameter capture requires `otel.instrumentation.jdbc.experimental.capture-query-parameters` and disables query sanitization. |

Java agent datasource-connection spans are disabled by default and require `otel.instrumentation.jdbc-datasource.enabled`; they use the datasource class and `getConnection` for naming, with code attributes and available database metadata. `COMMIT` and `ROLLBACK` client spans require `otel.instrumentation.jdbc.experimental.transaction.enabled`; database naming follows the same semantic-convention selection.

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `db.client.operation.duration` | Histogram | s | Attribute advice: `db.system.name`, `db.namespace`, `db.operation.name`, `db.collection.name`, `db.query.summary`, `server.address`, `server.port`, `network.peer.address`, `network.peer.port`, `error.type` (when available) | Only when stable database conventions are enabled (`database` or `database/dup`). Recorded for enabled statement/transaction instrumenters. The instrumenter passes extracted operation attributes; SDK attribute advice/views determine which are retained. |

## Sources

- `instrumentation/jdbc/metadata.yaml`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/db/SqlClientAttributesExtractor.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/db/DbClientAttributesExtractor.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/db/DbClientMetrics.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/db/DbClientMetricsAdvice.java`
- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/TransactionAttributeExtractor.java`
- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/DataSourceDbAttributesExtractor.java`
- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/DataSourceCodeAttributesGetter.java`

- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/JdbcInstrumenterFactory.java`
- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/JdbcAttributesGetter.java`
- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/OpenTelemetryStatement.java`
        • v2.31.1.md 3.4 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/jdbc
version: v2.31.1
scope_name: io.opentelemetry.jdbc
commit_sha: 8ad06a082e051f366f19c16ad95a7b68edf30afd
last_verified: 2026-10-14
---

# JDBC

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| Database operation (derived from SQL; stable query summary when available) | CLIENT | Legacy: `db.system`, `db.name`, `db.user`, `db.statement`, `db.operation`, `db.connection_string`, `net.peer.name`, `net.peer.port`. Stable: `db.system.name`, `db.namespace`, `db.query.text`, `db.query.summary`, `db.operation.name`, `db.collection.name`, `db.stored_procedure.name`, `db.operation.batch.size`, `server.address`, `server.port`, `error.type`; opt-in `db.query.parameter.<key>` | Legacy is the default; `OTEL_SEMCONV_STABILITY_OPT_IN=database` selects stable conventions and `database/dup` emits both. SQL-derived attributes are conditional on parsed query and database metadata. Query parameter capture requires `otel.instrumentation.jdbc.experimental.capture-query-parameters` and disables query sanitization. |

Java agent datasource-connection spans are disabled by default and require `otel.instrumentation.jdbc-datasource.enabled`; they use the datasource class and `getConnection` for naming, with code attributes and available database metadata. `COMMIT` and `ROLLBACK` client spans require `otel.instrumentation.jdbc.experimental.transaction.enabled`; database naming follows the same semantic-convention selection.

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `db.client.operation.duration` | Histogram | s | Attribute advice: `db.system.name`, `db.namespace`, `db.operation.name`, `db.collection.name`, `db.query.summary`, `server.address`, `server.port`, `network.peer.address`, `network.peer.port`, `error.type` (when available) | Only when stable database conventions are enabled (`database` or `database/dup`). Recorded for enabled statement/transaction instrumenters. The instrumenter passes extracted operation attributes; SDK attribute advice/views determine which are retained. |

## Sources

- `instrumentation/jdbc/metadata.yaml`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/db/SqlClientAttributesExtractor.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/db/DbClientAttributesExtractor.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/db/DbClientMetrics.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/db/DbClientMetricsAdvice.java`
- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/TransactionAttributeExtractor.java`
- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/DataSourceDbAttributesExtractor.java`
- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/DataSourceCodeAttributesGetter.java`

- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/JdbcInstrumenterFactory.java`
- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/JdbcAttributesGetter.java`
- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/OpenTelemetryStatement.java`
        • v2.32.0.md 3.4 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/jdbc
version: v2.32.0
scope_name: io.opentelemetry.jdbc
commit_sha: 1b8644f8eb11d90295b1c313391aa84edeeec6e2
last_verified: 2026-10-14
---

# JDBC

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| Database operation (derived from SQL; stable query summary when available) | CLIENT | Legacy: `db.system`, `db.name`, `db.user`, `db.statement`, `db.operation`, `db.connection_string`, `net.peer.name`, `net.peer.port`. Stable: `db.system.name`, `db.namespace`, `db.query.text`, `db.query.summary`, `db.operation.name`, `db.collection.name`, `db.stored_procedure.name`, `db.operation.batch.size`, `server.address`, `server.port`, `error.type`; opt-in `db.query.parameter.<key>` | Legacy is the default; `OTEL_SEMCONV_STABILITY_OPT_IN=database` selects stable conventions and `database/dup` emits both. SQL-derived attributes are conditional on parsed query and database metadata. Query parameter capture requires `otel.instrumentation.jdbc.experimental.capture-query-parameters` and disables query sanitization. |

Java agent datasource-connection spans are disabled by default and require `otel.instrumentation.jdbc-datasource.enabled`; they use the datasource class and `getConnection` for naming, with code attributes and available database metadata. `COMMIT` and `ROLLBACK` client spans require `otel.instrumentation.jdbc.experimental.transaction.enabled`; database naming follows the same semantic-convention selection.

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `db.client.operation.duration` | Histogram | s | Attribute advice: `db.system.name`, `db.namespace`, `db.operation.name`, `db.collection.name`, `db.query.summary`, `server.address`, `server.port`, `network.peer.address`, `network.peer.port`, `error.type` (when available) | Only when stable database conventions are enabled (`database` or `database/dup`). Recorded for enabled statement/transaction instrumenters. The instrumenter passes extracted operation attributes; SDK attribute advice/views determine which are retained. |

## Sources

- `instrumentation/jdbc/metadata.yaml`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/db/SqlClientAttributesExtractor.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/db/DbClientAttributesExtractor.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/db/DbClientMetrics.java`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/db/DbClientMetricsAdvice.java`
- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/TransactionAttributeExtractor.java`
- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/DataSourceDbAttributesExtractor.java`
- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/DataSourceCodeAttributesGetter.java`

- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/JdbcInstrumenterFactory.java`
- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/JdbcAttributesGetter.java`
- `instrumentation/jdbc/library/src/main/java/io/opentelemetry/instrumentation/jdbc/internal/OpenTelemetryStatement.java`
      • kafka
        • v2.26.1.md 3.7 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/kafka
version: v2.26.1
scope_name: io.opentelemetry.kafka-clients-2.6; io.opentelemetry.kafka-connect-2.6; io.opentelemetry.kafka-streams-0.11
commit_sha: 9cf4fbaaa9e79226142b2ed42a6f6b4ac0be2197
last_verified: 2026-08-11
---

# Kafka instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `publish {messaging.destination.name}` | PRODUCER | `messaging.system`, `messaging.destination.name`, `messaging.operation` (`publish`), `messaging.client_id`, `messaging.destination.partition.id` (on completion), `messaging.kafka.offset` / `messaging.kafka.message.offset` (on completion), `messaging.kafka.message.key`, `messaging.kafka.message.tombstone`, captured `messaging.header.*` | Offset uses stable/old messaging semantic-convention gates respectively; header attributes are opt-in via `messaging.capture-headers`. |
| `receive {messaging.destination.name}` | CONSUMER | `messaging.system`, `messaging.destination.name`, `messaging.operation` (`receive`), `messaging.client_id`, `messaging.batch.message_count`, `messaging.kafka.consumer.group`, captured `messaging.header.*` | Receive telemetry is disabled by default; enable with `otel.instrumentation.messaging.experimental.receive-telemetry.enabled`. |
| `process {messaging.destination.name}` | CONSUMER | `messaging.system`, `messaging.destination.name`, `messaging.operation` (`process`), `messaging.client_id`, `messaging.destination.partition.id`, `messaging.message.body.size`, `messaging.kafka.consumer.group`, `messaging.kafka.offset` / `messaging.kafka.message.offset`, `messaging.kafka.message.key`, `messaging.kafka.message.tombstone`, `kafka.record.queue_time_ms`, captured `messaging.header.*` | `kafka.record.queue_time_ms` and `messaging.kafka.bootstrap.servers` are gated by `otel.instrumentation.kafka.experimental-span-attributes`; queue time is only present when the record has a timestamp. Offset uses stable/old messaging semantic-convention gates; headers are opt-in. Kafka Connect emits a batch process span with `messaging.batch.message_count` and links to each record; Kafka Streams emits the process span for each processed source record. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `kafka.consumer.<kafka-metric-name>` | Observable gauge, or observable counter for Kafka cumulative sum/count measurables | `{kafka metric unit}` | Kafka metric tags | Dynamically bridges measurable Kafka client metrics whose group contains `consumer`; emitted only when `OpenTelemetryMetricsReporter` is configured through `KafkaTelemetry`. Names replace `-` with `_`. |
| `kafka.producer.<kafka-metric-name>` | Observable gauge, or observable counter for Kafka cumulative sum/count measurables | `{kafka metric unit}` | Kafka metric tags | Same dynamic reporter behavior for metric groups containing `producer`; names replace `-` with `_`. |

## Sources

- `instrumentation/kafka/kafka-clients/kafka-clients-common-0.11/library/src/main/java/io/opentelemetry/instrumentation/kafkaclients/common/v0_11/internal/KafkaInstrumenterFactory.java`
- `.../KafkaProducerAttributesGetter.java`, `KafkaConsumerAttributesGetter.java`, `KafkaProducerAttributesExtractor.java`, `KafkaConsumerAttributesExtractor.java`, `KafkaReceiveAttributesExtractor.java`
- `.../KafkaMetricRegistry.java`, `OpenTelemetryMetricsReporter.java`
- `instrumentation/kafka/kafka-connect-2.6/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/kafkaconnect/v2_6/KafkaConnectSingletons.java`
- `instrumentation/kafka/kafka-streams-0.11/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/kafkastreams/KafkaStreamsSingletons.java`
        • v2.27.0.md 3.4 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/kafka
version: v2.27.0
scope_name: io.opentelemetry.kafka-clients-2.6; io.opentelemetry.kafka-connect-2.6; io.opentelemetry.kafka-streams-0.11
commit_sha: f1973d410d516461d08e3799343d7e368f309b84
last_verified: 2026-08-11
---

# Kafka instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `publish {messaging.destination.name}` | PRODUCER | `messaging.system`, `messaging.destination.name`, `messaging.operation` (`publish`), `messaging.client_id`, `messaging.destination.partition.id` (on completion), `messaging.kafka.offset` / `messaging.kafka.message.offset` (on completion), `messaging.kafka.message.key`, `messaging.kafka.message.tombstone`, captured `messaging.header.*` | Offset uses stable/old messaging semantic-convention gates respectively; header attributes are opt-in via `messaging.capture-headers`. |
| `receive {messaging.destination.name}` | CONSUMER | `messaging.system`, `messaging.destination.name`, `messaging.operation` (`receive`), `messaging.client_id`, `messaging.batch.message_count`, `messaging.kafka.consumer.group`, captured `messaging.header.*` | Receive telemetry is disabled by default; enable with `otel.instrumentation.messaging.experimental.receive-telemetry.enabled`. |
| `process {messaging.destination.name}` | CONSUMER | `messaging.system`, `messaging.destination.name`, `messaging.operation` (`process`), `messaging.client_id`, `messaging.destination.partition.id`, `messaging.message.body.size`, `messaging.kafka.consumer.group`, `messaging.kafka.offset` / `messaging.kafka.message.offset`, `messaging.kafka.message.key`, `messaging.kafka.message.tombstone`, `kafka.record.queue_time_ms`, captured `messaging.header.*` | `kafka.record.queue_time_ms` and `messaging.kafka.bootstrap.servers` are gated by `otel.instrumentation.kafka.experimental-span-attributes`; queue time is only present when the record has a timestamp. Offset uses stable/old messaging semantic-convention gates; headers are opt-in. Kafka Connect emits a batch process span with `messaging.batch.message_count` and links to each record; Kafka Streams emits the process span for each processed source record. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `kafka.consumer.<kafka-metric-name>` | Observable gauge, or observable counter for Kafka cumulative sum/count measurables | `{kafka metric unit}` | Kafka metric tags | Dynamically bridges measurable Kafka client metrics whose group contains `consumer`; emitted only when `OpenTelemetryMetricsReporter` is configured through `KafkaTelemetry`. Names replace `-` with `_`. |
| `kafka.producer.<kafka-metric-name>` | Observable gauge, or observable counter for Kafka cumulative sum/count measurables | `{kafka metric unit}` | Kafka metric tags | Same dynamic reporter behavior for metric groups containing `producer`; names replace `-` with `_`. |

## Sources

- Kafka common instrumenter, attribute extractors/getters, metric registry and reporter under `instrumentation/kafka/kafka-clients/kafka-clients-common-0.11/library/src/main/java/.../internal/`
- `instrumentation/kafka/kafka-connect-2.6/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/kafkaconnect/v2_6/KafkaConnectSingletons.java`
- `instrumentation/kafka/kafka-streams-0.11/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/kafkastreams/KafkaStreamsSingletons.java`
        • v2.28.0.md 3.4 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/kafka
version: v2.28.0
scope_name: io.opentelemetry.kafka-clients-2.6; io.opentelemetry.kafka-connect-2.6; io.opentelemetry.kafka-streams-0.11
commit_sha: 9ef68e6b114b2d1fc1f6a3fbc576cb37fc71e893
last_verified: 2026-08-11
---

# Kafka instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `publish {messaging.destination.name}` | PRODUCER | `messaging.system`, `messaging.destination.name`, `messaging.operation` (`publish`), `messaging.client_id`, `messaging.destination.partition.id` (on completion), `messaging.kafka.offset` / `messaging.kafka.message.offset` (on completion), `messaging.kafka.message.key`, `messaging.kafka.message.tombstone`, captured `messaging.header.*` | Offset uses stable/old messaging semantic-convention gates respectively; header attributes are opt-in via `messaging.capture-headers`. |
| `receive {messaging.destination.name}` | CONSUMER | `messaging.system`, `messaging.destination.name`, `messaging.operation` (`receive`), `messaging.client_id`, `messaging.batch.message_count`, `messaging.kafka.consumer.group`, captured `messaging.header.*` | Receive telemetry is disabled by default; enable with `otel.instrumentation.messaging.experimental.receive-telemetry.enabled`. |
| `process {messaging.destination.name}` | CONSUMER | `messaging.system`, `messaging.destination.name`, `messaging.operation` (`process`), `messaging.client_id`, `messaging.destination.partition.id`, `messaging.message.body.size`, `messaging.kafka.consumer.group`, `messaging.kafka.offset` / `messaging.kafka.message.offset`, `messaging.kafka.message.key`, `messaging.kafka.message.tombstone`, `kafka.record.queue_time_ms`, captured `messaging.header.*` | `kafka.record.queue_time_ms` and `messaging.kafka.bootstrap.servers` are gated by `otel.instrumentation.kafka.experimental-span-attributes`; queue time is only present when the record has a timestamp. Offset uses stable/old messaging semantic-convention gates; headers are opt-in. Kafka Connect emits a batch process span with `messaging.batch.message_count` and links to each record; Kafka Streams emits the process span for each processed source record. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `kafka.consumer.<kafka-metric-name>` | Observable gauge, or observable counter for Kafka cumulative sum/count measurables | `{kafka metric unit}` | Kafka metric tags | Dynamically bridges measurable Kafka client metrics whose group contains `consumer`; emitted only when `OpenTelemetryMetricsReporter` is configured through `KafkaTelemetry`. Names replace `-` with `_`. |
| `kafka.producer.<kafka-metric-name>` | Observable gauge, or observable counter for Kafka cumulative sum/count measurables | `{kafka metric unit}` | Kafka metric tags | Same dynamic reporter behavior for metric groups containing `producer`; names replace `-` with `_`. |

## Sources

- Kafka common instrumenter, attribute extractors/getters, metric registry and reporter under `instrumentation/kafka/kafka-clients/kafka-clients-common-0.11/library/src/main/java/.../internal/`
- `instrumentation/kafka/kafka-connect-2.6/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/kafkaconnect/v2_6/KafkaConnectSingletons.java`
- `instrumentation/kafka/kafka-streams-0.11/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/kafkastreams/v0_11/KafkaStreamsSingletons.java`
        • v2.28.1.md 3.4 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/kafka
version: v2.28.1
scope_name: io.opentelemetry.kafka-clients-2.6; io.opentelemetry.kafka-connect-2.6; io.opentelemetry.kafka-streams-0.11
commit_sha: 7ad453a58de282ea04fd88f4178d70a65468b93c
last_verified: 2026-08-11
---

# Kafka instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `publish {messaging.destination.name}` | PRODUCER | `messaging.system`, `messaging.destination.name`, `messaging.operation` (`publish`), `messaging.client_id`, `messaging.destination.partition.id` (on completion), `messaging.kafka.offset` / `messaging.kafka.message.offset` (on completion), `messaging.kafka.message.key`, `messaging.kafka.message.tombstone`, captured `messaging.header.*` | Offset uses stable/old messaging semantic-convention gates respectively; header attributes are opt-in via `messaging.capture-headers`. |
| `receive {messaging.destination.name}` | CONSUMER | `messaging.system`, `messaging.destination.name`, `messaging.operation` (`receive`), `messaging.client_id`, `messaging.batch.message_count`, `messaging.kafka.consumer.group`, captured `messaging.header.*` | Receive telemetry is disabled by default; enable with `otel.instrumentation.messaging.experimental.receive-telemetry.enabled`. |
| `process {messaging.destination.name}` | CONSUMER | `messaging.system`, `messaging.destination.name`, `messaging.operation` (`process`), `messaging.client_id`, `messaging.destination.partition.id`, `messaging.message.body.size`, `messaging.kafka.consumer.group`, `messaging.kafka.offset` / `messaging.kafka.message.offset`, `messaging.kafka.message.key`, `messaging.kafka.message.tombstone`, `kafka.record.queue_time_ms`, captured `messaging.header.*` | `kafka.record.queue_time_ms` and `messaging.kafka.bootstrap.servers` are gated by `otel.instrumentation.kafka.experimental-span-attributes`; queue time is only present when the record has a timestamp. Offset uses stable/old messaging semantic-convention gates; headers are opt-in. Kafka Connect emits a batch process span with `messaging.batch.message_count` and links to each record; Kafka Streams emits the process span for each processed source record. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `kafka.consumer.<kafka-metric-name>` | Observable gauge, or observable counter for Kafka cumulative sum/count measurables | `{kafka metric unit}` | Kafka metric tags | Dynamically bridges measurable Kafka client metrics whose group contains `consumer`; emitted only when `OpenTelemetryMetricsReporter` is configured through `KafkaTelemetry`. Names replace `-` with `_`. |
| `kafka.producer.<kafka-metric-name>` | Observable gauge, or observable counter for Kafka cumulative sum/count measurables | `{kafka metric unit}` | Kafka metric tags | Same dynamic reporter behavior for metric groups containing `producer`; names replace `-` with `_`. |

## Sources

- Kafka common instrumenter, attribute extractors/getters, metric registry and reporter under `instrumentation/kafka/kafka-clients/kafka-clients-common-0.11/library/src/main/java/.../internal/`
- `instrumentation/kafka/kafka-connect-2.6/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/kafkaconnect/v2_6/KafkaConnectSingletons.java`
- `instrumentation/kafka/kafka-streams-0.11/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/kafkastreams/v0_11/KafkaStreamsSingletons.java`
        • v2.29.0.md 3.4 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/kafka
version: v2.29.0
scope_name: io.opentelemetry.kafka-clients-2.6; io.opentelemetry.kafka-connect-2.6; io.opentelemetry.kafka-streams-0.11
commit_sha: c215cb489a90d95c2ea5808fbdcd2f7d81d2f2ae
last_verified: 2026-08-11
---

# Kafka instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `publish {messaging.destination.name}` | PRODUCER | `messaging.system`, `messaging.destination.name`, `messaging.operation` (`publish`), `messaging.client_id`, `messaging.destination.partition.id` (on completion), `messaging.kafka.offset` / `messaging.kafka.message.offset` (on completion), `messaging.kafka.message.key`, `messaging.kafka.message.tombstone`, captured `messaging.header.*` | Offset uses stable/old messaging semantic-convention gates respectively; header attributes are opt-in via `messaging.capture-headers`. |
| `receive {messaging.destination.name}` | CONSUMER | `messaging.system`, `messaging.destination.name`, `messaging.operation` (`receive`), `messaging.client_id`, `messaging.batch.message_count`, `messaging.kafka.consumer.group`, captured `messaging.header.*` | Receive telemetry is disabled by default; enable with `otel.instrumentation.messaging.experimental.receive-telemetry.enabled`. |
| `process {messaging.destination.name}` | CONSUMER | `messaging.system`, `messaging.destination.name`, `messaging.operation` (`process`), `messaging.client_id`, `messaging.destination.partition.id`, `messaging.message.body.size`, `messaging.kafka.consumer.group`, `messaging.kafka.offset` / `messaging.kafka.message.offset`, `messaging.kafka.message.key`, `messaging.kafka.message.tombstone`, `kafka.record.queue_time_ms`, captured `messaging.header.*` | `kafka.record.queue_time_ms` and `messaging.kafka.bootstrap.servers` are gated by `otel.instrumentation.kafka.experimental-span-attributes`; queue time is only present when the record has a timestamp. Offset uses stable/old messaging semantic-convention gates; headers are opt-in. Kafka Connect emits a batch process span with `messaging.batch.message_count` and links to each record; Kafka Streams emits the process span for each processed source record. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `kafka.consumer.<kafka-metric-name>` | Observable gauge, or observable counter for Kafka cumulative sum/count measurables | `{kafka metric unit}` | Kafka metric tags | Dynamically bridges measurable Kafka client metrics whose group contains `consumer`; emitted only when `OpenTelemetryMetricsReporter` is configured through `KafkaTelemetry`. Names replace `-` with `_`. |
| `kafka.producer.<kafka-metric-name>` | Observable gauge, or observable counter for Kafka cumulative sum/count measurables | `{kafka metric unit}` | Kafka metric tags | Same dynamic reporter behavior for metric groups containing `producer`; names replace `-` with `_`. |

## Sources

- Kafka common instrumenter, attribute extractors/getters, metric registry and reporter under `instrumentation/kafka/kafka-clients/kafka-clients-common-0.11/library/src/main/java/.../internal/`
- `instrumentation/kafka/kafka-connect-2.6/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/kafkaconnect/v2_6/KafkaConnectSingletons.java`
- `instrumentation/kafka/kafka-streams-0.11/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/kafkastreams/v0_11/KafkaStreamsSingletons.java`
        • v2.30.0.md 3.4 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/kafka
version: v2.30.0
scope_name: io.opentelemetry.kafka-clients-2.6; io.opentelemetry.kafka-connect-2.6; io.opentelemetry.kafka-streams-0.11
commit_sha: 080c1d32ca676ba7b0210c21b60cce8e7ac39058
last_verified: 2026-08-11
---

# Kafka instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `publish {messaging.destination.name}` | PRODUCER | `messaging.system`, `messaging.destination.name`, `messaging.operation` (`publish`), `messaging.client_id`, `messaging.destination.partition.id` (on completion), `messaging.kafka.offset` / `messaging.kafka.message.offset` (on completion), `messaging.kafka.message.key`, `messaging.kafka.message.tombstone`, captured `messaging.header.*` | Offset uses stable/old messaging semantic-convention gates respectively; header attributes are opt-in via `messaging.capture-headers`. |
| `receive {messaging.destination.name}` | CONSUMER | `messaging.system`, `messaging.destination.name`, `messaging.operation` (`receive`), `messaging.client_id`, `messaging.batch.message_count`, `messaging.kafka.consumer.group`, captured `messaging.header.*` | Receive telemetry is disabled by default; enable with `otel.instrumentation.messaging.experimental.receive-telemetry.enabled`. |
| `process {messaging.destination.name}` | CONSUMER | `messaging.system`, `messaging.destination.name`, `messaging.operation` (`process`), `messaging.client_id`, `messaging.destination.partition.id`, `messaging.message.body.size`, `messaging.kafka.consumer.group`, `messaging.kafka.offset` / `messaging.kafka.message.offset`, `messaging.kafka.message.key`, `messaging.kafka.message.tombstone`, `kafka.record.queue_time_ms`, captured `messaging.header.*` | `kafka.record.queue_time_ms` and `messaging.kafka.bootstrap.servers` are gated by `otel.instrumentation.kafka.experimental-span-attributes`; queue time is only present when the record has a timestamp. Offset uses stable/old messaging semantic-convention gates; headers are opt-in. Kafka Connect emits a batch process span with `messaging.batch.message_count` and links to each record; Kafka Streams emits the process span for each processed source record. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `kafka.consumer.<kafka-metric-name>` | Observable gauge, or observable counter for Kafka cumulative sum/count measurables | `{kafka metric unit}` | Kafka metric tags | Dynamically bridges measurable Kafka client metrics whose group contains `consumer`; emitted only when `OpenTelemetryMetricsReporter` is configured through `KafkaTelemetry`. Names replace `-` with `_`. |
| `kafka.producer.<kafka-metric-name>` | Observable gauge, or observable counter for Kafka cumulative sum/count measurables | `{kafka metric unit}` | Kafka metric tags | Same dynamic reporter behavior for metric groups containing `producer`; names replace `-` with `_`. |

## Sources

- Kafka common instrumenter, attribute extractors/getters, metric registry and reporter under `instrumentation/kafka/kafka-clients/kafka-clients-common-0.11/library/src/main/java/.../internal/`
- `instrumentation/kafka/kafka-connect-2.6/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/kafkaconnect/v2_6/KafkaConnectSingletons.java`
- `instrumentation/kafka/kafka-streams-0.11/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/kafkastreams/v0_11/KafkaStreamsSingletons.java`
        • v2.31.0.md 5.4 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/kafka
version: v2.31.0
scope_name: io.opentelemetry.kafka-clients-2.6; io.opentelemetry.kafka-connect-2.6; io.opentelemetry.kafka-streams-0.11
commit_sha: 18da99bef6a5f1becdeb8091136f12c43742b9b7
last_verified: 2026-08-26
---

# Kafka instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `send {messaging.destination.name}` (stable); `{messaging.destination.name} publish` (old) | PRODUCER | `messaging.system`, `messaging.destination.name`, stable `messaging.operation.name` (`send`), `messaging.operation.type` (`send`), `messaging.client.id`; or old `messaging.operation` (`publish`), `messaging.client_id`; `messaging.destination.partition.id` (on completion), `messaging.kafka.offset` / `messaging.kafka.message.offset` (stable/old), `messaging.kafka.message.key`, `messaging.kafka.message.tombstone`, `error.type` (stable), captured `messaging.header.*` | Header attributes use `otel.instrumentation.messaging.experimental.headers.included`/`.excluded` selectors; legacy `otel.instrumentation.messaging.experimental.capture-headers` is deprecated. |
| `poll {messaging.destination.name}` (stable); `{messaging.destination.name} receive` (old) | CONSUMER | `messaging.system`, `messaging.destination.name`, stable `messaging.operation.name` (`poll`), `messaging.operation.type` (`receive`), `messaging.client.id`, `messaging.consumer.group.name`; or old `messaging.operation` (`receive`), `messaging.client_id`, `messaging.kafka.consumer.group`; `messaging.batch.message_count`, `error.type` (stable), captured `messaging.header.*` | Receive telemetry disabled by default; enable with `otel.instrumentation.messaging.experimental.receive-telemetry.enabled`. |
| `process {messaging.destination.name}` (stable); `{messaging.destination.name} process` (old) | CONSUMER | `messaging.system`, `messaging.destination.name`, stable `messaging.operation.name`/`messaging.operation.type` (`process`), `messaging.client.id`, `messaging.consumer.group.name`; or old `messaging.operation` (`process`), `messaging.client_id`, `messaging.kafka.consumer.group`; `messaging.destination.partition.id`, old `messaging.message.body.size`, `messaging.kafka.offset` / `messaging.kafka.message.offset` (stable/old), `messaging.kafka.message.key`, `messaging.kafka.message.tombstone`, `error.type` (stable), `kafka.record.queue_time_ms`, captured `messaging.header.*` | `kafka.record.queue_time_ms` and `messaging.kafka.bootstrap.servers` gated by `otel.instrumentation.kafka.experimental-span-attributes`; queue time requires record timestamp. Kafka Connect emits batch process span with `messaging.batch.message_count` and per-record links; Kafka Streams emits a process span per processed source record. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `messaging.client.operation.duration` | Histogram | s | `messaging.system`, `messaging.operation.name`, `messaging.operation.type`, `messaging.destination.name`, `messaging.consumer.group.name`, `messaging.destination.partition.id`, `error.type` | Stable messaging conventions for send and receive/poll; interceptor-only instrumentation omits it. |
| `messaging.client.sent.messages` | Counter | `{message}` | `messaging.system`, `messaging.operation.name`, `messaging.destination.name`, `messaging.destination.partition.id`, `error.type` | Stable conventions; counts attempted producer sends. |
| `messaging.client.consumed.messages` | Counter | `{message}` | `messaging.system`, `messaging.operation.name`, `messaging.destination.name`, `messaging.consumer.group.name`, `messaging.destination.partition.id`, `error.type` | Recorded once by receive/poll or process when receive telemetry is suppressed. |
| `messaging.process.duration` | Histogram | s | `messaging.system`, `messaging.operation.name`, `messaging.destination.name`, `messaging.consumer.group.name`, `messaging.destination.partition.id`, `error.type` | Stable messaging conventions for processing duration. |
| `kafka.consumer.<kafka-metric-name>` | Observable gauge or observable counter for cumulative sum/count measurables | `{kafka metric unit}` | Kafka metric tags | Dynamically bridges measurable Kafka client metrics for groups containing `consumer`; requires `OpenTelemetryMetricsReporter` configured through `KafkaTelemetry`; names replace `-` with `_`. |
| `kafka.producer.<kafka-metric-name>` | Observable gauge or observable counter for cumulative sum/count measurables | `{kafka metric unit}` | Kafka metric tags | Same dynamic reporter behavior for groups containing `producer`; names replace `-` with `_`. |

## Sources

- `instrumentation/kafka/README.md`
- `instrumentation/kafka/kafka-clients/kafka-clients-common-0.11/library/src/main/java/.../internal/` (instrumenter, extractors, metric registry and reporter)
- `instrumentation/kafka/kafka-clients/kafka-clients-2.6/library/src/main/java/io/opentelemetry/instrumentation/kafkaclients/v2_6/`
- `instrumentation/kafka/kafka-connect-2.6/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/kafkaconnect/v2_6/`
- `instrumentation/kafka/kafka-streams-0.11/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/kafkastreams/v0_11/`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/messaging/{MessagingAttributesExtractor,MessagingSpanNameExtractor,MessagingProducerMetrics,MessagingConsumerMetrics,MessagingProcessMetrics}.java`
        • v2.31.1.md 5.6 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/kafka
version: v2.31.1
scope_name: io.opentelemetry.kafka-clients-2.6; io.opentelemetry.kafka-connect-2.6; io.opentelemetry.kafka-streams-0.11
commit_sha: 8ad06a082e051f366f19c16ad95a7b68edf30afd
last_verified: 2026-08-26
---

# Kafka instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `send {messaging.destination.name}` (stable); `{messaging.destination.name} publish` (old) | PRODUCER | `messaging.system`, `messaging.destination.name`, stable `messaging.operation.name` (`send`), `messaging.operation.type` (`send`), `messaging.client.id`; or old `messaging.operation` (`publish`), `messaging.client_id`; `messaging.destination.partition.id` (on completion), `messaging.kafka.offset` / `messaging.kafka.message.offset` (stable/old), `messaging.kafka.message.key`, `messaging.kafka.message.tombstone`, `error.type` (stable), captured `messaging.header.*` | Header attributes use `otel.instrumentation.messaging.experimental.headers.included`/`.excluded` selectors; the legacy `otel.instrumentation.messaging.experimental.capture-headers` property is deprecated. |
| `poll {messaging.destination.name}` (stable); `{messaging.destination.name} receive` (old) | CONSUMER | `messaging.system`, `messaging.destination.name`, stable `messaging.operation.name` (`poll`), `messaging.operation.type` (`receive`), `messaging.client.id`, `messaging.consumer.group.name`; or old `messaging.operation` (`receive`), `messaging.client_id`, `messaging.kafka.consumer.group`; `messaging.batch.message_count`, `error.type` (stable), captured `messaging.header.*` | Receive telemetry is disabled by default; enable with `otel.instrumentation.messaging.experimental.receive-telemetry.enabled`. |
| `process {messaging.destination.name}` (stable); `{messaging.destination.name} process` (old) | CONSUMER | `messaging.system`, `messaging.destination.name`, stable `messaging.operation.name`/`messaging.operation.type` (`process`), `messaging.client.id`, `messaging.consumer.group.name`; or old `messaging.operation` (`process`), `messaging.client_id`, `messaging.kafka.consumer.group`; `messaging.destination.partition.id`, old `messaging.message.body.size`, `messaging.kafka.offset` / `messaging.kafka.message.offset` (stable/old), `messaging.kafka.message.key`, `messaging.kafka.message.tombstone`, `error.type` (stable), `kafka.record.queue_time_ms`, captured `messaging.header.*` | `kafka.record.queue_time_ms` and `messaging.kafka.bootstrap.servers` are gated by `otel.instrumentation.kafka.experimental-span-attributes`; queue time is only present when the record has a timestamp. Kafka Connect emits a batch process span with `messaging.batch.message_count` and per-record links; Kafka Streams emits a process span for each processed source record. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `messaging.client.operation.duration` | Histogram | s | `messaging.system`, `messaging.operation.name`, `messaging.operation.type`, `messaging.destination.name`, `messaging.consumer.group.name`, `messaging.destination.partition.id`, `error.type` | Emitted with stable messaging semantic conventions for send and receive/poll operations; interceptor-only instrumentation omits it because interceptor hooks do not cover the full broker operation. |
| `messaging.client.sent.messages` | Counter | `{message}` | `messaging.system`, `messaging.operation.name`, `messaging.destination.name`, `messaging.destination.partition.id`, `error.type` | Emitted with stable messaging semantic conventions; counts messages the producer attempted to send. |
| `messaging.client.consumed.messages` | Counter | `{message}` | `messaging.system`, `messaging.operation.name`, `messaging.destination.name`, `messaging.consumer.group.name`, `messaging.destination.partition.id`, `error.type` | Emitted with stable messaging semantic conventions; recorded once by receive/poll or by process when receive telemetry is suppressed. |
| `messaging.process.duration` | Histogram | s | `messaging.system`, `messaging.operation.name`, `messaging.destination.name`, `messaging.consumer.group.name`, `messaging.destination.partition.id`, `error.type` | Emitted with stable messaging semantic conventions for processing duration. |
| `kafka.consumer.<kafka-metric-name>` | Observable gauge, or observable counter for Kafka cumulative sum/count measurables | `{kafka metric unit}` | Kafka metric tags | Dynamically bridges measurable Kafka client metrics whose group contains `consumer`; emitted only when `OpenTelemetryMetricsReporter` is configured through `KafkaTelemetry`. Names replace `-` with `_`. |
| `kafka.producer.<kafka-metric-name>` | Observable gauge, or observable counter for Kafka cumulative sum/count measurables | `{kafka metric unit}` | Kafka metric tags | Same dynamic reporter behavior for metric groups containing `producer`; names replace `-` with `_`. |

## Sources

- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/messaging/{MessagingAttributesExtractor,MessagingSpanNameExtractor,MessagingProducerMetrics,MessagingConsumerMetrics,MessagingProcessMetrics}.java`
- Kafka common instrumenter, attribute extractors/getters, metric registry and reporter under `instrumentation/kafka/kafka-clients/kafka-clients-common-0.11/library/src/main/java/.../internal/`
- `instrumentation/kafka/kafka-connect-2.6/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/kafkaconnect/v2_6/KafkaConnectSingletons.java`
- `instrumentation/kafka/kafka-streams-0.11/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/kafkastreams/v0_11/KafkaStreamsSingletons.java`
        • v2.32.0.md 5.4 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/kafka
version: v2.32.0
scope_name: io.opentelemetry.kafka-clients-2.6; io.opentelemetry.kafka-connect-2.6; io.opentelemetry.kafka-streams-0.11
commit_sha: 1b8644f8eb11d90295b1c313391aa84edeeec6e2
last_verified: null
---

# Kafka instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `send {messaging.destination.name}` (stable); `{messaging.destination.name} publish` (old) | PRODUCER | `messaging.system`, `messaging.destination.name`, stable `messaging.operation.name` (`send`), `messaging.operation.type` (`send`), `messaging.client.id`; or old `messaging.operation` (`publish`), `messaging.client_id`; `messaging.destination.partition.id` (on completion), `messaging.kafka.offset` / `messaging.kafka.message.offset` (stable/old), `messaging.kafka.message.key`, `messaging.kafka.message.tombstone`, `error.type` (stable), captured `messaging.header.*` | Header attributes use `otel.instrumentation.messaging.experimental.headers.included`/`.excluded` selectors; legacy `otel.instrumentation.messaging.experimental.capture-headers` is deprecated. |
| `poll {messaging.destination.name}` (stable); `{messaging.destination.name} receive` (old) | CONSUMER | `messaging.system`, `messaging.destination.name`, stable `messaging.operation.name` (`poll`), `messaging.operation.type` (`receive`), `messaging.client.id`, `messaging.consumer.group.name`; or old `messaging.operation` (`receive`), `messaging.client_id`, `messaging.kafka.consumer.group`; `messaging.batch.message_count`, `error.type` (stable), captured `messaging.header.*` | Receive telemetry disabled by default; enable with `otel.instrumentation.messaging.experimental.receive-telemetry.enabled`. |
| `process {messaging.destination.name}` (stable); `{messaging.destination.name} process` (old) | CONSUMER | `messaging.system`, `messaging.destination.name`, stable `messaging.operation.name`/`messaging.operation.type` (`process`), `messaging.client.id`, `messaging.consumer.group.name`; or old `messaging.operation` (`process`), `messaging.client_id`, `messaging.kafka.consumer.group`; `messaging.destination.partition.id`, old `messaging.message.body.size`, `messaging.kafka.offset` / `messaging.kafka.message.offset` (stable/old), `messaging.kafka.message.key`, `messaging.kafka.message.tombstone`, `error.type` (stable), `kafka.record.queue_time_ms`, captured `messaging.header.*` | `kafka.record.queue_time_ms` and `messaging.kafka.bootstrap.servers` gated by `otel.instrumentation.kafka.experimental-span-attributes`; queue time requires record timestamp. Kafka Connect emits batch process span with `messaging.batch.message_count` and per-record links; Kafka Streams emits a process span per processed source record. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `messaging.client.operation.duration` | Histogram | s | `messaging.system`, `messaging.operation.name`, `messaging.operation.type`, `messaging.destination.name`, `messaging.consumer.group.name`, `messaging.destination.partition.id`, `error.type` | Stable messaging conventions for send and receive/poll; interceptor-only instrumentation omits it. |
| `messaging.client.sent.messages` | Counter | `{message}` | `messaging.system`, `messaging.operation.name`, `messaging.destination.name`, `messaging.destination.partition.id`, `error.type` | Stable conventions; counts attempted producer sends. |
| `messaging.client.consumed.messages` | Counter | `{message}` | `messaging.system`, `messaging.operation.name`, `messaging.destination.name`, `messaging.consumer.group.name`, `messaging.destination.partition.id`, `error.type` | Recorded once by receive/poll or process when receive telemetry is suppressed. |
| `messaging.process.duration` | Histogram | s | `messaging.system`, `messaging.operation.name`, `messaging.destination.name`, `messaging.consumer.group.name`, `messaging.destination.partition.id`, `error.type` | Stable messaging conventions for processing duration. |
| `kafka.consumer.<kafka-metric-name>` | Observable gauge or observable counter for cumulative sum/count measurables | `{kafka metric unit}` | Kafka metric tags | Dynamically bridges measurable Kafka client metrics for groups containing `consumer`; requires `OpenTelemetryMetricsReporter` configured through `KafkaTelemetry`; names replace `-` with `_`. |
| `kafka.producer.<kafka-metric-name>` | Observable gauge or observable counter for cumulative sum/count measurables | `{kafka metric unit}` | Kafka metric tags | Same dynamic reporter behavior for groups containing `producer`; names replace `-` with `_`. |

## Sources

- `instrumentation/kafka/README.md`
- `instrumentation/kafka/kafka-clients/kafka-clients-common-0.11/library/src/main/java/.../internal/` (instrumenter, extractors, metric registry and reporter)
- `instrumentation/kafka/kafka-clients/kafka-clients-2.6/library/src/main/java/io/opentelemetry/instrumentation/kafkaclients/v2_6/`
- `instrumentation/kafka/kafka-connect-2.6/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/kafkaconnect/v2_6/`
- `instrumentation/kafka/kafka-streams-0.11/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/kafkastreams/v0_11/`
- `instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/messaging/{MessagingAttributesExtractor,MessagingSpanNameExtractor,MessagingProducerMetrics,MessagingConsumerMetrics,MessagingProcessMetrics}.java`
      • logback
        • v2.28.1.md 734 B 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/logback
version: v2.28.1
scope_name: Logback logger name (ROOT when absent)
commit_sha: 7ad453a58de282ea04fd88f4178d70a65468b93c
last_verified: null
---

# Logback

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| Logback event message | , , , , ; , , ,  (old semconv) or , ,  (stable); , ; selected MDC, logger-context, SLF4J key-value pairs, Logstash markers and structured arguments; ; optionally , ; trace/span context and resource attributes | Experimental/capture settings gate code, marker, template/arguments, MDC, logger-context, key-value and Logstash attributes; MDC appender adds baggage only when . |

## Sources

- 
- 
-
        • v2.29.0.md 734 B 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/logback
version: v2.29.0
scope_name: Logback logger name (ROOT when absent)
commit_sha: c215cb489a90d95c2ea5808fbdcd2f7d81d2f2ae
last_verified: null
---

# Logback

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| Logback event message | , , , , ; , , ,  (old semconv) or , ,  (stable); , ; selected MDC, logger-context, SLF4J key-value pairs, Logstash markers and structured arguments; ; optionally , ; trace/span context and resource attributes | Experimental/capture settings gate code, marker, template/arguments, MDC, logger-context, key-value and Logstash attributes; MDC appender adds baggage only when . |

## Sources

- 
- 
-
        • v2.30.0.md 734 B 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/logback
version: v2.30.0
scope_name: Logback logger name (ROOT when absent)
commit_sha: 080c1d32ca676ba7b0210c21b60cce8e7ac39058
last_verified: null
---

# Logback

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| Logback event message | , , , , ; , , ,  (old semconv) or , ,  (stable); , ; selected MDC, logger-context, SLF4J key-value pairs, Logstash markers and structured arguments; ; optionally , ; trace/span context and resource attributes | Experimental/capture settings gate code, marker, template/arguments, MDC, logger-context, key-value and Logstash attributes; MDC appender adds baggage only when . |

## Sources

- 
- 
-
        • v2.31.0.md 734 B 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/logback
version: v2.31.0
scope_name: Logback logger name (ROOT when absent)
commit_sha: 18da99bef6a5f1becdeb8091136f12c43742b9b7
last_verified: null
---

# Logback

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| Logback event message | , , , , ; , , ,  (old semconv) or , ,  (stable); , ; selected MDC, logger-context, SLF4J key-value pairs, Logstash markers and structured arguments; ; optionally , ; trace/span context and resource attributes | Experimental/capture settings gate code, marker, template/arguments, MDC, logger-context, key-value and Logstash attributes; MDC appender adds baggage only when . |

## Sources

- 
- 
-
        • v2.31.1.md 734 B 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/logback
version: v2.31.1
scope_name: Logback logger name (ROOT when absent)
commit_sha: 8ad06a082e051f366f19c16ad95a7b68edf30afd
last_verified: null
---

# Logback

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| Logback event message | , , , , ; , , ,  (old semconv) or , ,  (stable); , ; selected MDC, logger-context, SLF4J key-value pairs, Logstash markers and structured arguments; ; optionally , ; trace/span context and resource attributes | Experimental/capture settings gate code, marker, template/arguments, MDC, logger-context, key-value and Logstash attributes; MDC appender adds baggage only when . |

## Sources

- 
- 
-
        • v2.32.0.md 734 B 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/logback
version: v2.32.0
scope_name: Logback logger name (ROOT when absent)
commit_sha: 1b8644f8eb11d90295b1c313391aa84edeeec6e2
last_verified: null
---

# Logback

## Logs

| Log/event name | Attributes | Notes |
|---|---|---|
| Logback event message | , , , , ; , , ,  (old semconv) or , ,  (stable); , ; selected MDC, logger-context, SLF4J key-value pairs, Logstash markers and structured arguments; ; optionally , ; trace/span context and resource attributes | Experimental/capture settings gate code, marker, template/arguments, MDC, logger-context, key-value and Logstash attributes; MDC appender adds baggage only when . |

## Sources

- 
- 
-
      • netty
        • v2.28.1.md 1.8 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/netty
version: v2.28.1
scope_name: io.opentelemetry.netty
commit_sha: 7ad453a58de282ea04fd88f4178d70a65468b93c
last_verified: 2026-10-14
---

# Netty instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| HTTP client span (HTTP method + target, per HTTP semantic conventions) | CLIENT | HTTP client request/response attributes, network peer/server attributes, error attributes | Netty 3.8/4.0/4.1 HTTP client instrumentation; standard HTTP instrumenter |
| HTTP server span (HTTP method + target, per HTTP semantic conventions) | SERVER | HTTP server request/response attributes, network client attributes, error attributes | Netty 4.1 server instrumentation; standard HTTP instrumenter |
| connect | CLIENT | network peer/server address and port, error attributes | Netty 4.x connection instrumentation; emitted when connection instrumentation is enabled |
| ssl.handshake | CLIENT | network peer/server address and port, error attributes | Netty 4.x TLS handshake instrumentation; failures only |

## Sources

- `instrumentation/netty/netty-3.8/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/netty/v3_8/client/NettyClientSingletons.java`
- `instrumentation/netty/netty-4.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/netty/v4_0/client/NettyClientSingletons.java`
- `instrumentation/netty/netty-4.1/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/netty/v4_1/NettyClientSingletons.java`
- `instrumentation/netty/netty-4.1/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/netty/v4_1/NettyServerSingletons.java`
- `instrumentation/netty/netty-common-4.0/library/src/main/java/io/opentelemetry/instrumentation/netty/common/v4_0/internal/client/NettyClientInstrumenterFactory.java`
        • v2.29.0.md 1.8 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/netty
version: v2.29.0
scope_name: io.opentelemetry.netty
commit_sha: c215cb489a90d95c2ea5808fbdcd2f7d81d2f2ae
last_verified: 2026-10-14
---

# Netty instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| HTTP client span (HTTP method + target, per HTTP semantic conventions) | CLIENT | HTTP client request/response attributes, network peer/server attributes, error attributes | Netty 3.8/4.0/4.1 HTTP client instrumentation; standard HTTP instrumenter |
| HTTP server span (HTTP method + target, per HTTP semantic conventions) | SERVER | HTTP server request/response attributes, network client attributes, error attributes | Netty 4.1 server instrumentation; standard HTTP instrumenter |
| connect | CLIENT | network peer/server address and port, error attributes | Netty 4.x connection instrumentation; emitted when connection instrumentation is enabled |
| ssl.handshake | CLIENT | network peer/server address and port, error attributes | Netty 4.x TLS handshake instrumentation; failures only |

## Sources

- `instrumentation/netty/netty-3.8/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/netty/v3_8/client/NettyClientSingletons.java`
- `instrumentation/netty/netty-4.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/netty/v4_0/client/NettyClientSingletons.java`
- `instrumentation/netty/netty-4.1/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/netty/v4_1/NettyClientSingletons.java`
- `instrumentation/netty/netty-4.1/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/netty/v4_1/NettyServerSingletons.java`
- `instrumentation/netty/netty-common-4.0/library/src/main/java/io/opentelemetry/instrumentation/netty/common/v4_0/internal/client/NettyClientInstrumenterFactory.java`
        • v2.30.0.md 1.8 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/netty
version: v2.30.0
scope_name: io.opentelemetry.netty
commit_sha: 080c1d32ca676ba7b0210c21b60cce8e7ac39058
last_verified: 2026-10-14
---

# Netty instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| HTTP client span (HTTP method + target, per HTTP semantic conventions) | CLIENT | HTTP client request/response attributes, network peer/server attributes, error attributes | Netty 3.8/4.0/4.1 HTTP client instrumentation; standard HTTP instrumenter |
| HTTP server span (HTTP method + target, per HTTP semantic conventions) | SERVER | HTTP server request/response attributes, network client attributes, error attributes | Netty 4.1 server instrumentation; standard HTTP instrumenter |
| connect | CLIENT | network peer/server address and port, error attributes | Netty 4.x connection instrumentation; emitted when connection instrumentation is enabled |
| ssl.handshake | CLIENT | network peer/server address and port, error attributes | Netty 4.x TLS handshake instrumentation; failures only |

## Sources

- `instrumentation/netty/netty-3.8/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/netty/v3_8/client/NettyClientSingletons.java`
- `instrumentation/netty/netty-4.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/netty/v4_0/client/NettyClientSingletons.java`
- `instrumentation/netty/netty-4.1/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/netty/v4_1/NettyClientSingletons.java`
- `instrumentation/netty/netty-4.1/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/netty/v4_1/NettyServerSingletons.java`
- `instrumentation/netty/netty-common-4.0/library/src/main/java/io/opentelemetry/instrumentation/netty/common/v4_0/internal/client/NettyClientInstrumenterFactory.java`
        • v2.31.0.md 1.8 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/netty
version: v2.31.0
scope_name: io.opentelemetry.netty
commit_sha: 18da99bef6a5f1becdeb8091136f12c43742b9b7
last_verified: 2026-10-14
---

# Netty instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| HTTP client span (HTTP method + target, per HTTP semantic conventions) | CLIENT | HTTP client request/response attributes, network peer/server attributes, error attributes | Netty 3.8/4.0/4.1 HTTP client instrumentation; standard HTTP instrumenter |
| HTTP server span (HTTP method + target, per HTTP semantic conventions) | SERVER | HTTP server request/response attributes, network client attributes, error attributes | Netty 4.1 server instrumentation; standard HTTP instrumenter |
| connect | CLIENT | network peer/server address and port, error attributes | Netty 4.x connection instrumentation; emitted when connection instrumentation is enabled |
| ssl.handshake | CLIENT | network peer/server address and port, error attributes | Netty 4.x TLS handshake instrumentation; failures only |

## Sources

- `instrumentation/netty/netty-3.8/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/netty/v3_8/client/NettyClientSingletons.java`
- `instrumentation/netty/netty-4.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/netty/v4_0/client/NettyClientSingletons.java`
- `instrumentation/netty/netty-4.1/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/netty/v4_1/NettyClientSingletons.java`
- `instrumentation/netty/netty-4.1/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/netty/v4_1/NettyServerSingletons.java`
- `instrumentation/netty/netty-common-4.0/library/src/main/java/io/opentelemetry/instrumentation/netty/common/v4_0/internal/client/NettyClientInstrumenterFactory.java`
        • v2.31.1.md 1.8 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/netty
version: v2.31.1
scope_name: io.opentelemetry.netty
commit_sha: 8ad06a082e051f366f19c16ad95a7b68edf30afd
last_verified: 2026-10-14
---

# Netty instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| HTTP client span (HTTP method + target, per HTTP semantic conventions) | CLIENT | HTTP client request/response attributes, network peer/server attributes, error attributes | Netty 3.8/4.0/4.1 HTTP client instrumentation; standard HTTP instrumenter |
| HTTP server span (HTTP method + target, per HTTP semantic conventions) | SERVER | HTTP server request/response attributes, network client attributes, error attributes | Netty 4.1 server instrumentation; standard HTTP instrumenter |
| connect | CLIENT | network peer/server address and port, error attributes | Netty 4.x connection instrumentation; emitted when connection instrumentation is enabled |
| ssl.handshake | CLIENT | network peer/server address and port, error attributes | Netty 4.x TLS handshake instrumentation; failures only |

## Sources

- `instrumentation/netty/netty-3.8/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/netty/v3_8/client/NettyClientSingletons.java`
- `instrumentation/netty/netty-4.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/netty/v4_0/client/NettyClientSingletons.java`
- `instrumentation/netty/netty-4.1/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/netty/v4_1/NettyClientSingletons.java`
- `instrumentation/netty/netty-4.1/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/netty/v4_1/NettyServerSingletons.java`
- `instrumentation/netty/netty-common-4.0/library/src/main/java/io/opentelemetry/instrumentation/netty/common/v4_0/internal/client/NettyClientInstrumenterFactory.java`
        • v2.32.0.md 1.8 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/netty
version: v2.32.0
scope_name: io.opentelemetry.netty
commit_sha: 1b8644f8eb11d90295b1c313391aa84edeeec6e2
last_verified: 2026-10-14
---

# Netty instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| HTTP client span (HTTP method + target, per HTTP semantic conventions) | CLIENT | HTTP client request/response attributes, network peer/server attributes, error attributes | Netty 3.8/4.0/4.1 HTTP client instrumentation; standard HTTP instrumenter |
| HTTP server span (HTTP method + target, per HTTP semantic conventions) | SERVER | HTTP server request/response attributes, network client attributes, error attributes | Netty 4.1 server instrumentation; standard HTTP instrumenter |
| connect | CLIENT | network peer/server address and port, error attributes | Netty 4.x connection instrumentation; emitted when connection instrumentation is enabled |
| ssl.handshake | CLIENT | network peer/server address and port, error attributes | Netty 4.x TLS handshake instrumentation; failures only |

## Sources

- `instrumentation/netty/netty-3.8/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/netty/v3_8/client/NettyClientSingletons.java`
- `instrumentation/netty/netty-4.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/netty/v4_0/client/NettyClientSingletons.java`
- `instrumentation/netty/netty-4.1/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/netty/v4_1/NettyClientSingletons.java`
- `instrumentation/netty/netty-4.1/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/netty/v4_1/NettyServerSingletons.java`
- `instrumentation/netty/netty-common-4.0/library/src/main/java/io/opentelemetry/instrumentation/netty/common/v4_0/internal/client/NettyClientInstrumenterFactory.java`
      • servlet
        • v2.26.1.md 2.9 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/servlet
version: v2.26.1
scope_name: io.opentelemetry.servlet-2.2, io.opentelemetry.servlet-3.0, io.opentelemetry.servlet-5.0
commit_sha: 9cf4fbaaa9e79226142b2ed42a6f6b4ac0be2197
last_verified: 2026-08-11
---

# Servlet

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `<HTTP method> [<route>]` | SERVER | `client.address`, `error.type`, `http.request.method`, `http.request.method_original`, `http.response.status_code`, `http.route` (Servlet 3+/5 only), `network.peer.address`, `network.peer.port` (Servlet 3+/5 only), `network.protocol.name`, `network.protocol.version`, `server.address`, `server.port`, `url.path`, `url.query`, `url.scheme`, `user_agent.original`; optionally `servlet.request.parameter.<name>` (string array), `servlet.timeout`, `enduser.id` | Parameter capture and experimental span attributes are opt-in; `enduser.id` requires agent user-name capture. |
| `HttpServletResponse.sendRedirect` | INTERNAL | `code.function`, `code.namespace` | Java agent response instrumentation only; active server span required. |
| `HttpServletResponse.sendError` | INTERNAL | `code.function`, `code.namespace` | Java agent response instrumentation only; active server span required. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.server.request.duration` | Histogram | `s` | `error.type`, `http.request.method`, `http.response.status_code`, `http.route` (Servlet 3+/5 only), `network.protocol.name`, `network.protocol.version`, `server.address`, `server.port`, `url.scheme` | - |
| `http.server.active_requests` | UpDownCounter | `{requests}` | HTTP server request attributes available at start | Requires experimental HTTP server telemetry. |
| `http.server.request.body.size` | Histogram | `By` | HTTP server request attributes | Requires experimental HTTP server telemetry; only recorded when size is available. |
| `http.server.response.body.size` | Histogram | `By` | HTTP server response attributes | Requires experimental HTTP server telemetry; only recorded when size is available. |

## Sources

- `instrumentation/servlet/servlet-common/library/src/main/java/io/opentelemetry/instrumentation/servlet/internal/ServletHttpAttributesGetter.java`
- `instrumentation/servlet/servlet-common/library/src/main/java/io/opentelemetry/instrumentation/servlet/internal/ServletAdditionalAttributesExtractor.java`
- `instrumentation/servlet/servlet-common/library/src/main/java/io/opentelemetry/instrumentation/servlet/internal/ServletRequestParametersExtractor.java`
- `instrumentation/servlet/servlet-common/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/servlet/common/response/ResponseInstrumenterFactory.java`
- `instrumentation/servlet/servlet-{2.2,3.0,5.0}/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/servlet/*/Servlet*Singletons.java`
        • v2.27.0.md 2.9 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/servlet
version: v2.27.0
scope_name: io.opentelemetry.servlet-2.2, io.opentelemetry.servlet-3.0, io.opentelemetry.servlet-5.0
commit_sha: f1973d410d516461d08e3799343d7e368f309b84
last_verified: 2026-08-11
---

# Servlet

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `<HTTP method> [<route>]` | SERVER | `client.address`, `error.type`, `http.request.method`, `http.request.method_original`, `http.response.status_code`, `http.route` (Servlet 3+/5 only), `network.peer.address`, `network.peer.port` (Servlet 3+/5 only), `network.protocol.name`, `network.protocol.version`, `server.address`, `server.port`, `url.path`, `url.query`, `url.scheme`, `user_agent.original`; optionally `servlet.request.parameter.<name>` (string array), `servlet.timeout`, `enduser.id` | Parameter capture and experimental span attributes are opt-in; `enduser.id` requires agent user-name capture. |
| `HttpServletResponse.sendRedirect` | INTERNAL | `code.function`, `code.namespace` | Java agent response instrumentation only; active server span required. |
| `HttpServletResponse.sendError` | INTERNAL | `code.function`, `code.namespace` | Java agent response instrumentation only; active server span required. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.server.request.duration` | Histogram | `s` | `error.type`, `http.request.method`, `http.response.status_code`, `http.route` (Servlet 3+/5 only), `network.protocol.name`, `network.protocol.version`, `server.address`, `server.port`, `url.scheme` | - |
| `http.server.active_requests` | UpDownCounter | `{requests}` | HTTP server request attributes available at start | Requires experimental HTTP server telemetry. |
| `http.server.request.body.size` | Histogram | `By` | HTTP server request attributes | Requires experimental HTTP server telemetry; only recorded when size is available. |
| `http.server.response.body.size` | Histogram | `By` | HTTP server response attributes | Requires experimental HTTP server telemetry; only recorded when size is available. |

## Sources

- `instrumentation/servlet/servlet-common/library/src/main/java/io/opentelemetry/instrumentation/servlet/internal/ServletHttpAttributesGetter.java`
- `instrumentation/servlet/servlet-common/library/src/main/java/io/opentelemetry/instrumentation/servlet/internal/ServletAdditionalAttributesExtractor.java`
- `instrumentation/servlet/servlet-common/library/src/main/java/io/opentelemetry/instrumentation/servlet/internal/ServletRequestParametersExtractor.java`
- `instrumentation/servlet/servlet-common/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/servlet/common/response/ResponseInstrumenterFactory.java`
- `instrumentation/servlet/servlet-{2.2,3.0,5.0}/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/servlet/*/Servlet*Singletons.java`
        • v2.28.0.md 2.9 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/servlet
version: v2.28.0
scope_name: io.opentelemetry.servlet-2.2, io.opentelemetry.servlet-3.0, io.opentelemetry.servlet-5.0
commit_sha: 9ef68e6b114b2d1fc1f6a3fbc576cb37fc71e893
last_verified: 2026-08-11
---

# Servlet

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `<HTTP method> [<route>]` | SERVER | `client.address`, `error.type`, `http.request.method`, `http.request.method_original`, `http.response.status_code`, `http.route` (Servlet 3+/5 only), `network.peer.address`, `network.peer.port` (Servlet 3+/5 only), `network.protocol.name`, `network.protocol.version`, `server.address`, `server.port`, `url.path`, `url.query`, `url.scheme`, `user_agent.original`; optionally `servlet.request.parameter.<name>` (string array), `servlet.timeout`, `enduser.id` | Parameter capture and experimental span attributes are opt-in; `enduser.id` requires agent user-name capture. |
| `HttpServletResponse.sendRedirect` | INTERNAL | `code.function`, `code.namespace` | Java agent response instrumentation only; active server span required. |
| `HttpServletResponse.sendError` | INTERNAL | `code.function`, `code.namespace` | Java agent response instrumentation only; active server span required. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.server.request.duration` | Histogram | `s` | `error.type`, `http.request.method`, `http.response.status_code`, `http.route` (Servlet 3+/5 only), `network.protocol.name`, `network.protocol.version`, `server.address`, `server.port`, `url.scheme` | - |
| `http.server.active_requests` | UpDownCounter | `{requests}` | HTTP server request attributes available at start | Requires experimental HTTP server telemetry. |
| `http.server.request.body.size` | Histogram | `By` | HTTP server request attributes | Requires experimental HTTP server telemetry; only recorded when size is available. |
| `http.server.response.body.size` | Histogram | `By` | HTTP server response attributes | Requires experimental HTTP server telemetry; only recorded when size is available. |

## Sources

- `instrumentation/servlet/servlet-common/library/src/main/java/io/opentelemetry/instrumentation/servlet/internal/ServletHttpAttributesGetter.java`
- `instrumentation/servlet/servlet-common/library/src/main/java/io/opentelemetry/instrumentation/servlet/internal/ServletAdditionalAttributesExtractor.java`
- `instrumentation/servlet/servlet-common/library/src/main/java/io/opentelemetry/instrumentation/servlet/internal/ServletRequestParametersExtractor.java`
- `instrumentation/servlet/servlet-common/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/servlet/common/response/ResponseInstrumenterFactory.java`
- `instrumentation/servlet/servlet-{2.2,3.0,5.0}/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/servlet/*/Servlet*Singletons.java`
        • v2.28.1.md 2.9 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/servlet
version: v2.28.1
scope_name: io.opentelemetry.servlet-2.2, io.opentelemetry.servlet-3.0, io.opentelemetry.servlet-5.0
commit_sha: 7ad453a58de282ea04fd88f4178d70a65468b93c
last_verified: 2026-08-11
---

# Servlet

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `<HTTP method> [<route>]` | SERVER | `client.address`, `error.type`, `http.request.method`, `http.request.method_original`, `http.response.status_code`, `http.route` (Servlet 3+/5 only), `network.peer.address`, `network.peer.port` (Servlet 3+/5 only), `network.protocol.name`, `network.protocol.version`, `server.address`, `server.port`, `url.path`, `url.query`, `url.scheme`, `user_agent.original`; optionally `servlet.request.parameter.<name>` (string array), `servlet.timeout`, `enduser.id` | Parameter capture and experimental span attributes are opt-in; `enduser.id` requires agent user-name capture. |
| `HttpServletResponse.sendRedirect` | INTERNAL | `code.function`, `code.namespace` | Java agent response instrumentation only; active server span required. |
| `HttpServletResponse.sendError` | INTERNAL | `code.function`, `code.namespace` | Java agent response instrumentation only; active server span required. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.server.request.duration` | Histogram | `s` | `error.type`, `http.request.method`, `http.response.status_code`, `http.route` (Servlet 3+/5 only), `network.protocol.name`, `network.protocol.version`, `server.address`, `server.port`, `url.scheme` | - |
| `http.server.active_requests` | UpDownCounter | `{requests}` | HTTP server request attributes available at start | Requires experimental HTTP server telemetry. |
| `http.server.request.body.size` | Histogram | `By` | HTTP server request attributes | Requires experimental HTTP server telemetry; only recorded when size is available. |
| `http.server.response.body.size` | Histogram | `By` | HTTP server response attributes | Requires experimental HTTP server telemetry; only recorded when size is available. |

## Sources

- `instrumentation/servlet/servlet-common/library/src/main/java/io/opentelemetry/instrumentation/servlet/internal/ServletHttpAttributesGetter.java`
- `instrumentation/servlet/servlet-common/library/src/main/java/io/opentelemetry/instrumentation/servlet/internal/ServletAdditionalAttributesExtractor.java`
- `instrumentation/servlet/servlet-common/library/src/main/java/io/opentelemetry/instrumentation/servlet/internal/ServletRequestParametersExtractor.java`
- `instrumentation/servlet/servlet-common/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/servlet/common/response/ResponseInstrumenterFactory.java`
- `instrumentation/servlet/servlet-{2.2,3.0,5.0}/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/servlet/*/Servlet*Singletons.java`
        • v2.29.0.md 3 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/servlet
version: v2.29.0
scope_name: io.opentelemetry.servlet-2.2, io.opentelemetry.servlet-3.0, io.opentelemetry.servlet-5.0
commit_sha: c215cb489a90d95c2ea5808fbdcd2f7d81d2f2ae
last_verified: 2026-08-11
---

# Servlet

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `<HTTP method> [<route>]` | SERVER | `client.address`, `error.type`, `http.request.method`, `http.request.method_original`, `http.response.status_code`, `http.route` (Servlet 3+/5 only), `network.peer.address`, `network.peer.port` (Servlet 3+/5 only), `network.protocol.name`, `network.protocol.version`, `server.address`, `server.port`, `url.path`, `url.query`, `url.scheme`, `user_agent.original`; optionally `servlet.request.parameter.<name>` (string array), `servlet.timeout`, `user.name`/`enduser.id` | Parameter capture, experimental span attributes, and agent user-name capture are opt-in. `user.name` is used with semconv v3 preview; otherwise `enduser.id`. |
| `HttpServletResponse.sendRedirect` | INTERNAL | `code.function`, `code.namespace` | Java agent response instrumentation only; active server span required. |
| `HttpServletResponse.sendError` | INTERNAL | `code.function`, `code.namespace` | Java agent response instrumentation only; active server span required. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.server.request.duration` | Histogram | `s` | `error.type`, `http.request.method`, `http.response.status_code`, `http.route` (Servlet 3+/5 only), `network.protocol.name`, `network.protocol.version`, `server.address`, `server.port`, `url.scheme` | - |
| `http.server.active_requests` | UpDownCounter | `{requests}` | HTTP server request attributes available at start | Requires experimental HTTP server telemetry. |
| `http.server.request.body.size` | Histogram | `By` | HTTP server request attributes | Requires experimental HTTP server telemetry; only recorded when size is available. |
| `http.server.response.body.size` | Histogram | `By` | HTTP server response attributes | Requires experimental HTTP server telemetry; only recorded when size is available. |

## Sources

- `instrumentation/servlet/servlet-common/library/src/main/java/io/opentelemetry/instrumentation/servlet/common/internal/ServletHttpAttributesGetter.java`
- `instrumentation/servlet/servlet-common/library/src/main/java/io/opentelemetry/instrumentation/servlet/common/internal/ServletAdditionalAttributesExtractor.java`
- `instrumentation/servlet/servlet-common/library/src/main/java/io/opentelemetry/instrumentation/servlet/common/internal/ServletRequestParametersExtractor.java`
- `instrumentation/servlet/servlet-common/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/servlet/common/response/ResponseInstrumenterFactory.java`
- `instrumentation/servlet/servlet-{2.2,3.0,5.0}/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/servlet/*/Servlet*Singletons.java`
        • v2.30.0.md 3.7 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/servlet
version: v2.30.0
scope_name: io.opentelemetry.servlet-2.2, io.opentelemetry.servlet-3.0, io.opentelemetry.servlet-5.0
commit_sha: 080c1d32ca676ba7b0210c21b60cce8e7ac39058
last_verified: 2026-08-11
---

# Servlet

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `<HTTP method> [<route>]` | SERVER | `client.address`, `error.type`, `http.request.method`, `http.request.method_original`, `http.response.status_code`, `http.route` (Servlet 3+/5 only), `network.peer.address`, `network.peer.port` (Servlet 3+/5 only), `network.protocol.name`, `network.protocol.version`, `server.address`, `server.port`, `url.path`, `url.query`, `url.scheme`, `user_agent.original`; optionally `servlet.request.parameter.<name>` (string array), `servlet.timeout`, `user.name`/`enduser.id`, `http.request.body.size`, `http.response.body.size` | `servlet.request.parameter.<name>` requires configured request-parameter capture; `servlet.timeout` requires `otel.instrumentation.servlet.experimental-span-attributes`; `user.name` (semconv v3 preview) or `enduser.id` requires agent user-name capture; body-size attributes require experimental HTTP server telemetry. |
| `HttpServletResponse.sendRedirect` | INTERNAL | `code.function`, `code.namespace` | Java agent response instrumentation only; emitted when called inside an active servlet server span. |
| `HttpServletResponse.sendError` | INTERNAL | `code.function`, `code.namespace` | Java agent response instrumentation only; emitted when called inside an active servlet server span. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.server.request.duration` | Histogram | `s` | `error.type`, `http.request.method`, `http.response.status_code`, `http.route` (Servlet 3+/5 only), `network.protocol.name`, `network.protocol.version`, `server.address`, `server.port`, `url.scheme` | - |
| `http.server.active_requests` | UpDownCounter | `{requests}` | HTTP server request attributes available at start, including `http.request.method`, `server.address`, `server.port`, `url.scheme`, `network.protocol.name`, `network.protocol.version` | Requires experimental HTTP server telemetry (`http.server.emit-experimental-telemetry`). |
| `http.server.request.body.size` | Histogram | `By` | HTTP server request attributes | Requires experimental HTTP server telemetry; recorded only when a request body size is available. |
| `http.server.response.body.size` | Histogram | `By` | HTTP server response attributes | Requires experimental HTTP server telemetry; recorded only when a response body size is available. |

## Sources

- `instrumentation/servlet/servlet-common/library/src/main/java/io/opentelemetry/instrumentation/servlet/common/internal/ServletHttpAttributesGetter.java`
- `instrumentation/servlet/servlet-common/library/src/main/java/io/opentelemetry/instrumentation/servlet/common/internal/ServletAdditionalAttributesExtractor.java`
- `instrumentation/servlet/servlet-common/library/src/main/java/io/opentelemetry/instrumentation/servlet/common/internal/ServletRequestParametersExtractor.java`
- `instrumentation/servlet/servlet-common/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/servlet/common/response/ResponseInstrumenterFactory.java`
- `instrumentation/servlet/servlet-2.2/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/servlet/v2_2/Servlet2Singletons.java`
- `instrumentation/servlet/servlet-3.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/servlet/v3_0/Servlet3Singletons.java`
- `instrumentation/servlet/servlet-5.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/servlet/v5_0/Servlet5Singletons.java`
        • v2.31.1.md 4 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/servlet
version: v2.31.1
scope_name: io.opentelemetry.servlet-2.2, io.opentelemetry.servlet-3.0, io.opentelemetry.servlet-5.0
commit_sha: 8ad06a082e051f366f19c16ad95a7b68edf30afd
last_verified: 2026-08-26
---

# Servlet

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `<HTTP method> [<route>]` | SERVER | `client.address`, `error.type`, `http.request.method`, `http.request.method_original`, `http.response.status_code`, `http.route` (Servlet 3+/5 only), `network.peer.address`, `network.peer.port` (Servlet 3+/5 only), `network.protocol.name`, `network.protocol.version`, `server.address`, `server.port`, `url.path`, `url.query`, `url.scheme`, `user_agent.original`; optionally `http.request.header.<key>`, `http.response.header.<key>`, `servlet.request.parameter.<name>` (string array), `servlet.timeout`, `user.name`/`enduser.id`, `http.request.body.size`, `http.response.body.size` | `servlet.request.parameter.<name>` uses `otel.instrumentation.servlet.experimental.request-parameters.included`/`.excluded` selectors (the legacy capture property is deprecated); captured header attributes use request/response `IncludeExclude` selectors in the Servlet 3.0 and 5.0 library builders; `servlet.timeout` requires `otel.instrumentation.servlet.experimental-span-attributes`; `user.name` (semconv v3 preview) or `enduser.id` requires agent user-name capture; body-size attributes require experimental HTTP server telemetry. |
| `HttpServletResponse.sendRedirect` | INTERNAL | `code.function`, `code.namespace` | Java agent response instrumentation only; emitted when called inside an active servlet server span. |
| `HttpServletResponse.sendError` | INTERNAL | `code.function`, `code.namespace` | Java agent response instrumentation only; emitted when called inside an active servlet server span. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.server.request.duration` | Histogram | `s` | `error.type`, `http.request.method`, `http.response.status_code`, `http.route` (Servlet 3+/5 only), `network.protocol.name`, `network.protocol.version`, `server.address`, `server.port`, `url.scheme` | - |
| `http.server.active_requests` | UpDownCounter | `{requests}` | HTTP server request attributes available at start, including `http.request.method`, `server.address`, `server.port`, `url.scheme`, `network.protocol.name`, `network.protocol.version` | Requires experimental HTTP server telemetry (`http.server.emit-experimental-telemetry`). |
| `http.server.request.body.size` | Histogram | `By` | HTTP server request attributes | Requires experimental HTTP server telemetry; recorded only when a request body size is available. |
| `http.server.response.body.size` | Histogram | `By` | HTTP server response attributes | Requires experimental HTTP server telemetry; recorded only when a response body size is available. |

## Sources

- `instrumentation/servlet/servlet-common/library/src/main/java/io/opentelemetry/instrumentation/servlet/common/internal/ServletHttpAttributesGetter.java`
- `instrumentation/servlet/servlet-common/library/src/main/java/io/opentelemetry/instrumentation/servlet/common/internal/ServletAdditionalAttributesExtractor.java`
- `instrumentation/servlet/servlet-common/library/src/main/java/io/opentelemetry/instrumentation/servlet/common/internal/ServletRequestParametersExtractor.java`
- `instrumentation/servlet/servlet-common/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/servlet/common/response/ResponseInstrumenterFactory.java`
- `instrumentation/servlet/servlet-2.2/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/servlet/v2_2/Servlet2Singletons.java`
- `instrumentation/servlet/servlet-3.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/servlet/v3_0/Servlet3Singletons.java`
- `instrumentation/servlet/servlet-5.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/servlet/v5_0/Servlet5Singletons.java`
        • v2.32.0.md 4 KB 
          ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/servlet
version: v2.32.0
scope_name: io.opentelemetry.servlet-2.2, io.opentelemetry.servlet-3.0, io.opentelemetry.servlet-5.0
commit_sha: 1b8644f8eb11d90295b1c313391aa84edeeec6e2
last_verified: 2026-10-14
---

# Servlet

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `<HTTP method> [<route>]` | SERVER | `client.address`, `error.type`, `http.request.method`, `http.request.method_original`, `http.response.status_code`, `http.route` (Servlet 3+/5 only), `network.peer.address`, `network.peer.port` (Servlet 3+/5 only), `network.protocol.name`, `network.protocol.version`, `server.address`, `server.port`, `url.path`, `url.query`, `url.scheme`, `user_agent.original`; optionally `http.request.header.<key>`, `http.response.header.<key>`, `servlet.request.parameter.<name>` (string array), `servlet.timeout`, `user.name`/`enduser.id`, `http.request.body.size`, `http.response.body.size` | `servlet.request.parameter.<name>` uses `otel.instrumentation.servlet.experimental.request-parameters.included`/`.excluded` selectors (the legacy capture property is deprecated); captured header attributes use request/response `IncludeExclude` selectors in the Servlet 3.0 and 5.0 library builders; `servlet.timeout` requires `otel.instrumentation.servlet.experimental-span-attributes`; `user.name` (semconv v3 preview) or `enduser.id` requires agent user-name capture; body-size attributes require experimental HTTP server telemetry. |
| `HttpServletResponse.sendRedirect` | INTERNAL | `code.function`, `code.namespace` | Java agent response instrumentation only; emitted when called inside an active servlet server span. |
| `HttpServletResponse.sendError` | INTERNAL | `code.function`, `code.namespace` | Java agent response instrumentation only; emitted when called inside an active servlet server span. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.server.request.duration` | Histogram | `s` | `error.type`, `http.request.method`, `http.response.status_code`, `http.route` (Servlet 3+/5 only), `network.protocol.name`, `network.protocol.version`, `server.address`, `server.port`, `url.scheme` | - |
| `http.server.active_requests` | UpDownCounter | `{requests}` | HTTP server request attributes available at start, including `http.request.method`, `server.address`, `server.port`, `url.scheme`, `network.protocol.name`, `network.protocol.version` | Requires experimental HTTP server telemetry (`http.server.emit-experimental-telemetry`). |
| `http.server.request.body.size` | Histogram | `By` | HTTP server request attributes | Requires experimental HTTP server telemetry; recorded only when a request body size is available. |
| `http.server.response.body.size` | Histogram | `By` | HTTP server response attributes | Requires experimental HTTP server telemetry; recorded only when a response body size is available. |

## Sources

- `instrumentation/servlet/servlet-common/library/src/main/java/io/opentelemetry/instrumentation/servlet/common/internal/ServletHttpAttributesGetter.java`
- `instrumentation/servlet/servlet-common/library/src/main/java/io/opentelemetry/instrumentation/servlet/common/internal/ServletAdditionalAttributesExtractor.java`
- `instrumentation/servlet/servlet-common/library/src/main/java/io/opentelemetry/instrumentation/servlet/common/internal/ServletRequestParametersExtractor.java`
- `instrumentation/servlet/servlet-common/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/servlet/common/response/ResponseInstrumenterFactory.java`
- `instrumentation/servlet/servlet-2.2/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/servlet/v2_2/Servlet2Singletons.java`
- `instrumentation/servlet/servlet-3.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/servlet/v3_0/Servlet3Singletons.java`
- `instrumentation/servlet/servlet-5.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/servlet/v5_0/Servlet5Singletons.java`
      • spring
        • spring-webflux
          • v2.25.0.md 2.8 KB 
            ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/spring/spring-webflux
version: v2.25.0
scope_name: io.opentelemetry.spring-webflux-5.0; io.opentelemetry.spring-webflux-5.3
commit_sha: 399dae91610f1acc510381676204a8fdd040fbb9
last_verified: 2026-08-11
---

# Spring WebFlux

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `{http.request.method}` | CLIENT | `http.request.method`, `url.full`, `server.address`, `server.port`, `http.response.status_code`, `error.type`; optional captured `http.request.header.<key>` and `http.response.header.<key>` | HTTP client span; header attributes are configured with `setCapturedRequestHeaders`/`setCapturedResponseHeaders`. |
| `{http.request.method} {http.route}` (or `{http.request.method} {url.path}` when no route) | SERVER | `http.request.method`, `url.scheme`, `url.path`, `url.query`, `http.route`, `http.response.status_code`, `network.peer.address`, `network.peer.port`, `network.local.address`, `network.local.port`; optional captured request/response headers | HTTP server span. |
| handler method name | INTERNAL | `code.namespace`, `code.function`, `code.filepath`, `code.line.number`, `http.route` | Spring WebFlux controller/handler span; gated by the common `controller-telemetry.enabled` setting (`otel.instrumentation.common.experimental.controller-telemetry.enabled`). |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.client.request.duration` | Histogram | s | `http.request.method`, `server.address`, `server.port`, `http.response.status_code`, `error.type`, `network.protocol.name`, `network.protocol.version`; `url.template` is included when experimental HTTP client telemetry is enabled | HTTP client metric. |
| `http.server.request.duration` | Histogram | s | `http.request.method`, `url.scheme`, `http.route`, `http.response.status_code`, `error.type`, `network.protocol.name`, `network.protocol.version`; configured experimental HTTP server telemetry may add additional experimental attributes | HTTP server metric. |

## Sources

- `instrumentation/spring/spring-webflux/spring-webflux-5.3/library/src/main/java/io/opentelemetry/instrumentation/spring/webflux/v5_3/{SpringWebfluxClientTelemetryBuilder,SpringWebfluxServerTelemetryBuilder,WebfluxServerHttpAttributesGetter}.java`
- `instrumentation/spring/spring-webflux/spring-webflux-5.3/library/src/main/java/io/opentelemetry/instrumentation/spring/webflux/v5_3/internal/{WebClientHttpAttributesGetter,WebClientTracingFilter,SpringWebfluxBuilderUtil,Experimental}.java`
- `instrumentation/spring/spring-webflux/spring-webflux-5.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webflux/v5_0/server/{WebfluxSingletons,HandlerCodeAttributesGetter,WebfluxSpanNameExtractor}.java`
- `instrumentation/spring/spring-webflux/spring-webflux-5.3/metadata.yaml`
          • v2.26.1.md 2.8 KB 
            ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/spring/spring-webflux
version: v2.26.1
scope_name: io.opentelemetry.spring-webflux-5.0; io.opentelemetry.spring-webflux-5.3
commit_sha: 9cf4fbaaa9e79226142b2ed42a6f6b4ac0be2197
last_verified: 2026-08-11
---

# Spring WebFlux

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `{http.request.method}` | CLIENT | `http.request.method`, `url.full`, `server.address`, `server.port`, `http.response.status_code`, `error.type`; optional captured `http.request.header.<key>` and `http.response.header.<key>` | HTTP client span; header attributes are configured with `setCapturedRequestHeaders`/`setCapturedResponseHeaders`. |
| `{http.request.method} {http.route}` (or `{http.request.method} {url.path}` when no route) | SERVER | `http.request.method`, `url.scheme`, `url.path`, `url.query`, `http.route`, `http.response.status_code`, `network.peer.address`, `network.peer.port`, `network.local.address`, `network.local.port`; optional captured request/response headers | HTTP server span. |
| handler method name | INTERNAL | `code.namespace`, `code.function`, `code.filepath`, `code.line.number`, `http.route` | Spring WebFlux controller/handler span; gated by the common `controller-telemetry.enabled` setting (`otel.instrumentation.common.experimental.controller-telemetry.enabled`). |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.client.request.duration` | Histogram | s | `http.request.method`, `server.address`, `server.port`, `http.response.status_code`, `error.type`, `network.protocol.name`, `network.protocol.version`; `url.template` is included when experimental HTTP client telemetry is enabled | HTTP client metric. |
| `http.server.request.duration` | Histogram | s | `http.request.method`, `url.scheme`, `http.route`, `http.response.status_code`, `error.type`, `network.protocol.name`, `network.protocol.version`; configured experimental HTTP server telemetry may add additional experimental attributes | HTTP server metric. |

## Sources

- `instrumentation/spring/spring-webflux/spring-webflux-5.3/library/src/main/java/io/opentelemetry/instrumentation/spring/webflux/v5_3/{SpringWebfluxClientTelemetryBuilder,SpringWebfluxServerTelemetryBuilder,WebfluxServerHttpAttributesGetter}.java`
- `instrumentation/spring/spring-webflux/spring-webflux-5.3/library/src/main/java/io/opentelemetry/instrumentation/spring/webflux/v5_3/internal/{WebClientHttpAttributesGetter,WebClientTracingFilter,SpringWebfluxBuilderUtil,Experimental}.java`
- `instrumentation/spring/spring-webflux/spring-webflux-5.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webflux/v5_0/server/{WebfluxSingletons,HandlerCodeAttributesGetter,WebfluxSpanNameExtractor}.java`
- `instrumentation/spring/spring-webflux/spring-webflux-5.3/metadata.yaml`
          • v2.27.0.md 2.8 KB 
            ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/spring/spring-webflux
version: v2.27.0
scope_name: io.opentelemetry.spring-webflux-5.0; io.opentelemetry.spring-webflux-5.3
commit_sha: f1973d410d516461d08e3799343d7e368f309b84
last_verified: 2026-08-11
---

# Spring WebFlux

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `{http.request.method}` | CLIENT | `http.request.method`, `url.full`, `server.address`, `server.port`, `http.response.status_code`, `error.type`; optional captured `http.request.header.<key>` and `http.response.header.<key>` | HTTP client span; header attributes are configured with `setCapturedRequestHeaders`/`setCapturedResponseHeaders`. |
| `{http.request.method} {http.route}` (or `{http.request.method} {url.path}` when no route) | SERVER | `http.request.method`, `url.scheme`, `url.path`, `url.query`, `http.route`, `http.response.status_code`, `network.peer.address`, `network.peer.port`, `network.local.address`, `network.local.port`; optional captured request/response headers | HTTP server span. |
| handler method name | INTERNAL | `code.namespace`, `code.function`, `code.filepath`, `code.line.number`, `http.route` | Spring WebFlux controller/handler span; gated by the common `controller-telemetry.enabled` setting (`otel.instrumentation.common.experimental.controller-telemetry.enabled`). |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.client.request.duration` | Histogram | s | `http.request.method`, `server.address`, `server.port`, `http.response.status_code`, `error.type`, `network.protocol.name`, `network.protocol.version`; `url.template` is included when experimental HTTP client telemetry is enabled | HTTP client metric. |
| `http.server.request.duration` | Histogram | s | `http.request.method`, `url.scheme`, `http.route`, `http.response.status_code`, `error.type`, `network.protocol.name`, `network.protocol.version`; configured experimental HTTP server telemetry may add additional experimental attributes | HTTP server metric. |

## Sources

- `instrumentation/spring/spring-webflux/spring-webflux-5.3/library/src/main/java/io/opentelemetry/instrumentation/spring/webflux/v5_3/{SpringWebfluxClientTelemetryBuilder,SpringWebfluxServerTelemetryBuilder,WebfluxServerHttpAttributesGetter}.java`
- `instrumentation/spring/spring-webflux/spring-webflux-5.3/library/src/main/java/io/opentelemetry/instrumentation/spring/webflux/v5_3/internal/{WebClientHttpAttributesGetter,WebClientTracingFilter,SpringWebfluxBuilderUtil,Experimental}.java`
- `instrumentation/spring/spring-webflux/spring-webflux-5.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webflux/v5_0/server/{WebfluxSingletons,HandlerCodeAttributesGetter,WebfluxSpanNameExtractor}.java`
- `instrumentation/spring/spring-webflux/spring-webflux-5.3/metadata.yaml`
          • v2.28.1.md 2.8 KB 
            ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/spring/spring-webflux
version: v2.28.1
scope_name: io.opentelemetry.spring-webflux-5.0; io.opentelemetry.spring-webflux-5.3
commit_sha: 7ad453a58de282ea04fd88f4178d70a65468b93c
last_verified: 2026-08-11
---

# Spring WebFlux

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `{http.request.method}` | CLIENT | `http.request.method`, `url.full`, `server.address`, `server.port`, `http.response.status_code`, `error.type`; optional captured `http.request.header.<key>` and `http.response.header.<key>` | HTTP client span; header attributes are configured with `setCapturedRequestHeaders`/`setCapturedResponseHeaders`. |
| `{http.request.method} {http.route}` (or `{http.request.method} {url.path}` when no route) | SERVER | `http.request.method`, `url.scheme`, `url.path`, `url.query`, `http.route`, `http.response.status_code`, `network.peer.address`, `network.peer.port`, `network.local.address`, `network.local.port`; optional captured request/response headers | HTTP server span. |
| handler method name | INTERNAL | `code.namespace`, `code.function`, `code.filepath`, `code.line.number`, `http.route` | Spring WebFlux controller/handler span; gated by the common `controller-telemetry.enabled` setting (`otel.instrumentation.common.experimental.controller-telemetry.enabled`). |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.client.request.duration` | Histogram | s | `http.request.method`, `server.address`, `server.port`, `http.response.status_code`, `error.type`, `network.protocol.name`, `network.protocol.version`; `url.template` is included when experimental HTTP client telemetry is enabled | HTTP client metric. |
| `http.server.request.duration` | Histogram | s | `http.request.method`, `url.scheme`, `http.route`, `http.response.status_code`, `error.type`, `network.protocol.name`, `network.protocol.version`; configured experimental HTTP server telemetry may add additional experimental attributes | HTTP server metric. |

## Sources

- `instrumentation/spring/spring-webflux/spring-webflux-5.3/library/src/main/java/io/opentelemetry/instrumentation/spring/webflux/v5_3/{SpringWebfluxClientTelemetryBuilder,SpringWebfluxServerTelemetryBuilder,WebfluxServerHttpAttributesGetter}.java`
- `instrumentation/spring/spring-webflux/spring-webflux-5.3/library/src/main/java/io/opentelemetry/instrumentation/spring/webflux/v5_3/internal/{WebClientHttpAttributesGetter,WebClientTracingFilter,SpringWebfluxBuilderUtil,Experimental}.java`
- `instrumentation/spring/spring-webflux/spring-webflux-5.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webflux/v5_0/server/{WebfluxSingletons,HandlerCodeAttributesGetter,WebfluxSpanNameExtractor}.java`
- `instrumentation/spring/spring-webflux/spring-webflux-5.3/metadata.yaml`
          • v2.29.0.md 2.8 KB 
            ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/spring/spring-webflux
version: v2.29.0
scope_name: io.opentelemetry.spring-webflux-5.0; io.opentelemetry.spring-webflux-5.3
commit_sha: c215cb489a90d95c2ea5808fbdcd2f7d81d2f2ae
last_verified: 2026-08-11
---

# Spring WebFlux

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `{http.request.method}` | CLIENT | `http.request.method`, `url.full`, `server.address`, `server.port`, `http.response.status_code`, `error.type`; optional captured `http.request.header.<key>` and `http.response.header.<key>` | HTTP client span; header attributes are configured with `setCapturedRequestHeaders`/`setCapturedResponseHeaders`. |
| `{http.request.method} {http.route}` (or `{http.request.method} {url.path}` when no route) | SERVER | `http.request.method`, `url.scheme`, `url.path`, `url.query`, `http.route`, `http.response.status_code`, `network.peer.address`, `network.peer.port`, `network.local.address`, `network.local.port`; optional captured request/response headers | HTTP server span. |
| handler method name | INTERNAL | `code.namespace`, `code.function`, `code.filepath`, `code.line.number`, `http.route` | Spring WebFlux controller/handler span; gated by the common `controller-telemetry.enabled` setting (`otel.instrumentation.common.experimental.controller-telemetry.enabled`). |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.client.request.duration` | Histogram | s | `http.request.method`, `server.address`, `server.port`, `http.response.status_code`, `error.type`, `network.protocol.name`, `network.protocol.version`; `url.template` is included when experimental HTTP client telemetry is enabled | HTTP client metric. |
| `http.server.request.duration` | Histogram | s | `http.request.method`, `url.scheme`, `http.route`, `http.response.status_code`, `error.type`, `network.protocol.name`, `network.protocol.version`; configured experimental HTTP server telemetry may add additional experimental attributes | HTTP server metric. |

## Sources

- `instrumentation/spring/spring-webflux/spring-webflux-5.3/library/src/main/java/io/opentelemetry/instrumentation/spring/webflux/v5_3/{SpringWebfluxClientTelemetryBuilder,SpringWebfluxServerTelemetryBuilder,WebfluxServerHttpAttributesGetter}.java`
- `instrumentation/spring/spring-webflux/spring-webflux-5.3/library/src/main/java/io/opentelemetry/instrumentation/spring/webflux/v5_3/internal/{WebClientHttpAttributesGetter,WebClientTracingFilter,SpringWebfluxBuilderUtil,Experimental}.java`
- `instrumentation/spring/spring-webflux/spring-webflux-5.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webflux/v5_0/server/{WebfluxSingletons,HandlerCodeAttributesGetter,WebfluxSpanNameExtractor}.java`
- `instrumentation/spring/spring-webflux/spring-webflux-5.3/metadata.yaml`
          • v2.30.0.md 2.8 KB 
            ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/spring/spring-webflux
version: v2.30.0
scope_name: io.opentelemetry.spring-webflux-5.0; io.opentelemetry.spring-webflux-5.3
commit_sha: 080c1d32ca676ba7b0210c21b60cce8e7ac39058
last_verified: 2026-08-11
---

# Spring WebFlux

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `{http.request.method}` | CLIENT | `http.request.method`, `url.full`, `server.address`, `server.port`, `http.response.status_code`, `error.type`; optional captured `http.request.header.<key>` and `http.response.header.<key>` | HTTP client span; header attributes are configured with `setCapturedRequestHeaders`/`setCapturedResponseHeaders`. |
| `{http.request.method} {http.route}` (or `{http.request.method} {url.path}` when no route) | SERVER | `http.request.method`, `url.scheme`, `url.path`, `url.query`, `http.route`, `http.response.status_code`, `network.peer.address`, `network.peer.port`, `network.local.address`, `network.local.port`; optional captured request/response headers | HTTP server span. |
| handler method name | INTERNAL | `code.namespace`, `code.function`, `code.filepath`, `code.line.number`, `http.route` | Spring WebFlux controller/handler span; gated by the common `controller-telemetry.enabled` setting (`otel.instrumentation.common.experimental.controller-telemetry.enabled`). |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.client.request.duration` | Histogram | s | `http.request.method`, `server.address`, `server.port`, `http.response.status_code`, `error.type`, `network.protocol.name`, `network.protocol.version`; `url.template` is included when experimental HTTP client telemetry is enabled | HTTP client metric. |
| `http.server.request.duration` | Histogram | s | `http.request.method`, `url.scheme`, `http.route`, `http.response.status_code`, `error.type`, `network.protocol.name`, `network.protocol.version`; configured experimental HTTP server telemetry may add additional experimental attributes | HTTP server metric. |

## Sources

- `instrumentation/spring/spring-webflux/spring-webflux-5.3/library/src/main/java/io/opentelemetry/instrumentation/spring/webflux/v5_3/{SpringWebfluxClientTelemetryBuilder,SpringWebfluxServerTelemetryBuilder,WebfluxServerHttpAttributesGetter}.java`
- `instrumentation/spring/spring-webflux/spring-webflux-5.3/library/src/main/java/io/opentelemetry/instrumentation/spring/webflux/v5_3/internal/{WebClientHttpAttributesGetter,WebClientTracingFilter,SpringWebfluxBuilderUtil,Experimental}.java`
- `instrumentation/spring/spring-webflux/spring-webflux-5.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webflux/v5_0/server/{WebfluxSingletons,HandlerCodeAttributesGetter,WebfluxSpanNameExtractor}.java`
- `instrumentation/spring/spring-webflux/spring-webflux-5.3/metadata.yaml`
          • v2.31.0.md 2.8 KB 
            ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/spring/spring-webflux
version: v2.31.0
scope_name: io.opentelemetry.spring-webflux-5.0; io.opentelemetry.spring-webflux-5.3
commit_sha: 18da99bef6a5f1becdeb8091136f12c43742b9b7
last_verified: null
---

# Spring WebFlux

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `{http.request.method}` | CLIENT | `http.request.method`, `url.full`, `server.address`, `server.port`, `http.response.status_code`, `error.type`; optional captured `http.request.header.<key>` and `http.response.header.<key>` | HTTP client span; header attributes are configured with `setCapturedRequestHeaders`/`setCapturedResponseHeaders`. |
| `{http.request.method} {http.route}` (or `{http.request.method} {url.path}` when no route) | SERVER | `http.request.method`, `url.scheme`, `url.path`, `url.query`, `http.route`, `http.response.status_code`, `network.peer.address`, `network.peer.port`, `network.local.address`, `network.local.port`; optional captured request/response headers | HTTP server span. |
| handler method name | INTERNAL | `code.namespace`, `code.function`, `code.filepath`, `code.line.number`, `http.route` | Spring WebFlux controller/handler span; gated by the common `controller-telemetry.enabled` setting (`otel.instrumentation.common.experimental.controller-telemetry.enabled`). |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.client.request.duration` | Histogram | s | `http.request.method`, `server.address`, `server.port`, `http.response.status_code`, `error.type`, `network.protocol.name`, `network.protocol.version`; `url.template` is included when experimental HTTP client telemetry is enabled | HTTP client metric. |
| `http.server.request.duration` | Histogram | s | `http.request.method`, `url.scheme`, `http.route`, `http.response.status_code`, `error.type`, `network.protocol.name`, `network.protocol.version`; configured experimental HTTP server telemetry may add additional experimental attributes | HTTP server metric. |

## Sources

- `instrumentation/spring/spring-webflux/spring-webflux-5.3/library/src/main/java/io/opentelemetry/instrumentation/spring/webflux/v5_3/{SpringWebfluxClientTelemetryBuilder,SpringWebfluxServerTelemetryBuilder,WebfluxServerHttpAttributesGetter}.java`
- `instrumentation/spring/spring-webflux/spring-webflux-5.3/library/src/main/java/io/opentelemetry/instrumentation/spring/webflux/v5_3/internal/{WebClientHttpAttributesGetter,WebClientTracingFilter,SpringWebfluxBuilderUtil,Experimental}.java`
- `instrumentation/spring/spring-webflux/spring-webflux-5.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webflux/v5_0/server/{WebfluxSingletons,HandlerCodeAttributesGetter,WebfluxSpanNameExtractor}.java`
- `instrumentation/spring/spring-webflux/spring-webflux-5.3/metadata.yaml`
          • v2.31.1.md 2.9 KB 
            ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/spring/spring-webflux
version: v2.31.1
scope_name: io.opentelemetry.spring-webflux-5.0; io.opentelemetry.spring-webflux-5.3
commit_sha: 8ad06a082e051f366f19c16ad95a7b68edf30afd
last_verified: 2026-08-26
---

# Spring WebFlux

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `{http.request.method}` | CLIENT | `http.request.method`, `url.full`, `server.address`, `server.port`, `http.response.status_code`, `error.type`; optional captured `http.request.header.<key>` and `http.response.header.<key>` | HTTP client span; header attributes use request/response `IncludeExclude` selectors; legacy captured-header collection methods are deprecated. |
| `{http.request.method} {http.route}` (or `{http.request.method} {url.path}` when no route) | SERVER | `http.request.method`, `url.scheme`, `url.path`, `url.query`, `http.route`, `http.response.status_code`, `network.peer.address`, `network.peer.port`, `network.local.address`, `network.local.port`; optional captured `http.request.header.<key>` and `http.response.header.<key>` attributes | HTTP server span. |
| handler method name | INTERNAL | `code.namespace`, `code.function`, `code.filepath`, `code.line.number`, `http.route` | Spring WebFlux controller/handler span; gated by the common `controller-telemetry.enabled` setting (`otel.instrumentation.common.experimental.controller-telemetry.enabled`). |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `http.client.request.duration` | Histogram | s | `http.request.method`, `server.address`, `server.port`, `http.response.status_code`, `error.type`, `network.protocol.name`, `network.protocol.version`; `url.template` is included when experimental HTTP client telemetry is enabled | HTTP client metric. |
| `http.server.request.duration` | Histogram | s | `http.request.method`, `url.scheme`, `http.route`, `http.response.status_code`, `error.type`, `network.protocol.name`, `network.protocol.version`; configured experimental HTTP server telemetry may add additional experimental attributes | HTTP server metric. |

## Sources

- `instrumentation/spring/spring-webflux/spring-webflux-5.3/library/src/main/java/io/opentelemetry/instrumentation/spring/webflux/v5_3/{SpringWebfluxClientTelemetryBuilder,SpringWebfluxServerTelemetryBuilder,WebfluxServerHttpAttributesGetter}.java`
- `instrumentation/spring/spring-webflux/spring-webflux-5.3/library/src/main/java/io/opentelemetry/instrumentation/spring/webflux/v5_3/internal/{WebClientHttpAttributesGetter,WebClientTracingFilter,SpringWebfluxBuilderUtil,Experimental}.java`
- `instrumentation/spring/spring-webflux/spring-webflux-5.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webflux/v5_0/server/{WebfluxSingletons,HandlerCodeAttributesGetter,WebfluxSpanNameExtractor}.java`
- `instrumentation/spring/spring-webflux/spring-webflux-5.3/metadata.yaml`
        • spring-webmvc
          • v2.28.1.md 2.2 KB 
            ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/spring/spring-webmvc
version: v2.28.1
scope_name: io.opentelemetry.spring-webmvc-6.0
commit_sha: 7ad453a58de282ea04fd88f4178d70a65468b93c
last_verified: null
---

# Spring Web MVC

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| HTTP <method> | SERVER | http.request.method, url.scheme, url.path, url.query, http.response.status_code, network.protocol.name, network.protocol.version, network.peer.address, network.peer.port, network.local.address, network.local.port, http.route, http.request.header.*, http.response.header.* | Header attributes only when configured for capture |
| <code.function> | INTERNAL | code.function, code.namespace, code.filepath, code.lineno | Controller span; gated by otel.instrumentation.experimental.controller-telemetry.enabled |
| <view name or view class> | INTERNAL | spring-webmvc.view.name, spring-webmvc.view.type | Model-and-view span; gated by otel.instrumentation.experimental.view-telemetry.enabled |

## Sources

- instrumentation/spring/spring-webmvc/spring-webmvc-6.0/library/src/main/java/io/opentelemetry/instrumentation/spring/webmvc/v6_0/SpringWebMvcTelemetryBuilder.java
- instrumentation/spring/spring-webmvc/spring-webmvc-6.0/library/src/main/java/io/opentelemetry/instrumentation/spring/webmvc/v6_0/SpringWebMvcHttpAttributesGetter.java
- instrumentation/spring/spring-webmvc/spring-webmvc-6.0/library/src/main/java/io/opentelemetry/instrumentation/spring/webmvc/v6_0/HttpRouteSupport.java
- instrumentation/spring/spring-webmvc/spring-webmvc-6.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webmvc/v6_0/HandlerAdapterInstrumentation.java
- instrumentation/spring/spring-webmvc/spring-webmvc-6.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webmvc/v6_0/DispatcherServletInstrumentation.java
- instrumentation/spring/spring-webmvc/spring-webmvc-common/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webmvc/common/SpringWebMvcInstrumenterFactory.java
- instrumentation/spring/spring-webmvc/spring-webmvc-common/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webmvc/common/ModelAndViewAttributesExtractor.java
          • v2.29.0.md 2.2 KB 
            ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/spring/spring-webmvc
version: v2.29.0
scope_name: io.opentelemetry.spring-webmvc-6.0
commit_sha: c215cb489a90d95c2ea5808fbdcd2f7d81d2f2ae
last_verified: null
---

# Spring Web MVC

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| HTTP <method> | SERVER | http.request.method, url.scheme, url.path, url.query, http.response.status_code, network.protocol.name, network.protocol.version, network.peer.address, network.peer.port, network.local.address, network.local.port, http.route, http.request.header.*, http.response.header.* | Header attributes only when configured for capture |
| <code.function> | INTERNAL | code.function, code.namespace, code.filepath, code.lineno | Controller span; gated by otel.instrumentation.experimental.controller-telemetry.enabled |
| <view name or view class> | INTERNAL | spring-webmvc.view.name, spring-webmvc.view.type | Model-and-view span; gated by otel.instrumentation.experimental.view-telemetry.enabled |

## Sources

- instrumentation/spring/spring-webmvc/spring-webmvc-6.0/library/src/main/java/io/opentelemetry/instrumentation/spring/webmvc/v6_0/SpringWebMvcTelemetryBuilder.java
- instrumentation/spring/spring-webmvc/spring-webmvc-6.0/library/src/main/java/io/opentelemetry/instrumentation/spring/webmvc/v6_0/SpringWebMvcHttpAttributesGetter.java
- instrumentation/spring/spring-webmvc/spring-webmvc-6.0/library/src/main/java/io/opentelemetry/instrumentation/spring/webmvc/v6_0/HttpRouteSupport.java
- instrumentation/spring/spring-webmvc/spring-webmvc-6.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webmvc/v6_0/HandlerAdapterInstrumentation.java
- instrumentation/spring/spring-webmvc/spring-webmvc-6.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webmvc/v6_0/DispatcherServletInstrumentation.java
- instrumentation/spring/spring-webmvc/spring-webmvc-common-3.1/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webmvc/common/v3_1/SpringWebMvcInstrumenterFactory.java
- instrumentation/spring/spring-webmvc/spring-webmvc-common-3.1/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webmvc/common/v3_1/ModelAndViewAttributesExtractor.java
          • v2.30.0.md 2.2 KB 
            ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/spring/spring-webmvc
version: v2.30.0
scope_name: io.opentelemetry.spring-webmvc-6.0
commit_sha: 080c1d32ca676ba7b0210c21b60cce8e7ac39058
last_verified: null
---

# Spring Web MVC

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| HTTP <method> | SERVER | http.request.method, url.scheme, url.path, url.query, http.response.status_code, network.protocol.name, network.protocol.version, network.peer.address, network.peer.port, network.local.address, network.local.port, http.route, http.request.header.*, http.response.header.* | Header attributes only when configured for capture |
| <code.function> | INTERNAL | code.function, code.namespace, code.filepath, code.lineno | Controller span; gated by otel.instrumentation.experimental.controller-telemetry.enabled |
| <view name or view class> | INTERNAL | spring-webmvc.view.name, spring-webmvc.view.type | Model-and-view span; gated by otel.instrumentation.experimental.view-telemetry.enabled |

## Sources

- instrumentation/spring/spring-webmvc/spring-webmvc-6.0/library/src/main/java/io/opentelemetry/instrumentation/spring/webmvc/v6_0/SpringWebMvcTelemetryBuilder.java
- instrumentation/spring/spring-webmvc/spring-webmvc-6.0/library/src/main/java/io/opentelemetry/instrumentation/spring/webmvc/v6_0/SpringWebMvcHttpAttributesGetter.java
- instrumentation/spring/spring-webmvc/spring-webmvc-6.0/library/src/main/java/io/opentelemetry/instrumentation/spring/webmvc/v6_0/HttpRouteSupport.java
- instrumentation/spring/spring-webmvc/spring-webmvc-6.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webmvc/v6_0/HandlerAdapterInstrumentation.java
- instrumentation/spring/spring-webmvc/spring-webmvc-6.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webmvc/v6_0/DispatcherServletInstrumentation.java
- instrumentation/spring/spring-webmvc/spring-webmvc-common-3.1/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webmvc/common/v3_1/SpringWebMvcInstrumenterFactory.java
- instrumentation/spring/spring-webmvc/spring-webmvc-common-3.1/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webmvc/common/v3_1/ModelAndViewAttributesExtractor.java
          • v2.31.0.md 2.2 KB 
            ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/spring/spring-webmvc
version: v2.31.0
scope_name: io.opentelemetry.spring-webmvc-6.0
commit_sha: 18da99bef6a5f1becdeb8091136f12c43742b9b7
last_verified: null
---

# Spring Web MVC

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| HTTP <method> | SERVER | http.request.method, url.scheme, url.path, url.query, http.response.status_code, network.protocol.name, network.protocol.version, network.peer.address, network.peer.port, network.local.address, network.local.port, http.route, http.request.header.*, http.response.header.* | Header attributes only when configured for capture |
| <code.function> | INTERNAL | code.function, code.namespace, code.filepath, code.lineno | Controller span; gated by otel.instrumentation.experimental.controller-telemetry.enabled |
| <view name or view class> | INTERNAL | spring-webmvc.view.name, spring-webmvc.view.type | Model-and-view span; gated by otel.instrumentation.experimental.view-telemetry.enabled |

## Sources

- instrumentation/spring/spring-webmvc/spring-webmvc-6.0/library/src/main/java/io/opentelemetry/instrumentation/spring/webmvc/v6_0/SpringWebMvcTelemetryBuilder.java
- instrumentation/spring/spring-webmvc/spring-webmvc-6.0/library/src/main/java/io/opentelemetry/instrumentation/spring/webmvc/v6_0/SpringWebMvcHttpAttributesGetter.java
- instrumentation/spring/spring-webmvc/spring-webmvc-6.0/library/src/main/java/io/opentelemetry/instrumentation/spring/webmvc/v6_0/HttpRouteSupport.java
- instrumentation/spring/spring-webmvc/spring-webmvc-6.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webmvc/v6_0/HandlerAdapterInstrumentation.java
- instrumentation/spring/spring-webmvc/spring-webmvc-6.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webmvc/v6_0/DispatcherServletInstrumentation.java
- instrumentation/spring/spring-webmvc/spring-webmvc-common-3.1/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webmvc/common/v3_1/SpringWebMvcInstrumenterFactory.java
- instrumentation/spring/spring-webmvc/spring-webmvc-common-3.1/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webmvc/common/v3_1/ModelAndViewAttributesExtractor.java
          • v2.31.1.md 2.2 KB 
            ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/spring/spring-webmvc
version: v2.31.1
scope_name: io.opentelemetry.spring-webmvc-6.0
commit_sha: 8ad06a082e051f366f19c16ad95a7b68edf30afd
last_verified: null
---

# Spring Web MVC

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| HTTP <method> | SERVER | http.request.method, url.scheme, url.path, url.query, http.response.status_code, network.protocol.name, network.protocol.version, network.peer.address, network.peer.port, network.local.address, network.local.port, http.route, http.request.header.*, http.response.header.* | Header attributes only when configured for capture |
| <code.function> | INTERNAL | code.function, code.namespace, code.filepath, code.lineno | Controller span; gated by otel.instrumentation.experimental.controller-telemetry.enabled |
| <view name or view class> | INTERNAL | spring-webmvc.view.name, spring-webmvc.view.type | Model-and-view span; gated by otel.instrumentation.experimental.view-telemetry.enabled |

## Sources

- instrumentation/spring/spring-webmvc/spring-webmvc-6.0/library/src/main/java/io/opentelemetry/instrumentation/spring/webmvc/v6_0/SpringWebMvcTelemetryBuilder.java
- instrumentation/spring/spring-webmvc/spring-webmvc-6.0/library/src/main/java/io/opentelemetry/instrumentation/spring/webmvc/v6_0/SpringWebMvcHttpAttributesGetter.java
- instrumentation/spring/spring-webmvc/spring-webmvc-6.0/library/src/main/java/io/opentelemetry/instrumentation/spring/webmvc/v6_0/HttpRouteSupport.java
- instrumentation/spring/spring-webmvc/spring-webmvc-6.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webmvc/v6_0/HandlerAdapterInstrumentation.java
- instrumentation/spring/spring-webmvc/spring-webmvc-6.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webmvc/v6_0/DispatcherServletInstrumentation.java
- instrumentation/spring/spring-webmvc/spring-webmvc-common-3.1/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webmvc/common/v3_1/SpringWebMvcInstrumenterFactory.java
- instrumentation/spring/spring-webmvc/spring-webmvc-common-3.1/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webmvc/common/v3_1/ModelAndViewAttributesExtractor.java
          • v2.32.0.md 2.2 KB 
            ---
repo: open-telemetry/opentelemetry-java-instrumentation
path: instrumentation/spring/spring-webmvc
version: v2.32.0
scope_name: io.opentelemetry.spring-webmvc-6.0
commit_sha: 1b8644f8eb11d90295b1c313391aa84edeeec6e2
last_verified: null
---

# Spring Web MVC

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| HTTP <method> | SERVER | http.request.method, url.scheme, url.path, url.query, http.response.status_code, network.protocol.name, network.protocol.version, network.peer.address, network.peer.port, network.local.address, network.local.port, http.route, http.request.header.*, http.response.header.* | Header attributes only when configured for capture |
| <code.function> | INTERNAL | code.function, code.namespace, code.filepath, code.lineno | Controller span; gated by otel.instrumentation.experimental.controller-telemetry.enabled |
| <view name or view class> | INTERNAL | spring-webmvc.view.name, spring-webmvc.view.type | Model-and-view span; gated by otel.instrumentation.experimental.view-telemetry.enabled |

## Sources

- instrumentation/spring/spring-webmvc/spring-webmvc-6.0/library/src/main/java/io/opentelemetry/instrumentation/spring/webmvc/v6_0/SpringWebMvcTelemetryBuilder.java
- instrumentation/spring/spring-webmvc/spring-webmvc-6.0/library/src/main/java/io/opentelemetry/instrumentation/spring/webmvc/v6_0/SpringWebMvcHttpAttributesGetter.java
- instrumentation/spring/spring-webmvc/spring-webmvc-6.0/library/src/main/java/io/opentelemetry/instrumentation/spring/webmvc/v6_0/HttpRouteSupport.java
- instrumentation/spring/spring-webmvc/spring-webmvc-6.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webmvc/v6_0/HandlerAdapterInstrumentation.java
- instrumentation/spring/spring-webmvc/spring-webmvc-6.0/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webmvc/v6_0/DispatcherServletInstrumentation.java
- instrumentation/spring/spring-webmvc/spring-webmvc-common-3.1/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webmvc/common/v3_1/SpringWebMvcInstrumenterFactory.java
- instrumentation/spring/spring-webmvc/spring-webmvc-common-3.1/javaagent/src/main/java/io/opentelemetry/javaagent/instrumentation/spring/webmvc/common/v3_1/ModelAndViewAttributesExtractor.java
  • opentelemetry-js-contrib
    • packages
      • instrumentation-express
        • v0.64.0.md 1.7 KB 
          ---
repo: open-telemetry/opentelemetry-js-contrib
path: packages/instrumentation-express
version: v0.64.0
scope_name: '@opentelemetry/instrumentation-express'
commit_sha: 03ed3a3a4ab3f9fd481ba81dddb72b3f8e7dae30
last_verified: 2026-08-11
---

# Express instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `router - {route}` | INTERNAL | `http.route`; `express.name`; `express.type="router"` | Emitted only when an active span already exists; router spans end immediately. `spanNameHook` may replace the name. |
| `middleware - {name}` | INTERNAL | `http.route`; `express.name`; `express.type="middleware"` | Emitted only when an active span already exists and the layer is not excluded by `ignoreLayers` or `ignoreLayersType`. Errors passed to `next` or thrown by the layer are recorded as an exception event and set span status to ERROR. `requestHook` may add custom attributes; `spanNameHook` may replace the name. |
| `request handler - {route}` | INTERNAL | `http.route`; `express.name`; `express.type="request_handler"` | Emitted only when an active span already exists and the layer is not excluded by `ignoreLayers` or `ignoreLayersType`. Errors passed to `next` or thrown by the layer are recorded as an exception event and set span status to ERROR. `requestHook` may add custom attributes; `spanNameHook` may replace the name. |

## Sources

- `packages/instrumentation-express/src/instrumentation.ts`
- `packages/instrumentation-express/src/utils.ts`
- `packages/instrumentation-express/src/enums/AttributeNames.ts`
- `packages/instrumentation-express/src/enums/ExpressLayerType.ts`
- `packages/instrumentation-express/src/types.ts`
- `packages/instrumentation-express/README.md`
        • v0.65.0.md 1.7 KB 
          ---
repo: open-telemetry/opentelemetry-js-contrib
path: packages/instrumentation-express
version: v0.65.0
scope_name: '@opentelemetry/instrumentation-express'
commit_sha: b68fb6dcc0649631ebecab7bde81879486f74f0b
last_verified: 2026-08-11
---

# Express instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `router - {route}` | INTERNAL | `http.route`; `express.name`; `express.type="router"` | Emitted only when an active span already exists; router spans end immediately. `spanNameHook` may replace the name. |
| `middleware - {name}` | INTERNAL | `http.route`; `express.name`; `express.type="middleware"` | Emitted only when an active span already exists and the layer is not excluded by `ignoreLayers` or `ignoreLayersType`. Errors passed to `next` or thrown by the layer are recorded as an exception event and set span status to ERROR. `requestHook` may add custom attributes; `spanNameHook` may replace the name. |
| `request handler - {route}` | INTERNAL | `http.route`; `express.name`; `express.type="request_handler"` | Emitted only when an active span already exists and the layer is not excluded by `ignoreLayers` or `ignoreLayersType`. Errors passed to `next` or thrown by the layer are recorded as an exception event and set span status to ERROR. `requestHook` may add custom attributes; `spanNameHook` may replace the name. |

## Sources

- `packages/instrumentation-express/src/instrumentation.ts`
- `packages/instrumentation-express/src/utils.ts`
- `packages/instrumentation-express/src/enums/AttributeNames.ts`
- `packages/instrumentation-express/src/enums/ExpressLayerType.ts`
- `packages/instrumentation-express/src/types.ts`
- `packages/instrumentation-express/README.md`
        • v0.66.0.md 1.7 KB 
          ---
repo: open-telemetry/opentelemetry-js-contrib
path: packages/instrumentation-express
version: v0.66.0
scope_name: '@opentelemetry/instrumentation-express'
commit_sha: 15ef7506553f631ea4181391e0c5725a56f0d082
last_verified: 2026-08-11
---

# Express instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `router - {route}` | INTERNAL | `http.route`; `express.name`; `express.type="router"` | Emitted only when an active span already exists; router spans end immediately. `spanNameHook` may replace the name. |
| `middleware - {name}` | INTERNAL | `http.route`; `express.name`; `express.type="middleware"` | Emitted only when an active span already exists and the layer is not excluded by `ignoreLayers` or `ignoreLayersType`. Errors passed to `next` or thrown by the layer are recorded as an exception event and set span status to ERROR. `requestHook` may add custom attributes; `spanNameHook` may replace the name. |
| `request handler - {route}` | INTERNAL | `http.route`; `express.name`; `express.type="request_handler"` | Emitted only when an active span already exists and the layer is not excluded by `ignoreLayers` or `ignoreLayersType`. Errors passed to `next` or thrown by the layer are recorded as an exception event and set span status to ERROR. `requestHook` may add custom attributes; `spanNameHook` may replace the name. |

## Sources

- `packages/instrumentation-express/src/instrumentation.ts`
- `packages/instrumentation-express/src/utils.ts`
- `packages/instrumentation-express/src/enums/AttributeNames.ts`
- `packages/instrumentation-express/src/enums/ExpressLayerType.ts`
- `packages/instrumentation-express/src/types.ts`
- `packages/instrumentation-express/README.md`
        • v0.67.0.md 1.7 KB 
          ---
repo: open-telemetry/opentelemetry-js-contrib
path: packages/instrumentation-express
version: v0.67.0
scope_name: '@opentelemetry/instrumentation-express'
commit_sha: 4e52a9053029304f271b7dbe1b07e7fb2b987e30
last_verified: 2026-08-06
---

# Express instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `router - {route}` | INTERNAL | `http.route`; `express.name`; `express.type="router"` | Emitted only when an active span already exists; router spans end immediately. `spanNameHook` may replace the name. |
| `middleware - {name}` | INTERNAL | `http.route`; `express.name`; `express.type="middleware"` | Emitted only when an active span already exists and the layer is not excluded by `ignoreLayers` or `ignoreLayersType`. Errors passed to `next` or thrown by the layer are recorded as an exception event and set span status to ERROR. `requestHook` may add custom attributes; `spanNameHook` may replace the name. |
| `request handler - {route}` | INTERNAL | `http.route`; `express.name`; `express.type="request_handler"` | Emitted only when an active span already exists and the layer is not excluded by `ignoreLayers` or `ignoreLayersType`. Errors passed to `next` or thrown by the layer are recorded as an exception event and set span status to ERROR. `requestHook` may add custom attributes; `spanNameHook` may replace the name. |

## Sources

- `packages/instrumentation-express/src/instrumentation.ts`
- `packages/instrumentation-express/src/utils.ts`
- `packages/instrumentation-express/src/enums/AttributeNames.ts`
- `packages/instrumentation-express/src/enums/ExpressLayerType.ts`
- `packages/instrumentation-express/src/types.ts`
- `packages/instrumentation-express/README.md`
        • v0.68.0.md 1.7 KB 
          ---
repo: open-telemetry/opentelemetry-js-contrib
path: packages/instrumentation-express
version: v0.68.0
scope_name: '@opentelemetry/instrumentation-express'
commit_sha: 8d7daea5c404855f474a82f4296640af8b93b64c
last_verified: 2026-08-06
---

# Express instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `router - {route}` | INTERNAL | `http.route`; `express.name`; `express.type="router"` | Emitted only when an active span already exists; router spans end immediately. `spanNameHook` may replace the name. |
| `middleware - {name}` | INTERNAL | `http.route`; `express.name`; `express.type="middleware"` | Emitted only when an active span already exists and the layer is not excluded by `ignoreLayers` or `ignoreLayersType`. Errors passed to `next` or thrown by the layer are recorded as an exception event and set span status to ERROR. `requestHook` may add custom attributes; `spanNameHook` may replace the name. |
| `request handler - {route}` | INTERNAL | `http.route`; `express.name`; `express.type="request_handler"` | Emitted only when an active span already exists and the layer is not excluded by `ignoreLayers` or `ignoreLayersType`. Errors passed to `next` or thrown by the layer are recorded as an exception event and set span status to ERROR. `requestHook` may add custom attributes; `spanNameHook` may replace the name. |

## Sources

- `packages/instrumentation-express/src/instrumentation.ts`
- `packages/instrumentation-express/src/utils.ts`
- `packages/instrumentation-express/src/enums/AttributeNames.ts`
- `packages/instrumentation-express/src/enums/ExpressLayerType.ts`
- `packages/instrumentation-express/src/types.ts`
- `packages/instrumentation-express/README.md`
        • v0.69.0.md 1.7 KB 
          ---
repo: open-telemetry/opentelemetry-js-contrib
path: packages/instrumentation-express
version: v0.69.0
scope_name: '@opentelemetry/instrumentation-express'
commit_sha: 27e172a9e0d549559056ccd58f27d13467454156
last_verified: 2026-08-06
---

# Express instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `router - {route}` | INTERNAL | `http.route`; `express.name`; `express.type="router"` | Emitted only when an active span already exists; router spans end immediately. `spanNameHook` may replace the name. |
| `middleware - {name}` | INTERNAL | `http.route`; `express.name`; `express.type="middleware"` | Emitted only when an active span already exists and the layer is not excluded by `ignoreLayers` or `ignoreLayersType`. Errors passed to `next` or thrown by the layer are recorded as an exception event and set span status to ERROR. `requestHook` may add custom attributes; `spanNameHook` may replace the name. |
| `request handler - {route}` | INTERNAL | `http.route`; `express.name`; `express.type="request_handler"` | Emitted only when an active span already exists and the layer is not excluded by `ignoreLayers` or `ignoreLayersType`. Errors passed to `next` or thrown by the layer are recorded as an exception event and set span status to ERROR. `requestHook` may add custom attributes; `spanNameHook` may replace the name. |

## Sources

- `packages/instrumentation-express/src/instrumentation.ts`
- `packages/instrumentation-express/src/utils.ts`
- `packages/instrumentation-express/src/enums/AttributeNames.ts`
- `packages/instrumentation-express/src/enums/ExpressLayerType.ts`
- `packages/instrumentation-express/src/types.ts`
- `packages/instrumentation-express/README.md`
        • v0.70.0.md 1.7 KB 
          ---
repo: open-telemetry/opentelemetry-js-contrib
path: packages/instrumentation-express
version: v0.70.0
scope_name: '@opentelemetry/instrumentation-express'
commit_sha: 932fc967b142a8eb47d306fe92107b62962099f0
last_verified: 2026-09-03
---

# Express instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `router - {route}` | INTERNAL | `http.route`; `express.name`; `express.type="router"` | Emitted only when an active span already exists; router spans end immediately. `spanNameHook` may replace the name. |
| `middleware - {name}` | INTERNAL | `http.route`; `express.name`; `express.type="middleware"` | Emitted only when an active span already exists and the layer is not excluded by `ignoreLayers` or `ignoreLayersType`. Errors passed to `next` or thrown by the layer are recorded as an exception event and set span status to ERROR. `requestHook` may add custom attributes; `spanNameHook` may replace the name. |
| `request handler - {route}` | INTERNAL | `http.route`; `express.name`; `express.type="request_handler"` | Emitted only when an active span already exists and the layer is not excluded by `ignoreLayers` or `ignoreLayersType`. Errors passed to `next` or thrown by the layer are recorded as an exception event and set span status to ERROR. `requestHook` may add custom attributes; `spanNameHook` may replace the name. |

## Sources

- `packages/instrumentation-express/src/instrumentation.ts`
- `packages/instrumentation-express/src/utils.ts`
- `packages/instrumentation-express/src/enums/AttributeNames.ts`
- `packages/instrumentation-express/src/enums/ExpressLayerType.ts`
- `packages/instrumentation-express/src/types.ts`
- `packages/instrumentation-express/README.md`
        • v0.71.0.md 1.2 KB 
          ---
repo: open-telemetry/opentelemetry-js-contrib
path: packages/instrumentation-express
version: v0.71.0
scope_name: "@opentelemetry/instrumentation-express"
commit_sha: cc263ac4e94320402ac3afe50d50eb00905e1bb8
last_verified: 2026-10-14
---

# Express instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `router - <route>` (or rewritten by `spanNameHook`) | INTERNAL | `http.route`, `express.name`, `express.type` (`router`) | Requires an active span; router spans are ended immediately. Skippable with `ignoreLayers` or `ignoreLayersType`. |
| `request handler` / `request handler - <route>` (or rewritten by `spanNameHook`) | INTERNAL | `http.route`, `express.name`, `express.type` (`request_handler`) | Requires an active span; skippable with `ignoreLayers` or `ignoreLayersType`. |
| `middleware - <name>` (or rewritten by `spanNameHook`) | INTERNAL | `http.route`, `express.name`, `express.type` (`middleware`) | Requires an active span; skippable with `ignoreLayers` or `ignoreLayersType`. |

## Sources

- `packages/instrumentation-express/src/instrumentation.ts`
- `packages/instrumentation-express/src/utils.ts`
- `packages/instrumentation-express/src/enums/AttributeNames.ts`
      • instrumentation-ioredis
        • v0.64.0.md 2.2 KB 
          ---
repo: open-telemetry/opentelemetry-js-contrib
path: packages/instrumentation-ioredis
version: v0.64.0
scope_name: "@opentelemetry/instrumentation-ioredis"
commit_sha: 03ed3a3a4ab3f9fd481ba81dddb72b3f8e7dae30
last_verified: 2026-08-11
---

# instrumentation-ioredis

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `connect` | CLIENT | `db.system.name="redis"`, `db.query.text="connect"`; `server.address=<host>`, `server.port=<port>`; `db.system="redis"`, `db.statement="connect"`, `db.connection_string="redis://<host>:<port>"`; `net.peer.name=<host>`, `net.peer.port=<port>` | Emitted only when an active parent span exists unless `requireParentSpan: false`. Stable database attributes are enabled by the `database` mode of `OTEL_SEMCONV_STABILITY_OPT_IN`; legacy database attributes are emitted by default and with `database/dup`. Stable network attributes are enabled by the `http` mode; legacy network attributes are emitted by default and with `http/dup`. On failure, records an exception event and sets span status to ERROR. |
| `<redis command name>` | CLIENT | `db.system.name="redis"`, `db.query.text=<serialized command>`; `server.address=<host>`, `server.port=<port>`; `db.system="redis"`, `db.statement=<serialized command>`, `db.connection_string="redis://<host>:<port>"`; `net.peer.name=<host>`, `net.peer.port=<port>` | Emitted only when an active parent span exists unless `requireParentSpan: false`. The query value uses `dbStatementSerializer` when configured, otherwise the default serializer. Stable database attributes are enabled by the `database` mode of `OTEL_SEMCONV_STABILITY_OPT_IN`; legacy database attributes are emitted by default and with `database/dup`. Stable network attributes are enabled by the `http` mode; legacy network attributes are emitted by default and with `http/dup`. On failure, records an exception event and sets span status to ERROR; `requestHook` and `responseHook` may add custom attributes. |

## Sources

- `packages/instrumentation-ioredis/src/instrumentation.ts`
- `packages/instrumentation-ioredis/src/semconv.ts`
- `packages/instrumentation-ioredis/src/utils.ts`
- `packages/instrumentation-ioredis/src/types.ts`
- `packages/instrumentation-ioredis/package.json`
- `packages/instrumentation-ioredis/README.md`
        • v0.65.0.md 2.2 KB 
          ---
repo: open-telemetry/opentelemetry-js-contrib
path: packages/instrumentation-ioredis
version: v0.65.0
scope_name: "@opentelemetry/instrumentation-ioredis"
commit_sha: b68fb6dcc0649631ebecab7bde81879486f74f0b
last_verified: 2026-08-11
---

# instrumentation-ioredis

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `connect` | CLIENT | `db.system.name="redis"`, `db.query.text="connect"`; `server.address=<host>`, `server.port=<port>`; `db.system="redis"`, `db.statement="connect"`, `db.connection_string="redis://<host>:<port>"`; `net.peer.name=<host>`, `net.peer.port=<port>` | Emitted only when an active parent span exists unless `requireParentSpan: false`. Stable database attributes are enabled by the `database` mode of `OTEL_SEMCONV_STABILITY_OPT_IN`; legacy database attributes are emitted by default and with `database/dup`. Stable network attributes are enabled by the `http` mode; legacy network attributes are emitted by default and with `http/dup`. On failure, records an exception event and sets span status to ERROR. |
| `<redis command name>` | CLIENT | `db.system.name="redis"`, `db.query.text=<serialized command>`; `server.address=<host>`, `server.port=<port>`; `db.system="redis"`, `db.statement=<serialized command>`, `db.connection_string="redis://<host>:<port>"`; `net.peer.name=<host>`, `net.peer.port=<port>` | Emitted only when an active parent span exists unless `requireParentSpan: false`. The query value uses `dbStatementSerializer` when configured, otherwise the default serializer. Stable database attributes are enabled by the `database` mode of `OTEL_SEMCONV_STABILITY_OPT_IN`; legacy database attributes are emitted by default and with `database/dup`. Stable network attributes are enabled by the `http` mode; legacy network attributes are emitted by default and with `http/dup`. On failure, records an exception event and sets span status to ERROR; `requestHook` and `responseHook` may add custom attributes. |

## Sources

- `packages/instrumentation-ioredis/src/instrumentation.ts`
- `packages/instrumentation-ioredis/src/semconv.ts`
- `packages/instrumentation-ioredis/src/utils.ts`
- `packages/instrumentation-ioredis/src/types.ts`
- `packages/instrumentation-ioredis/package.json`
- `packages/instrumentation-ioredis/README.md`
        • v0.66.0.md 2.2 KB 
          ---
repo: open-telemetry/opentelemetry-js-contrib
path: packages/instrumentation-ioredis
version: v0.66.0
scope_name: "@opentelemetry/instrumentation-ioredis"
commit_sha: 15ef7506553f631ea4181391e0c5725a56f0d082
last_verified: 2026-08-11
---

# instrumentation-ioredis

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `connect` | CLIENT | `db.system.name="redis"`, `db.query.text="connect"`; `server.address=<host>`, `server.port=<port>`; `db.system="redis"`, `db.statement="connect"`, `db.connection_string="redis://<host>:<port>"`; `net.peer.name=<host>`, `net.peer.port=<port>` | Emitted only when an active parent span exists unless `requireParentSpan: false`. Stable database attributes are enabled by the `database` mode of `OTEL_SEMCONV_STABILITY_OPT_IN`; legacy database attributes are emitted by default and with `database/dup`. Stable network attributes are enabled by the `http` mode; legacy network attributes are emitted by default and with `http/dup`. On failure, records an exception event and sets span status to ERROR. |
| `<redis command name>` | CLIENT | `db.system.name="redis"`, `db.query.text=<serialized command>`; `server.address=<host>`, `server.port=<port>`; `db.system="redis"`, `db.statement=<serialized command>`, `db.connection_string="redis://<host>:<port>"`; `net.peer.name=<host>`, `net.peer.port=<port>` | Emitted only when an active parent span exists unless `requireParentSpan: false`. The query value uses `dbStatementSerializer` when configured, otherwise the default serializer. Stable database attributes are enabled by the `database` mode of `OTEL_SEMCONV_STABILITY_OPT_IN`; legacy database attributes are emitted by default and with `database/dup`. Stable network attributes are enabled by the `http` mode; legacy network attributes are emitted by default and with `http/dup`. On failure, records an exception event and sets span status to ERROR; `requestHook` and `responseHook` may add custom attributes. |

## Sources

- `packages/instrumentation-ioredis/src/instrumentation.ts`
- `packages/instrumentation-ioredis/src/semconv.ts`
- `packages/instrumentation-ioredis/src/utils.ts`
- `packages/instrumentation-ioredis/src/types.ts`
- `packages/instrumentation-ioredis/package.json`
- `packages/instrumentation-ioredis/README.md`
        • v0.67.0.md 2.1 KB 
          ---
repo: open-telemetry/opentelemetry-js-contrib
path: packages/instrumentation-ioredis
version: v0.67.0
scope_name: "@opentelemetry/instrumentation-ioredis"
commit_sha: 4e52a9053029304f271b7dbe1b07e7fb2b987e30
last_verified: 2026-08-06
---

# instrumentation-ioredis

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `connect` | CLIENT | `db.system.name="redis"`, `db.query.text="connect"`; `server.address=<host>`, `server.port=<port>`; `db.system="redis"`, `db.statement="connect"`, `db.connection_string="redis://<host>:<port>"`; `net.peer.name=<host>`, `net.peer.port=<port>` | Emitted only when an active parent span exists unless `requireParentSpan: false`. Stable database attributes are gated by the `database` mode of `OTEL_SEMCONV_STABILITY_OPT_IN`; legacy database attributes by its `database/old` mode, and stable network attributes by its `http` mode (legacy network attributes by `http/old`). On failure, records an exception event and sets span status to ERROR. |
| `<redis command name>` | CLIENT | `db.system.name="redis"`, `db.query.text=<serialized command>`; `server.address=<host>`, `server.port=<port>`; `db.system="redis"`, `db.statement=<serialized command>`, `db.connection_string="redis://<host>:<port>"`; `net.peer.name=<host>`, `net.peer.port=<port>` | Emitted only when an active parent span exists unless `requireParentSpan: false`. The query value uses `dbStatementSerializer` when configured, otherwise the default serializer. Stable database attributes are gated by the `database` mode of `OTEL_SEMCONV_STABILITY_OPT_IN`; legacy database attributes by its `database/old` mode, and stable network attributes by its `http` mode (legacy network attributes by `http/old`). On failure, records an exception event and sets span status to ERROR; `requestHook` and `responseHook` may add custom attributes. |

## Sources

- `packages/instrumentation-ioredis/src/instrumentation.ts`
- `packages/instrumentation-ioredis/src/semconv.ts`
- `packages/instrumentation-ioredis/src/utils.ts`
- `packages/instrumentation-ioredis/src/types.ts`
- `packages/instrumentation-ioredis/package.json`
        • v0.68.0.md 2.1 KB 
          ---
repo: open-telemetry/opentelemetry-js-contrib
path: packages/instrumentation-ioredis
version: v0.68.0
scope_name: "@opentelemetry/instrumentation-ioredis"
commit_sha: 8d7daea5c404855f474a82f4296640af8b93b64c
last_verified: 2026-08-06
---

# instrumentation-ioredis

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `connect` | CLIENT | `db.system.name="redis"`, `db.query.text="connect"`; `server.address=<host>`, `server.port=<port>`; `db.system="redis"`, `db.statement="connect"`, `db.connection_string="redis://<host>:<port>"`; `net.peer.name=<host>`, `net.peer.port=<port>` | Emitted only when an active parent span exists unless `requireParentSpan: false`. Stable database attributes are gated by the `database` mode of `OTEL_SEMCONV_STABILITY_OPT_IN`; legacy database attributes by its `database/old` mode, and stable network attributes by its `http` mode (legacy network attributes by `http/old`). On failure, records an exception event and sets span status to ERROR. |
| `<redis command name>` | CLIENT | `db.system.name="redis"`, `db.query.text=<serialized command>`; `server.address=<host>`, `server.port=<port>`; `db.system="redis"`, `db.statement=<serialized command>`, `db.connection_string="redis://<host>:<port>"`; `net.peer.name=<host>`, `net.peer.port=<port>` | Emitted only when an active parent span exists unless `requireParentSpan: false`. The query value uses `dbStatementSerializer` when configured, otherwise the default serializer. Stable database attributes are gated by the `database` mode of `OTEL_SEMCONV_STABILITY_OPT_IN`; legacy database attributes by its `database/old` mode, and stable network attributes by its `http` mode (legacy network attributes by `http/old`). On failure, records an exception event and sets span status to ERROR; `requestHook` and `responseHook` may add custom attributes. |

## Sources

- `packages/instrumentation-ioredis/src/instrumentation.ts`
- `packages/instrumentation-ioredis/src/semconv.ts`
- `packages/instrumentation-ioredis/src/utils.ts`
- `packages/instrumentation-ioredis/src/types.ts`
- `packages/instrumentation-ioredis/package.json`
        • v0.69.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-js-contrib
path: packages/instrumentation-ioredis
version: v0.69.0
scope_name: "@opentelemetry/instrumentation-ioredis"
commit_sha: 27e172a9e0d549559056ccd58f27d13467454156
last_verified: 2026-08-06
---

# instrumentation-ioredis

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `connect` | CLIENT | `db.system.name="redis"`, `db.query.text="connect"`, `server.address=<host>`, `server.port=<port>` | Emitted only when an active parent span exists unless `requireParentSpan: false`. On failure, records an exception event and sets span status to ERROR. |
| `<redis command name>` | CLIENT | `db.operation.name=<command operation>`; `db.system.name="redis"`, `db.query.text=<serialized command>`, `server.address=<host>`, `server.port=<port>` | Emitted only when an active parent span exists unless `requireParentSpan: false`. Span name is the command name. The query value uses `dbStatementSerializer` when configured, otherwise the default serializer. `db.operation.name` is the command name, or `MULTI <command>` / `PIPELINE <command>` for queued transaction/pipeline commands (except `multi` and `exec`; support depends on ioredis version). On failure, records an exception event and sets span status to ERROR; `requestHook` and `responseHook` may add custom attributes. |

## Sources

- `packages/instrumentation-ioredis/src/instrumentation.ts`
- `packages/instrumentation-ioredis/src/semconv.ts`
- `packages/instrumentation-ioredis/src/utils.ts`
- `packages/instrumentation-ioredis/src/types.ts`
- `packages/instrumentation-ioredis/package.json`
        • v0.70.0.md 1.6 KB 
          ---
repo: open-telemetry/opentelemetry-js-contrib
path: packages/instrumentation-ioredis
version: v0.70.0
scope_name: "@opentelemetry/instrumentation-ioredis"
commit_sha: 932fc967b142a8eb47d306fe92107b62962099f0
last_verified: 2026-09-03
---

# instrumentation-ioredis

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `connect` | CLIENT | `db.system.name="redis"`, `db.query.text="connect"`, `server.address=<host>`, `server.port=<port>` | Emitted only when an active parent span exists unless `requireParentSpan: false`. On failure, records an exception event and sets span status to ERROR. |
| `<redis command name>` | CLIENT | `db.operation.name=<command operation>`; `db.system.name="redis"`, `db.query.text=<serialized command>`, `server.address=<host>`, `server.port=<port>` | Emitted only when an active parent span exists unless `requireParentSpan: false`. Span name is the command name. The query value uses `dbStatementSerializer` when configured, otherwise the default serializer. `db.operation.name` is the command name, or `MULTI <command>` / `PIPELINE <command>` for queued transaction/pipeline commands (except `multi` and `exec`; support depends on ioredis version). On failure, records an exception event and sets span status to ERROR; `requestHook` and `responseHook` may add custom attributes. |

## Sources

- `packages/instrumentation-ioredis/src/instrumentation.ts`
- `packages/instrumentation-ioredis/src/semconv.ts`
- `packages/instrumentation-ioredis/src/utils.ts`
- `packages/instrumentation-ioredis/src/types.ts`
- `packages/instrumentation-ioredis/package.json`
        • v0.71.0.md 1 KB 
          ---
repo: open-telemetry/opentelemetry-js-contrib
path: packages/instrumentation-ioredis
version: v0.71.0
scope_name: '@opentelemetry/instrumentation-ioredis'
commit_sha: cc263ac4e94320402ac3afe50d50eb00905e1bb8
last_verified: null
---

# ioredis instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| Redis command name (`cmd.name`) | CLIENT | `db.operation.name`, `db.system.name` (`redis`), `db.query.text`, `server.address`, `server.port` | `db.operation.name` is prefixed `MULTI ` or `PIPELINE ` for queued commands where applicable; emitted only when `requireParentSpan` is false or a parent span is active (default requires parent). |
| `connect` | CLIENT | `db.system.name` (`redis`), `db.query.text` (`connect`), `server.address`, `server.port` | Emitted only when `requireParentSpan` is false or a parent span is active (default requires parent). |

## Sources

- `packages/instrumentation-ioredis/src/instrumentation.ts`
- `packages/instrumentation-ioredis/src/utils.ts`
- `packages/instrumentation-ioredis/package.json`
      • instrumentation-mongodb
        • v0.69.0.md 2 KB 
          ---
repo: open-telemetry/opentelemetry-js-contrib
path: packages/instrumentation-mongodb
version: v0.69.0
scope_name: '@opentelemetry/instrumentation-mongodb'
commit_sha: 03ed3a3a4ab3f9fd481ba81dddb72b3f8e7dae30
last_verified: 2026-08-11
---

# MongoDB instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `mongodb.{operation}` | CLIENT | `db.system="mongodb"`; `db.name`; `db.mongodb.collection`; `db.operation`; `db.connection_string`; `net.peer.name`; `net.peer.port`; `db.statement` | Default when `OTEL_SEMCONV_STABILITY_OPT_IN` does not select database/network stable conventions. Created for MongoDB v3 `insert`, `remove`, `update`, `command`, `query`, and `getMore`, and MongoDB v4–7 commands (excluding `ismaster`/`hello`). Requires an active parent span by default (`requireParentSpan=true`). `db.statement` is redacted unless `enhancedDatabaseReporting=true`; `dbStatementSerializer` can replace serialization. `responseHook` can add custom attributes. |
| `{operation} {collection}` (or `mongodb`) | CLIENT | `db.system.name="mongodb"`; `db.namespace`; `db.operation.name`; `db.collection.name`; `server.address`; `server.port`; `db.query.text` | Emitted when `OTEL_SEMCONV_STABILITY_OPT_IN` includes `database` and/or `http` (stable tokens). With `database/dup` and/or `http/dup`, the corresponding old and stable attributes are emitted together. Stable database/network attributes are gated by those environment tokens. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `db.client.connections.usage` | UpDownCounter | `{connection}` | `pool.name`; `state` (`idle`, `used`) | Emitted for MongoDB v4–7 server-session acquisition/release and `endSessions` connection-pool state changes. This experimental metric is not controlled by `OTEL_SEMCONV_STABILITY_OPT_IN`. |

## Sources

- `packages/instrumentation-mongodb/src/instrumentation.ts`
- `packages/instrumentation-mongodb/src/semconv.ts`
- `packages/instrumentation-mongodb/src/types.ts`
- `packages/instrumentation-mongodb/README.md`
        • v0.70.0.md 2 KB 
          ---
repo: open-telemetry/opentelemetry-js-contrib
path: packages/instrumentation-mongodb
version: v0.70.0
scope_name: '@opentelemetry/instrumentation-mongodb'
commit_sha: b68fb6dcc0649631ebecab7bde81879486f74f0b
last_verified: 2026-08-11
---

# MongoDB instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `mongodb.{operation}` | CLIENT | `db.system="mongodb"`; `db.name`; `db.mongodb.collection`; `db.operation`; `db.connection_string`; `net.peer.name`; `net.peer.port`; `db.statement` | Default when `OTEL_SEMCONV_STABILITY_OPT_IN` does not select database/network stable conventions. Created for MongoDB v3 `insert`, `remove`, `update`, `command`, `query`, and `getMore`, and MongoDB v4–7 commands (excluding `ismaster`/`hello`). Requires an active parent span by default (`requireParentSpan=true`). `db.statement` is redacted unless `enhancedDatabaseReporting=true`; `dbStatementSerializer` can replace serialization. `responseHook` can add custom attributes. |
| `{operation} {collection}` (or `mongodb`) | CLIENT | `db.system.name="mongodb"`; `db.namespace`; `db.operation.name`; `db.collection.name`; `server.address`; `server.port`; `db.query.text` | Emitted when `OTEL_SEMCONV_STABILITY_OPT_IN` includes `database` and/or `http` (stable tokens). With `database/dup` and/or `http/dup`, the corresponding old and stable attributes are emitted together. Stable database/network attributes are gated by those environment tokens. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `db.client.connections.usage` | UpDownCounter | `{connection}` | `pool.name`; `state` (`idle`, `used`) | Emitted for MongoDB v4–7 server-session acquisition/release and `endSessions` connection-pool state changes. This experimental metric is not controlled by `OTEL_SEMCONV_STABILITY_OPT_IN`. |

## Sources

- `packages/instrumentation-mongodb/src/instrumentation.ts`
- `packages/instrumentation-mongodb/src/semconv.ts`
- `packages/instrumentation-mongodb/src/types.ts`
- `packages/instrumentation-mongodb/README.md`
        • v0.71.0.md 2 KB 
          ---
repo: open-telemetry/opentelemetry-js-contrib
path: packages/instrumentation-mongodb
version: v0.71.0
scope_name: '@opentelemetry/instrumentation-mongodb'
commit_sha: 15ef7506553f631ea4181391e0c5725a56f0d082
last_verified: 2026-08-11
---

# MongoDB instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `mongodb.{operation}` | CLIENT | `db.system="mongodb"`; `db.name`; `db.mongodb.collection`; `db.operation`; `db.connection_string`; `net.peer.name`; `net.peer.port`; `db.statement` | Default when `OTEL_SEMCONV_STABILITY_OPT_IN` does not select database/network stable conventions. Created for MongoDB v3 `insert`, `remove`, `update`, `command`, `query`, and `getMore`, and MongoDB v4–7 commands (excluding `ismaster`/`hello`). Requires an active parent span by default (`requireParentSpan=true`). `db.statement` is redacted unless `enhancedDatabaseReporting=true`; `dbStatementSerializer` can replace serialization. `responseHook` can add custom attributes. |
| `{operation} {collection}` (or `mongodb`) | CLIENT | `db.system.name="mongodb"`; `db.namespace`; `db.operation.name`; `db.collection.name`; `server.address`; `server.port`; `db.query.text` | Emitted when `OTEL_SEMCONV_STABILITY_OPT_IN` includes `database` and/or `http` (stable tokens). With `database/dup` and/or `http/dup`, the corresponding old and stable attributes are emitted together. Stable database/network attributes are gated by those environment tokens. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `db.client.connections.usage` | UpDownCounter | `{connection}` | `pool.name`; `state` (`idle`, `used`) | Emitted for MongoDB v4–7 server-session acquisition/release and `endSessions` connection-pool state changes. This experimental metric is not controlled by `OTEL_SEMCONV_STABILITY_OPT_IN`. |

## Sources

- `packages/instrumentation-mongodb/src/instrumentation.ts`
- `packages/instrumentation-mongodb/src/semconv.ts`
- `packages/instrumentation-mongodb/src/types.ts`
- `packages/instrumentation-mongodb/README.md`
        • v0.72.0.md 2 KB 
          ---
repo: open-telemetry/opentelemetry-js-contrib
path: packages/instrumentation-mongodb
version: v0.72.0
scope_name: '@opentelemetry/instrumentation-mongodb'
commit_sha: 4e52a9053029304f271b7dbe1b07e7fb2b987e30
last_verified: 2026-08-06
---

# MongoDB instrumentation

## Traces

| Span name | Kind | Attributes | Notes |
|---|---|---|---|
| `mongodb.{operation}` | CLIENT | `db.system="mongodb"`; `db.name`; `db.mongodb.collection`; `db.operation`; `db.connection_string`; `net.peer.name`; `net.peer.port`; `db.statement` | Default when `OTEL_SEMCONV_STABILITY_OPT_IN` does not select database/network stable conventions. Created for MongoDB v3 `insert`, `remove`, `update`, `command`, `query`, and `getMore`, and MongoDB v4–7 commands (excluding `ismaster`/`hello`). Requires an active parent span by default (`requireParentSpan=true`). `db.statement` is redacted unless `enhancedDatabaseReporting=true`; `dbStatementSerializer` can replace serialization. `responseHook` can add custom attributes. |
| `{operation} {collection}` (or `mongodb`) | CLIENT | `db.system.name="mongodb"`; `db.namespace`; `db.operation.name`; `db.collection.name`; `server.address`; `server.port`; `db.query.text` | Emitted when `OTEL_SEMCONV_STABILITY_OPT_IN` includes `database` and/or `http` (stable tokens). With `database/dup` and/or `http/dup`, the corresponding old and stable attributes are emitted together. Stable database/network attributes are gated by those environment tokens. |

## Metrics

| Metric name | Type | Unit | Attributes | Notes |
|---|---|---|---|---|
| `db.client.connections.usage` | UpDownCounter | `{connection}` | `pool.name`; `state` (`idle`, `used`) | Emitted for MongoDB v4–7 server-session acquisition/release and `endSessions` connection-pool state changes. This experimental metric is not controlled by `OTEL_SEMCONV_STABILITY_OPT_IN`. |

## Sources

- `packages/instrumentation-mongodb/src/instrumentation.ts`
- `packages/instrumentation-mongodb/src/semconv.ts`
- `packages/instrumentation-mongodb/src/types.ts`
- `packages/instrumentation-mongodb/README.md`
  • index.md 57.1 KB 
    # Telemetry emissions index

| File | Version | Last verified |
|---|---|---|
| opentelemetry-collector/exporter/debugexporter/v0.153.0.md | v0.153.0 | 2026-08-11 |
| opentelemetry-collector/exporter/debugexporter/v0.154.0.md | v0.154.0 | 2026-08-11 |
| opentelemetry-collector/exporter/debugexporter/v0.155.0.md | v0.155.0 | 2026-08-11 |
| opentelemetry-collector/exporter/debugexporter/v0.156.0.md | v0.156.0 | 2026-08-11 |
| opentelemetry-collector/exporter/debugexporter/v0.157.0.md | v0.157.0 | 2026-08-11 |
| opentelemetry-collector/exporter/debugexporter/v0.158.0.md | v0.158.0 | 2026-08-11 |
| opentelemetry-collector/exporter/debugexporter/v0.159.0.md | v0.159.0 | 2026-08-24 |
| opentelemetry-collector/exporter/debugexporter/v0.160.0.md | v0.160.0 | 2026-09-03 |
| opentelemetry-collector/exporter/debugexporter/v0.161.0.md | v0.161.0 | 2026-10-03 |
| opentelemetry-collector/exporter/debugexporter/v0.162.0.md | v0.162.0 | 2026-10-03 |
| opentelemetry-collector/exporter/debugexporter/v0.163.0.md | v0.163.0 | null |
| opentelemetry-collector/exporter/otlpexporter/v0.153.0.md | v0.153.0 | 2026-10-14 |
| opentelemetry-collector/exporter/otlpexporter/v0.154.0.md | v0.154.0 | 2026-10-14 |
| opentelemetry-collector/exporter/otlpexporter/v0.155.0.md | v0.155.0 | 2026-10-14 |
| opentelemetry-collector/exporter/otlpexporter/v0.156.0.md | v0.156.0 | 2026-10-14 |
| opentelemetry-collector/exporter/otlpexporter/v0.157.0.md | v0.157.0 | 2026-10-14 |
| opentelemetry-collector/exporter/otlpexporter/v0.158.0.md | v0.158.0 | 2026-10-14 |
| opentelemetry-collector/exporter/otlpexporter/v0.159.0.md | v0.159.0 | 2026-10-14 |
| opentelemetry-collector/exporter/otlpexporter/v0.160.0.md | v0.160.0 | 2026-10-14 |
| opentelemetry-collector/exporter/otlpexporter/v0.161.0.md | v0.161.0 | 2026-10-14 |
| opentelemetry-collector/exporter/otlpexporter/v0.162.0.md | v0.162.0 | 2026-10-14 |
| opentelemetry-collector/exporter/otlpexporter/v0.163.0.md | v0.163.0 | 2026-10-14 |
| opentelemetry-collector/exporter/otlphttpexporter/v0.153.0.md | v0.153.0 | 2026-08-11 |
| opentelemetry-collector/exporter/otlphttpexporter/v0.154.0.md | v0.154.0 | 2026-08-11 |
| opentelemetry-collector/exporter/otlphttpexporter/v0.155.0.md | v0.155.0 | 2026-08-11 |
| opentelemetry-collector/exporter/otlphttpexporter/v0.156.0.md | v0.156.0 | 2026-08-11 |
| opentelemetry-collector/exporter/otlphttpexporter/v0.157.0.md | v0.157.0 | 2026-08-11 |
| opentelemetry-collector/exporter/otlphttpexporter/v0.158.0.md | v0.158.0 | 2026-08-11 |
| opentelemetry-collector/exporter/otlphttpexporter/v0.159.0.md | v0.159.0 | 2026-08-24 |
| opentelemetry-collector/exporter/otlphttpexporter/v0.160.0.md | v0.160.0 | 2026-09-03 |
| opentelemetry-collector/exporter/otlphttpexporter/v0.161.0.md | v0.161.0 | 2026-10-03 |
| opentelemetry-collector/exporter/otlphttpexporter/v0.162.0.md | v0.162.0 | 2026-10-03 |
| opentelemetry-collector/exporter/otlphttpexporter/v0.163.0.md | v0.163.0 | 2026-10-14 |
| opentelemetry-collector/processor/batchprocessor/v0.153.0.md | v0.153.0 | 2026-08-11 |
| opentelemetry-collector/processor/batchprocessor/v0.154.0.md | v0.154.0 | 2026-08-11 |
| opentelemetry-collector/processor/batchprocessor/v0.155.0.md | v0.155.0 | 2026-08-11 |
| opentelemetry-collector/processor/batchprocessor/v0.156.0.md | v0.156.0 | 2026-08-11 |
| opentelemetry-collector/processor/batchprocessor/v0.157.0.md | v0.157.0 | 2026-08-11 |
| opentelemetry-collector/processor/batchprocessor/v0.158.0.md | v0.158.0 | 2026-08-11 |
| opentelemetry-collector/processor/batchprocessor/v0.159.0.md | v0.159.0 | 2026-08-24 |
| opentelemetry-collector/processor/batchprocessor/v0.160.0.md | v0.160.0 | 2026-09-03 |
| opentelemetry-collector/processor/batchprocessor/v0.161.0.md | v0.161.0 | 2026-10-03 |
| opentelemetry-collector/processor/batchprocessor/v0.162.0.md | v0.162.0 | 2026-10-03 |
| opentelemetry-collector/processor/batchprocessor/v0.163.0.md | v0.163.0 | 2026-10-14 |
| opentelemetry-collector/processor/memorylimiterprocessor/v0.153.0.md | v0.153.0 | 2026-08-06 |
| opentelemetry-collector/processor/memorylimiterprocessor/v0.154.0.md | v0.154.0 | 2026-08-06 |
| opentelemetry-collector/processor/memorylimiterprocessor/v0.155.0.md | v0.155.0 | 2026-08-06 |
| opentelemetry-collector/processor/memorylimiterprocessor/v0.156.0.md | v0.156.0 | 2026-08-06 |
| opentelemetry-collector/processor/memorylimiterprocessor/v0.157.0.md | v0.157.0 | 2026-08-06 |
| opentelemetry-collector/processor/memorylimiterprocessor/v0.158.0.md | v0.158.0 | 2026-08-06 |
| opentelemetry-collector/processor/memorylimiterprocessor/v0.159.0.md | v0.159.0 | 2026-08-24 |
| opentelemetry-collector/processor/memorylimiterprocessor/v0.160.0.md | v0.160.0 | 2026-09-03 |
| opentelemetry-collector/processor/memorylimiterprocessor/v0.161.0.md | v0.161.0 | 2026-10-03 |
| opentelemetry-collector/processor/memorylimiterprocessor/v0.162.0.md | v0.162.0 | 2026-10-03 |
| opentelemetry-collector/processor/memorylimiterprocessor/v0.163.0.md | v0.163.0 | null |
| opentelemetry-collector/receiver/otlpreceiver/v0.153.0.md | v0.153.0 | 2026-10-14 |
| opentelemetry-collector/receiver/otlpreceiver/v0.154.0.md | v0.154.0 | 2026-10-14 |
| opentelemetry-collector/receiver/otlpreceiver/v0.155.0.md | v0.155.0 | 2026-10-14 |
| opentelemetry-collector/receiver/otlpreceiver/v0.156.0.md | v0.156.0 | 2026-10-14 |
| opentelemetry-collector/receiver/otlpreceiver/v0.157.0.md | v0.157.0 | 2026-10-14 |
| opentelemetry-collector/receiver/otlpreceiver/v0.158.0.md | v0.158.0 | 2026-10-14 |
| opentelemetry-collector/receiver/otlpreceiver/v0.159.0.md | v0.159.0 | 2026-10-14 |
| opentelemetry-collector/receiver/otlpreceiver/v0.160.0.md | v0.160.0 | 2026-10-14 |
| opentelemetry-collector/receiver/otlpreceiver/v0.161.0.md | v0.161.0 | 2026-10-14 |
| opentelemetry-collector/receiver/otlpreceiver/v0.162.0.md | v0.162.0 | 2026-10-14 |
| opentelemetry-collector/receiver/otlpreceiver/v0.163.0.md | v0.163.0 | 2026-10-14 |
| opentelemetry-collector-contrib/connector/servicegraphconnector/v0.153.0.md | v0.153.0 | 2026-10-14 |
| opentelemetry-collector-contrib/connector/servicegraphconnector/v0.154.0.md | v0.154.0 | 2026-10-14 |
| opentelemetry-collector-contrib/connector/servicegraphconnector/v0.155.0.md | v0.155.0 | 2026-10-14 |
| opentelemetry-collector-contrib/connector/servicegraphconnector/v0.156.0.md | v0.156.0 | 2026-10-14 |
| opentelemetry-collector-contrib/connector/servicegraphconnector/v0.157.0.md | v0.157.0 | 2026-10-14 |
| opentelemetry-collector-contrib/connector/servicegraphconnector/v0.158.0.md | v0.158.0 | 2026-10-14 |
| opentelemetry-collector-contrib/connector/servicegraphconnector/v0.159.0.md | v0.159.0 | 2026-10-14 |
| opentelemetry-collector-contrib/connector/servicegraphconnector/v0.160.0.md | v0.160.0 | 2026-10-14 |
| opentelemetry-collector-contrib/connector/servicegraphconnector/v0.161.0.md | v0.161.0 | 2026-10-14 |
| opentelemetry-collector-contrib/connector/servicegraphconnector/v0.162.0.md | v0.162.0 | 2026-10-14 |
| opentelemetry-collector-contrib/connector/servicegraphconnector/v0.163.0.md | v0.163.0 | 2026-10-14 |
| opentelemetry-collector-contrib/connector/spanmetricsconnector/v0.153.0.md | v0.153.0 | 2026-10-14 |
| opentelemetry-collector-contrib/connector/spanmetricsconnector/v0.154.0.md | v0.154.0 | 2026-10-14 |
| opentelemetry-collector-contrib/connector/spanmetricsconnector/v0.155.0.md | v0.155.0 | 2026-10-14 |
| opentelemetry-collector-contrib/connector/spanmetricsconnector/v0.156.0.md | v0.156.0 | 2026-10-14 |
| opentelemetry-collector-contrib/connector/spanmetricsconnector/v0.157.0.md | v0.157.0 | 2026-10-14 |
| opentelemetry-collector-contrib/connector/spanmetricsconnector/v0.158.0.md | v0.158.0 | 2026-10-14 |
| opentelemetry-collector-contrib/connector/spanmetricsconnector/v0.159.0.md | v0.159.0 | 2026-10-14 |
| opentelemetry-collector-contrib/connector/spanmetricsconnector/v0.160.0.md | v0.160.0 | 2026-10-14 |
| opentelemetry-collector-contrib/connector/spanmetricsconnector/v0.161.0.md | v0.161.0 | 2026-10-14 |
| opentelemetry-collector-contrib/connector/spanmetricsconnector/v0.162.0.md | v0.162.0 | 2026-10-14 |
| opentelemetry-collector-contrib/connector/spanmetricsconnector/v0.163.0.md | v0.163.0 | 2026-10-14 |
| opentelemetry-collector-contrib/exporter/prometheusremotewriteexporter/v0.154.0.md | v0.154.0 | 2026-09-02 |
| opentelemetry-collector-contrib/exporter/prometheusremotewriteexporter/v0.155.0.md | v0.155.0 | 2026-09-02 |
| opentelemetry-collector-contrib/exporter/prometheusremotewriteexporter/v0.156.0.md | v0.156.0 | 2026-09-02 |
| opentelemetry-collector-contrib/exporter/prometheusremotewriteexporter/v0.157.0.md | v0.157.0 | 2026-09-02 |
| opentelemetry-collector-contrib/exporter/prometheusremotewriteexporter/v0.158.0.md | v0.158.0 | 2026-09-02 |
| opentelemetry-collector-contrib/exporter/prometheusremotewriteexporter/v0.159.0.md | v0.159.0 | 2026-09-02 |
| opentelemetry-collector-contrib/exporter/prometheusremotewriteexporter/v0.160.0.md | v0.160.0 | 2026-09-05 |
| opentelemetry-collector-contrib/exporter/prometheusremotewriteexporter/v0.161.0.md | v0.161.0 | 2026-10-03 |
| opentelemetry-collector-contrib/exporter/prometheusremotewriteexporter/v0.162.0.md | v0.162.0 | 2026-10-03 |
| opentelemetry-collector-contrib/exporter/prometheusremotewriteexporter/v0.163.0.md | v0.163.0 | null |
| opentelemetry-collector-contrib/processor/filterprocessor/v0.153.0.md | v0.153.0 | 2026-08-11 |
| opentelemetry-collector-contrib/processor/filterprocessor/v0.154.0.md | v0.154.0 | 2026-08-11 |
| opentelemetry-collector-contrib/processor/filterprocessor/v0.155.0.md | v0.155.0 | 2026-08-11 |
| opentelemetry-collector-contrib/processor/filterprocessor/v0.156.0.md | v0.156.0 | 2026-08-11 |
| opentelemetry-collector-contrib/processor/filterprocessor/v0.157.0.md | v0.157.0 | 2026-08-11 |
| opentelemetry-collector-contrib/processor/filterprocessor/v0.158.0.md | v0.158.0 | 2026-08-11 |
| opentelemetry-collector-contrib/processor/filterprocessor/v0.159.0.md | v0.159.0 | null |
| opentelemetry-collector-contrib/processor/filterprocessor/v0.160.0.md | v0.160.0 | 2026-09-03 |
| opentelemetry-collector-contrib/processor/filterprocessor/v0.161.0.md | v0.161.0 | 2026-10-03 |
| opentelemetry-collector-contrib/processor/filterprocessor/v0.162.0.md | v0.162.0 | 2026-10-03 |
| opentelemetry-collector-contrib/processor/filterprocessor/v0.163.0.md | v0.163.0 | null |
| opentelemetry-collector-contrib/processor/k8sattributesprocessor/v0.153.0.md | v0.153.0 | 2026-08-11 |
| opentelemetry-collector-contrib/processor/k8sattributesprocessor/v0.154.0.md | v0.154.0 | 2026-08-11 |
| opentelemetry-collector-contrib/processor/k8sattributesprocessor/v0.155.0.md | v0.155.0 | 2026-08-11 |
| opentelemetry-collector-contrib/processor/k8sattributesprocessor/v0.156.0.md | v0.156.0 | 2026-08-11 |
| opentelemetry-collector-contrib/processor/k8sattributesprocessor/v0.157.0.md | v0.157.0 | 2026-08-11 |
| opentelemetry-collector-contrib/processor/k8sattributesprocessor/v0.158.0.md | v0.158.0 | 2026-08-11 |
| opentelemetry-collector-contrib/processor/k8sattributesprocessor/v0.159.0.md | v0.159.0 | 2026-10-03 |
| opentelemetry-collector-contrib/processor/k8sattributesprocessor/v0.160.0.md | v0.160.0 | 2026-09-03 |
| opentelemetry-collector-contrib/processor/k8sattributesprocessor/v0.161.0.md | v0.161.0 | 2026-10-03 |
| opentelemetry-collector-contrib/processor/k8sattributesprocessor/v0.162.0.md | v0.162.0 | 2026-10-03 |
| opentelemetry-collector-contrib/processor/k8sattributesprocessor/v0.163.0.md | v0.163.0 | null |
| opentelemetry-collector-contrib/processor/resourcedetectionprocessor/v0.153.0.md | v0.153.0 | 2026-08-11 |
| opentelemetry-collector-contrib/processor/resourcedetectionprocessor/v0.154.0.md | v0.154.0 | 2026-08-11 |
| opentelemetry-collector-contrib/processor/resourcedetectionprocessor/v0.155.0.md | v0.155.0 | 2026-08-11 |
| opentelemetry-collector-contrib/processor/resourcedetectionprocessor/v0.156.0.md | v0.156.0 | 2026-08-11 |
| opentelemetry-collector-contrib/processor/resourcedetectionprocessor/v0.157.0.md | v0.157.0 | 2026-08-11 |
| opentelemetry-collector-contrib/processor/resourcedetectionprocessor/v0.158.0.md | v0.158.0 | 2026-08-11 |
| opentelemetry-collector-contrib/processor/resourcedetectionprocessor/v0.159.0.md | v0.159.0 | null |
| opentelemetry-collector-contrib/processor/resourcedetectionprocessor/v0.160.0.md | v0.160.0 | 2026-09-03 |
| opentelemetry-collector-contrib/processor/resourcedetectionprocessor/v0.161.0.md | v0.161.0 | 2026-10-03 |
| opentelemetry-collector-contrib/processor/resourcedetectionprocessor/v0.162.0.md | v0.162.0 | 2026-10-03 |
| opentelemetry-collector-contrib/processor/resourcedetectionprocessor/v0.163.0.md | v0.163.0 | null |
| opentelemetry-collector-contrib/processor/tailsamplingprocessor/v0.153.0.md | v0.153.0 | 2026-08-11 |
| opentelemetry-collector-contrib/processor/tailsamplingprocessor/v0.154.0.md | v0.154.0 | 2026-08-11 |
| opentelemetry-collector-contrib/processor/tailsamplingprocessor/v0.155.0.md | v0.155.0 | 2026-08-11 |
| opentelemetry-collector-contrib/processor/tailsamplingprocessor/v0.156.0.md | v0.156.0 | 2026-08-11 |
| opentelemetry-collector-contrib/processor/tailsamplingprocessor/v0.157.0.md | v0.157.0 | 2026-08-11 |
| opentelemetry-collector-contrib/processor/tailsamplingprocessor/v0.158.0.md | v0.158.0 | 2026-08-11 |
| opentelemetry-collector-contrib/processor/tailsamplingprocessor/v0.159.0.md | v0.159.0 | 2026-10-14 |
| opentelemetry-collector-contrib/processor/tailsamplingprocessor/v0.160.0.md | v0.160.0 | 2026-10-14 |
| opentelemetry-collector-contrib/processor/tailsamplingprocessor/v0.161.0.md | v0.161.0 | 2026-10-14 |
| opentelemetry-collector-contrib/processor/tailsamplingprocessor/v0.162.0.md | v0.162.0 | 2026-10-14 |
| opentelemetry-collector-contrib/processor/tailsamplingprocessor/v0.163.0.md | v0.163.0 | 2026-10-14 |
| opentelemetry-collector-contrib/receiver/dockerstatsreceiver/v0.153.0.md | v0.153.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/dockerstatsreceiver/v0.154.0.md | v0.154.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/dockerstatsreceiver/v0.155.0.md | v0.155.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/dockerstatsreceiver/v0.156.0.md | v0.156.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/dockerstatsreceiver/v0.157.0.md | v0.157.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/dockerstatsreceiver/v0.158.0.md | v0.158.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/dockerstatsreceiver/v0.159.0.md | v0.159.0 | 2026-08-24 |
| opentelemetry-collector-contrib/receiver/dockerstatsreceiver/v0.160.0.md | v0.160.0 | 2026-09-03 |
| opentelemetry-collector-contrib/receiver/dockerstatsreceiver/v0.161.0.md | v0.161.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/dockerstatsreceiver/v0.162.0.md | v0.162.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/dockerstatsreceiver/v0.163.0.md | v0.163.0 | 2026-10-14 |
| opentelemetry-collector-contrib/receiver/filelogreceiver/v0.153.0.md | v0.153.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/filelogreceiver/v0.154.0.md | v0.154.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/filelogreceiver/v0.155.0.md | v0.155.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/filelogreceiver/v0.156.0.md | v0.156.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/filelogreceiver/v0.157.0.md | v0.157.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/filelogreceiver/v0.158.0.md | v0.158.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/filelogreceiver/v0.159.0.md | v0.159.0 | null |
| opentelemetry-collector-contrib/receiver/filelogreceiver/v0.160.0.md | v0.160.0 | 2026-09-03 |
| opentelemetry-collector-contrib/receiver/filelogreceiver/v0.161.0.md | v0.161.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/filelogreceiver/v0.162.0.md | v0.162.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/filelogreceiver/v0.163.0.md | v0.163.0 | null |
| opentelemetry-collector-contrib/receiver/hostmetricsreceiver/v0.153.0.md | v0.153.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/hostmetricsreceiver/v0.154.0.md | v0.154.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/hostmetricsreceiver/v0.155.0.md | v0.155.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/hostmetricsreceiver/v0.156.0.md | v0.156.0 | 2026-08-06 |
| opentelemetry-collector-contrib/receiver/hostmetricsreceiver/v0.157.0.md | v0.157.0 | 2026-08-06 |
| opentelemetry-collector-contrib/receiver/hostmetricsreceiver/v0.158.0.md | v0.158.0 | 2026-08-06 |
| opentelemetry-collector-contrib/receiver/hostmetricsreceiver/v0.159.0.md | v0.159.0 | 2026-10-14 |
| opentelemetry-collector-contrib/receiver/hostmetricsreceiver/v0.160.0.md | v0.160.0 | 2026-09-03 |
| opentelemetry-collector-contrib/receiver/hostmetricsreceiver/v0.161.0.md | v0.161.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/hostmetricsreceiver/v0.162.0.md | v0.162.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/hostmetricsreceiver/v0.163.0.md | v0.163.0 | 2026-10-14 |
| opentelemetry-collector-contrib/receiver/httpcheckreceiver/v0.153.0.md | v0.153.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/httpcheckreceiver/v0.154.0.md | v0.154.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/httpcheckreceiver/v0.155.0.md | v0.155.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/httpcheckreceiver/v0.156.0.md | v0.156.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/httpcheckreceiver/v0.157.0.md | v0.157.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/httpcheckreceiver/v0.158.0.md | v0.158.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/httpcheckreceiver/v0.159.0.md | v0.159.0 | null |
| opentelemetry-collector-contrib/receiver/httpcheckreceiver/v0.160.0.md | v0.160.0 | 2026-09-03 |
| opentelemetry-collector-contrib/receiver/httpcheckreceiver/v0.161.0.md | v0.161.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/httpcheckreceiver/v0.162.0.md | v0.162.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/httpcheckreceiver/v0.163.0.md | v0.163.0 | null |
| opentelemetry-collector-contrib/receiver/icmpcheckreceiver/v0.153.0.md | v0.153.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/icmpcheckreceiver/v0.154.0.md | v0.154.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/icmpcheckreceiver/v0.155.0.md | v0.155.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/icmpcheckreceiver/v0.156.0.md | v0.156.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/icmpcheckreceiver/v0.157.0.md | v0.157.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/icmpcheckreceiver/v0.158.0.md | v0.158.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/icmpcheckreceiver/v0.159.0.md | v0.159.0 | 2026-10-14 |
| opentelemetry-collector-contrib/receiver/icmpcheckreceiver/v0.160.0.md | v0.160.0 | 2026-09-03 |
| opentelemetry-collector-contrib/receiver/icmpcheckreceiver/v0.161.0.md | v0.161.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/icmpcheckreceiver/v0.162.0.md | v0.162.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/icmpcheckreceiver/v0.163.0.md | v0.163.0 | 2026-10-14 |
| opentelemetry-collector-contrib/receiver/k8sclusterreceiver/v0.153.0.md | v0.153.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/k8sclusterreceiver/v0.154.0.md | v0.154.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/k8sclusterreceiver/v0.155.0.md | v0.155.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/k8sclusterreceiver/v0.156.0.md | v0.156.0 | 2026-09-09 |
| opentelemetry-collector-contrib/receiver/k8sclusterreceiver/v0.157.0.md | v0.157.0 | 2026-08-06 |
| opentelemetry-collector-contrib/receiver/k8sclusterreceiver/v0.158.0.md | v0.158.0 | 2026-08-06 |
| opentelemetry-collector-contrib/receiver/k8sclusterreceiver/v0.160.0.md | v0.160.0 | 2026-09-03 |
| opentelemetry-collector-contrib/receiver/k8sclusterreceiver/v0.161.0.md | v0.161.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/k8sclusterreceiver/v0.162.0.md | v0.162.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/k8sclusterreceiver/v0.163.0.md | v0.163.0 | null |
| opentelemetry-collector-contrib/receiver/k8seventsreceiver/v0.153.0.md | v0.153.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/k8seventsreceiver/v0.154.0.md | v0.154.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/k8seventsreceiver/v0.155.0.md | v0.155.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/k8seventsreceiver/v0.156.0.md | v0.156.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/k8seventsreceiver/v0.157.0.md | v0.157.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/k8seventsreceiver/v0.158.0.md | v0.158.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/k8seventsreceiver/v0.159.0.md | v0.159.0 | 2026-08-24 |
| opentelemetry-collector-contrib/receiver/k8seventsreceiver/v0.160.0.md | v0.160.0 | 2026-09-03 |
| opentelemetry-collector-contrib/receiver/k8seventsreceiver/v0.161.0.md | v0.161.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/k8seventsreceiver/v0.162.0.md | v0.162.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/kafkareceiver/v0.153.0.md | v0.153.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/kafkareceiver/v0.154.0.md | v0.154.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/kafkareceiver/v0.155.0.md | v0.155.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/kafkareceiver/v0.156.0.md | v0.156.0 | 2026-08-06 |
| opentelemetry-collector-contrib/receiver/kafkareceiver/v0.157.0.md | v0.157.0 | 2026-08-06 |
| opentelemetry-collector-contrib/receiver/kafkareceiver/v0.158.0.md | v0.158.0 | 2026-08-06 |
| opentelemetry-collector-contrib/receiver/kafkareceiver/v0.159.0.md | v0.159.0 | 2026-10-14 |
| opentelemetry-collector-contrib/receiver/kafkareceiver/v0.160.0.md | v0.160.0 | 2026-09-03 |
| opentelemetry-collector-contrib/receiver/kafkareceiver/v0.161.0.md | v0.161.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/kafkareceiver/v0.162.0.md | v0.162.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/kafkareceiver/v0.163.0.md | v0.163.0 | 2026-10-14 |
| opentelemetry-collector-contrib/receiver/kubeletstatsreceiver/v0.153.0.md | v0.153.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/kubeletstatsreceiver/v0.154.0.md | v0.154.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/kubeletstatsreceiver/v0.155.0.md | v0.155.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/kubeletstatsreceiver/v0.156.0.md | v0.156.0 | 2026-08-06 |
| opentelemetry-collector-contrib/receiver/kubeletstatsreceiver/v0.157.0.md | v0.157.0 | 2026-08-06 |
| opentelemetry-collector-contrib/receiver/kubeletstatsreceiver/v0.158.0.md | v0.158.0 | 2026-08-06 |
| opentelemetry-collector-contrib/receiver/kubeletstatsreceiver/v0.159.0.md | v0.159.0 | 2026-08-26 |
| opentelemetry-collector-contrib/receiver/kubeletstatsreceiver/v0.160.0.md | v0.160.0 | 2026-09-03 |
| opentelemetry-collector-contrib/receiver/kubeletstatsreceiver/v0.161.0.md | v0.161.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/kubeletstatsreceiver/v0.162.0.md | v0.162.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/kubeletstatsreceiver/v0.163.0.md | v0.163.0 | null |
| opentelemetry-collector-contrib/receiver/mongodbreceiver/v0.153.0.md | v0.153.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/mongodbreceiver/v0.154.0.md | v0.154.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/mongodbreceiver/v0.155.0.md | v0.155.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/mongodbreceiver/v0.156.0.md | v0.156.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/mongodbreceiver/v0.157.0.md | v0.157.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/mongodbreceiver/v0.158.0.md | v0.158.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/mongodbreceiver/v0.159.0.md | v0.159.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/mongodbreceiver/v0.160.0.md | v0.160.0 | 2026-09-03 |
| opentelemetry-collector-contrib/receiver/mongodbreceiver/v0.161.0.md | v0.161.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/mongodbreceiver/v0.162.0.md | v0.162.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/mongodbreceiver/v0.163.0.md | v0.163.0 | null |
| opentelemetry-collector-contrib/receiver/mysqlreceiver/v0.153.0.md | v0.153.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/mysqlreceiver/v0.154.0.md | v0.154.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/mysqlreceiver/v0.155.0.md | v0.155.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/mysqlreceiver/v0.156.0.md | v0.156.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/mysqlreceiver/v0.157.0.md | v0.157.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/mysqlreceiver/v0.158.0.md | v0.158.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/mysqlreceiver/v0.159.0.md | v0.159.0 | 2026-08-26 |
| opentelemetry-collector-contrib/receiver/mysqlreceiver/v0.160.0.md | v0.160.0 | 2026-09-03 |
| opentelemetry-collector-contrib/receiver/mysqlreceiver/v0.161.0.md | v0.161.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/mysqlreceiver/v0.162.0.md | v0.162.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/nginxreceiver/v0.153.0.md | v0.153.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/nginxreceiver/v0.154.0.md | v0.154.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/nginxreceiver/v0.155.0.md | v0.155.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/nginxreceiver/v0.156.0.md | v0.156.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/nginxreceiver/v0.157.0.md | v0.157.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/nginxreceiver/v0.158.0.md | v0.158.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/nginxreceiver/v0.159.0.md | v0.159.0 | 2026-10-14 |
| opentelemetry-collector-contrib/receiver/nginxreceiver/v0.160.0.md | v0.160.0 | 2026-09-03 |
| opentelemetry-collector-contrib/receiver/nginxreceiver/v0.161.0.md | v0.161.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/nginxreceiver/v0.162.0.md | v0.162.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/nginxreceiver/v0.163.0.md | v0.163.0 | 2026-10-14 |
| opentelemetry-collector-contrib/receiver/postgresqlreceiver/v0.153.0.md | v0.153.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/postgresqlreceiver/v0.154.0.md | v0.154.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/postgresqlreceiver/v0.155.0.md | v0.155.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/postgresqlreceiver/v0.156.0.md | v0.156.0 | 2026-08-06 |
| opentelemetry-collector-contrib/receiver/postgresqlreceiver/v0.157.0.md | v0.157.0 | 2026-08-06 |
| opentelemetry-collector-contrib/receiver/postgresqlreceiver/v0.158.0.md | v0.158.0 | 2026-08-06 |
| opentelemetry-collector-contrib/receiver/postgresqlreceiver/v0.159.0.md | v0.159.0 | 2026-08-26 |
| opentelemetry-collector-contrib/receiver/postgresqlreceiver/v0.160.0.md | v0.160.0 | 2026-09-03 |
| opentelemetry-collector-contrib/receiver/postgresqlreceiver/v0.161.0.md | v0.161.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/postgresqlreceiver/v0.162.0.md | v0.162.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/postgresqlreceiver/v0.163.0.md | v0.163.0 | null |
| opentelemetry-collector-contrib/receiver/prometheusreceiver/v0.153.0.md | v0.153.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/prometheusreceiver/v0.154.0.md | v0.154.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/prometheusreceiver/v0.155.0.md | v0.155.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/prometheusreceiver/v0.156.0.md | v0.156.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/prometheusreceiver/v0.157.0.md | v0.157.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/prometheusreceiver/v0.158.0.md | v0.158.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/prometheusreceiver/v0.159.0.md | v0.159.0 | 2026-08-24 |
| opentelemetry-collector-contrib/receiver/prometheusreceiver/v0.160.0.md | v0.160.0 | 2026-09-03 |
| opentelemetry-collector-contrib/receiver/prometheusreceiver/v0.161.0.md | v0.161.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/prometheusreceiver/v0.162.0.md | v0.162.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/prometheusreceiver/v0.163.0.md | v0.163.0 | 2026-10-14 |
| opentelemetry-collector-contrib/receiver/rabbitmqreceiver/v0.153.0.md | v0.153.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/rabbitmqreceiver/v0.154.0.md | v0.154.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/rabbitmqreceiver/v0.155.0.md | v0.155.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/rabbitmqreceiver/v0.156.0.md | v0.156.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/rabbitmqreceiver/v0.157.0.md | v0.157.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/rabbitmqreceiver/v0.158.0.md | v0.158.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/rabbitmqreceiver/v0.159.0.md | v0.159.0 | 2026-10-14 |
| opentelemetry-collector-contrib/receiver/rabbitmqreceiver/v0.160.0.md | v0.160.0 | 2026-09-03 |
| opentelemetry-collector-contrib/receiver/rabbitmqreceiver/v0.161.0.md | v0.161.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/rabbitmqreceiver/v0.162.0.md | v0.162.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/rabbitmqreceiver/v0.163.0.md | v0.163.0 | 2026-10-14 |
| opentelemetry-collector-contrib/receiver/redisreceiver/v0.153.0.md | v0.153.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/redisreceiver/v0.154.0.md | v0.154.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/redisreceiver/v0.155.0.md | v0.155.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/redisreceiver/v0.156.0.md | v0.156.0 | 2026-08-06 |
| opentelemetry-collector-contrib/receiver/redisreceiver/v0.157.0.md | v0.157.0 | 2026-08-06 |
| opentelemetry-collector-contrib/receiver/redisreceiver/v0.158.0.md | v0.158.0 | 2026-08-06 |
| opentelemetry-collector-contrib/receiver/redisreceiver/v0.159.0.md | v0.159.0 | null |
| opentelemetry-collector-contrib/receiver/redisreceiver/v0.160.0.md | v0.160.0 | 2026-09-03 |
| opentelemetry-collector-contrib/receiver/redisreceiver/v0.161.0.md | v0.161.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/redisreceiver/v0.162.0.md | v0.162.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/redisreceiver/v0.163.0.md | v0.163.0 | null |
| opentelemetry-collector-contrib/receiver/sqlserverreceiver/v0.153.0.md | v0.153.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/sqlserverreceiver/v0.154.0.md | v0.154.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/sqlserverreceiver/v0.155.0.md | v0.155.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/sqlserverreceiver/v0.156.0.md | v0.156.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/sqlserverreceiver/v0.157.0.md | v0.157.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/sqlserverreceiver/v0.158.0.md | v0.158.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/sqlserverreceiver/v0.159.0.md | v0.159.0 | 2026-08-26 |
| opentelemetry-collector-contrib/receiver/sqlserverreceiver/v0.160.0.md | v0.160.0 | 2026-09-03 |
| opentelemetry-collector-contrib/receiver/sqlserverreceiver/v0.161.0.md | v0.161.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/sqlserverreceiver/v0.162.0.md | v0.162.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/sqlserverreceiver/v0.163.0.md | v0.163.0 | 2026-10-14 |
| opentelemetry-collector-contrib/receiver/tcpcheckreceiver/v0.153.0.md | v0.153.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/tcpcheckreceiver/v0.154.0.md | v0.154.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/tcpcheckreceiver/v0.155.0.md | v0.155.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/tcpcheckreceiver/v0.156.0.md | v0.156.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/tcpcheckreceiver/v0.157.0.md | v0.157.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/tcpcheckreceiver/v0.158.0.md | v0.158.0 | 2026-08-11 |
| opentelemetry-collector-contrib/receiver/tcpcheckreceiver/v0.159.0.md | v0.159.0 | 2026-10-14 |
| opentelemetry-collector-contrib/receiver/tcpcheckreceiver/v0.160.0.md | v0.160.0 | 2026-09-03 |
| opentelemetry-collector-contrib/receiver/tcpcheckreceiver/v0.161.0.md | v0.161.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/tcpcheckreceiver/v0.162.0.md | v0.162.0 | 2026-10-03 |
| opentelemetry-collector-contrib/receiver/tcpcheckreceiver/v0.163.0.md | v0.163.0 | 2026-10-14 |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.AspNetCore/v1.15.1.md | v1.15.1 | 2026-10-14 |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.AspNetCore/v1.15.2.md | v1.15.2 | 2026-10-14 |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.AspNetCore/v1.16.0.md | v1.16.0 | 2026-10-14 |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.AspNetCore/v1.17.0.md | v1.17.0 | 2026-10-14 |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.AspNetCore/v1.18.0.md | v1.18.0 | 2026-10-14 |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.AspNetCore/v1.19.0.md | v1.19.0 | 2026-10-14 |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.ConfluentKafka/v0.1.0-alpha.6.md | v0.1.0-alpha.6 | null |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.ConfluentKafka/v0.1.0-alpha.7.md | v0.1.0-alpha.7 | null |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.ConfluentKafka/v0.2.0-alpha.1.md | v0.2.0-alpha.1 | null |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.ConfluentKafka/v0.2.0-alpha.2.md | v0.2.0-alpha.2 | null |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.ConfluentKafka/v0.3.0-alpha.1.md | v0.3.0-alpha.1 | null |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.ConfluentKafka/v0.3.0-alpha.2.md | v0.3.0-alpha.2 | null |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.EntityFrameworkCore/v1.15.1-beta.1.md | v1.15.1-beta.1 | 2026-06-10 |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.EntityFrameworkCore/v1.16.0-beta.1.md | v1.16.0-beta.1 | null |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.EntityFrameworkCore/v1.17.0-beta.1.md | v1.17.0-beta.1 | null |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.EntityFrameworkCore/v1.18.0-beta.1.md | v1.18.0-beta.1 | null |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.EntityFrameworkCore/v1.19.0-beta.1.md | v1.19.0-beta.1 | null |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.EntityFrameworkCore/v1.19.1-beta.1.md | v1.19.1-beta.1 | null |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.GrpcNetClient/v1.15.1-beta.1.md | v1.15.1-beta.1 | 2026-10-02 |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.GrpcNetClient/v1.16.0-beta.1.md | v1.16.0-beta.1 | 2026-10-02 |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.GrpcNetClient/v1.17.0-beta.1.md | v1.17.0-beta.1 | 2026-10-02 |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.GrpcNetClient/v1.18.0-beta.1.md | v1.18.0-beta.1 | 2026-10-02 |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.GrpcNetClient/v1.19.0-beta.1.md | v1.19.0-beta.1 | 2026-10-02 |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.GrpcNetClient/v1.19.1-beta.1.md | v1.19.1-beta.1 | 2026-10-02 |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.Http/v1.19.0.md | v1.19.0 | 2026-10-14 |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.Runtime/v1.15.0.md | v1.15.0 | 2026-10-14 |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.Runtime/v1.15.1.md | v1.15.1 | 2026-10-14 |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.Runtime/v1.16.0.md | v1.16.0 | 2026-10-14 |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.Runtime/v1.17.0.md | v1.17.0 | 2026-10-14 |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.Runtime/v1.18.0.md | v1.18.0 | 2026-10-14 |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.Runtime/v1.19.0.md | v1.19.0 | 2026-10-14 |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.SqlClient/v1.15.1.md | v1.15.1 | 2026-04-15 |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.SqlClient/v1.15.2.md | v1.15.2 | null |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.SqlClient/v1.16.0.md | v1.16.0 | null |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.SqlClient/v1.17.0.md | v1.17.0 | null |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.SqlClient/v1.18.0.md | v1.18.0 | null |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.SqlClient/v1.19.0.md | v1.19.0 | null |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.StackExchangeRedis/v1.16.0-beta.1.md | v1.16.0-beta.1 | null |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.StackExchangeRedis/v1.17.0-beta.1.md | v1.17.0-beta.1 | null |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.StackExchangeRedis/v1.18.0-beta.1.md | v1.18.0-beta.1 | null |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.StackExchangeRedis/v1.18.0-beta.2.md | v1.18.0-beta.2 | null |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.StackExchangeRedis/v1.18.0-beta.3.md | v1.18.0-beta.3 | null |
| opentelemetry-dotnet-contrib/src/OpenTelemetry.Instrumentation.StackExchangeRedis/v1.19.0-beta.1.md | v1.19.0-beta.1 | null |
| opentelemetry-go-contrib/instrumentation/github.com/gin-gonic/gin/otelgin/v0.65.0.md | v0.65.0 | 2026-08-11 |
| opentelemetry-go-contrib/instrumentation/github.com/gin-gonic/gin/otelgin/v0.66.0.md | v0.66.0 | 2026-08-11 |
| opentelemetry-go-contrib/instrumentation/github.com/gin-gonic/gin/otelgin/v0.67.0.md | v0.67.0 | 2026-08-11 |
| opentelemetry-go-contrib/instrumentation/github.com/gin-gonic/gin/otelgin/v0.68.0.md | v0.68.0 | null |
| opentelemetry-go-contrib/instrumentation/github.com/gin-gonic/gin/otelgin/v0.69.0.md | v0.69.0 | null |
| opentelemetry-go-contrib/instrumentation/github.com/gin-gonic/gin/otelgin/v0.70.0.md | v0.70.0 | null |
| opentelemetry-go-contrib/instrumentation/github.com/gin-gonic/gin/otelgin/v0.71.0.md | v0.71.0 | 2026-09-03 |
| opentelemetry-go-contrib/instrumentation/github.com/gin-gonic/gin/otelgin/v0.72.0.md | v0.72.0 | 2026-10-03 |
| opentelemetry-go-contrib/instrumentation/google.golang.org/grpc/otelgrpc/v0.65.0.md | v0.65.0 | 2026-08-11 |
| opentelemetry-go-contrib/instrumentation/google.golang.org/grpc/otelgrpc/v0.66.0.md | v0.66.0 | 2026-08-11 |
| opentelemetry-go-contrib/instrumentation/google.golang.org/grpc/otelgrpc/v0.67.0.md | v0.67.0 | 2026-08-11 |
| opentelemetry-go-contrib/instrumentation/google.golang.org/grpc/otelgrpc/v0.68.0.md | v0.68.0 | 2026-08-06 |
| opentelemetry-go-contrib/instrumentation/google.golang.org/grpc/otelgrpc/v0.69.0.md | v0.69.0 | 2026-08-06 |
| opentelemetry-go-contrib/instrumentation/google.golang.org/grpc/otelgrpc/v0.70.0.md | v0.70.0 | 2026-08-06 |
| opentelemetry-go-contrib/instrumentation/google.golang.org/grpc/otelgrpc/v0.71.0.md | v0.71.0 | 2026-09-03 |
| opentelemetry-go-contrib/instrumentation/google.golang.org/grpc/otelgrpc/v0.72.0.md | v0.72.0 | 2026-10-03 |
| opentelemetry-go-contrib/instrumentation/net/http/otelhttp/v0.65.0.md | v0.65.0 | 2026-08-11 |
| opentelemetry-go-contrib/instrumentation/net/http/otelhttp/v0.66.0.md | v0.66.0 | 2026-08-11 |
| opentelemetry-go-contrib/instrumentation/net/http/otelhttp/v0.67.0.md | v0.67.0 | 2026-08-11 |
| opentelemetry-go-contrib/instrumentation/net/http/otelhttp/v0.68.0.md | v0.68.0 | 2026-08-06 |
| opentelemetry-go-contrib/instrumentation/net/http/otelhttp/v0.69.0.md | v0.69.0 | 2026-08-06 |
| opentelemetry-go-contrib/instrumentation/net/http/otelhttp/v0.70.0.md | v0.70.0 | 2026-08-06 |
| opentelemetry-go-contrib/instrumentation/net/http/otelhttp/v0.71.0.md | v0.71.0 | 2026-09-03 |
| opentelemetry-go-contrib/instrumentation/net/http/otelhttp/v0.72.0.md | v0.72.0 | 2026-10-03 |
| opentelemetry-go-contrib/instrumentation/runtime/v0.65.0.md | v0.65.0 | 2026-08-11 |
| opentelemetry-go-contrib/instrumentation/runtime/v0.66.0.md | v0.66.0 | 2026-08-11 |
| opentelemetry-go-contrib/instrumentation/runtime/v0.67.0.md | v0.67.0 | 2026-08-11 |
| opentelemetry-go-contrib/instrumentation/runtime/v0.68.0.md | v0.68.0 | 2026-08-06 |
| opentelemetry-go-contrib/instrumentation/runtime/v0.69.0.md | v0.69.0 | 2026-08-06 |
| opentelemetry-go-contrib/instrumentation/runtime/v0.70.0.md | v0.70.0 | 2026-08-06 |
| opentelemetry-go-contrib/instrumentation/runtime/v0.71.0.md | v0.71.0 | 2026-09-03 |
| opentelemetry-go-contrib/instrumentation/runtime/v0.72.0.md | v0.72.0 | 2026-10-03 |
| opentelemetry-java-instrumentation/instrumentation/grpc-1.6/v2.28.1.md | v2.28.1 | 2026-07-03 |
| opentelemetry-java-instrumentation/instrumentation/grpc-1.6/v2.29.0.md | v2.29.0 | 2026-07-03 |
| opentelemetry-java-instrumentation/instrumentation/grpc-1.6/v2.30.0.md | v2.30.0 | null |
| opentelemetry-java-instrumentation/instrumentation/grpc-1.6/v2.31.0.md | v2.31.0 | null |
| opentelemetry-java-instrumentation/instrumentation/grpc-1.6/v2.31.1.md | v2.31.1 | null |
| opentelemetry-java-instrumentation/instrumentation/grpc-1.6/v2.32.0.md | v2.32.0 | null |
| opentelemetry-java-instrumentation/instrumentation/java-http-client/v2.26.1.md | v2.26.1 | 2026-08-11 |
| opentelemetry-java-instrumentation/instrumentation/java-http-client/v2.27.0.md | v2.27.0 | 2026-08-11 |
| opentelemetry-java-instrumentation/instrumentation/java-http-client/v2.28.0.md | v2.28.0 | 2026-08-11 |
| opentelemetry-java-instrumentation/instrumentation/java-http-client/v2.28.1.md | v2.28.1 | 2026-08-11 |
| opentelemetry-java-instrumentation/instrumentation/java-http-client/v2.29.0.md | v2.29.0 | 2026-08-11 |
| opentelemetry-java-instrumentation/instrumentation/java-http-client/v2.30.0.md | v2.30.0 | 2026-08-11 |
| opentelemetry-java-instrumentation/instrumentation/java-http-client/v2.31.0.md | v2.31.0 | null |
| opentelemetry-java-instrumentation/instrumentation/java-http-client/v2.31.1.md | v2.31.1 | 2026-08-26 |
| opentelemetry-java-instrumentation/instrumentation/java-http-client/v2.32.0.md | v2.32.0 | null |
| opentelemetry-java-instrumentation/instrumentation/jdbc/v2.28.1.md | v2.28.1 | 2026-10-14 |
| opentelemetry-java-instrumentation/instrumentation/jdbc/v2.29.0.md | v2.29.0 | 2026-10-14 |
| opentelemetry-java-instrumentation/instrumentation/jdbc/v2.30.0.md | v2.30.0 | 2026-10-14 |
| opentelemetry-java-instrumentation/instrumentation/jdbc/v2.31.0.md | v2.31.0 | 2026-10-14 |
| opentelemetry-java-instrumentation/instrumentation/jdbc/v2.31.1.md | v2.31.1 | 2026-10-14 |
| opentelemetry-java-instrumentation/instrumentation/jdbc/v2.32.0.md | v2.32.0 | 2026-10-14 |
| opentelemetry-java-instrumentation/instrumentation/kafka/v2.26.1.md | v2.26.1 | 2026-08-11 |
| opentelemetry-java-instrumentation/instrumentation/kafka/v2.27.0.md | v2.27.0 | 2026-08-11 |
| opentelemetry-java-instrumentation/instrumentation/kafka/v2.28.0.md | v2.28.0 | 2026-08-11 |
| opentelemetry-java-instrumentation/instrumentation/kafka/v2.28.1.md | v2.28.1 | 2026-08-11 |
| opentelemetry-java-instrumentation/instrumentation/kafka/v2.29.0.md | v2.29.0 | 2026-08-11 |
| opentelemetry-java-instrumentation/instrumentation/kafka/v2.30.0.md | v2.30.0 | 2026-08-11 |
| opentelemetry-java-instrumentation/instrumentation/kafka/v2.31.0.md | v2.31.0 | 2026-08-26 |
| opentelemetry-java-instrumentation/instrumentation/kafka/v2.31.1.md | v2.31.1 | 2026-08-26 |
| opentelemetry-java-instrumentation/instrumentation/kafka/v2.32.0.md | v2.32.0 | null |
| opentelemetry-java-instrumentation/instrumentation/logback/v2.28.1.md | v2.28.1 | null |
| opentelemetry-java-instrumentation/instrumentation/logback/v2.29.0.md | v2.29.0 | null |
| opentelemetry-java-instrumentation/instrumentation/logback/v2.30.0.md | v2.30.0 | null |
| opentelemetry-java-instrumentation/instrumentation/logback/v2.31.0.md | v2.31.0 | null |
| opentelemetry-java-instrumentation/instrumentation/logback/v2.31.1.md | v2.31.1 | null |
| opentelemetry-java-instrumentation/instrumentation/logback/v2.32.0.md | v2.32.0 | null |
| opentelemetry-java-instrumentation/instrumentation/netty/v2.28.1.md | v2.28.1 | 2026-10-14 |
| opentelemetry-java-instrumentation/instrumentation/netty/v2.29.0.md | v2.29.0 | 2026-10-14 |
| opentelemetry-java-instrumentation/instrumentation/netty/v2.30.0.md | v2.30.0 | 2026-10-14 |
| opentelemetry-java-instrumentation/instrumentation/netty/v2.31.0.md | v2.31.0 | 2026-10-14 |
| opentelemetry-java-instrumentation/instrumentation/netty/v2.31.1.md | v2.31.1 | 2026-10-14 |
| opentelemetry-java-instrumentation/instrumentation/netty/v2.32.0.md | v2.32.0 | 2026-10-14 |
| opentelemetry-java-instrumentation/instrumentation/servlet/v2.26.1.md | v2.26.1 | 2026-08-11 |
| opentelemetry-java-instrumentation/instrumentation/servlet/v2.27.0.md | v2.27.0 | 2026-08-11 |
| opentelemetry-java-instrumentation/instrumentation/servlet/v2.28.0.md | v2.28.0 | 2026-08-11 |
| opentelemetry-java-instrumentation/instrumentation/servlet/v2.28.1.md | v2.28.1 | 2026-08-11 |
| opentelemetry-java-instrumentation/instrumentation/servlet/v2.29.0.md | v2.29.0 | 2026-08-11 |
| opentelemetry-java-instrumentation/instrumentation/servlet/v2.30.0.md | v2.30.0 | 2026-08-11 |
| opentelemetry-java-instrumentation/instrumentation/servlet/v2.31.1.md | v2.31.1 | 2026-08-26 |
| opentelemetry-java-instrumentation/instrumentation/servlet/v2.32.0.md | v2.32.0 | 2026-10-14 |
| opentelemetry-java-instrumentation/instrumentation/spring/spring-webflux/v2.25.0.md | v2.25.0 | 2026-08-11 |
| opentelemetry-java-instrumentation/instrumentation/spring/spring-webflux/v2.26.1.md | v2.26.1 | 2026-08-11 |
| opentelemetry-java-instrumentation/instrumentation/spring/spring-webflux/v2.27.0.md | v2.27.0 | 2026-08-11 |
| opentelemetry-java-instrumentation/instrumentation/spring/spring-webflux/v2.28.1.md | v2.28.1 | 2026-08-11 |
| opentelemetry-java-instrumentation/instrumentation/spring/spring-webflux/v2.29.0.md | v2.29.0 | 2026-08-11 |
| opentelemetry-java-instrumentation/instrumentation/spring/spring-webflux/v2.30.0.md | v2.30.0 | 2026-08-11 |
| opentelemetry-java-instrumentation/instrumentation/spring/spring-webflux/v2.31.0.md | v2.31.0 | null |
| opentelemetry-java-instrumentation/instrumentation/spring/spring-webflux/v2.31.1.md | v2.31.1 | 2026-08-26 |
| opentelemetry-java-instrumentation/instrumentation/spring/spring-webmvc/v2.28.1.md | v2.28.1 | null |
| opentelemetry-java-instrumentation/instrumentation/spring/spring-webmvc/v2.29.0.md | v2.29.0 | null |
| opentelemetry-java-instrumentation/instrumentation/spring/spring-webmvc/v2.30.0.md | v2.30.0 | null |
| opentelemetry-java-instrumentation/instrumentation/spring/spring-webmvc/v2.31.0.md | v2.31.0 | null |
| opentelemetry-java-instrumentation/instrumentation/spring/spring-webmvc/v2.31.1.md | v2.31.1 | null |
| opentelemetry-java-instrumentation/instrumentation/spring/spring-webmvc/v2.32.0.md | v2.32.0 | null |
| opentelemetry-js/experimental/packages/opentelemetry-instrumentation-grpc/v0.216.0.md | v0.216.0 | 2026-08-11 |
| opentelemetry-js/experimental/packages/opentelemetry-instrumentation-grpc/v0.217.0.md | v0.217.0 | 2026-08-11 |
| opentelemetry-js/experimental/packages/opentelemetry-instrumentation-grpc/v0.218.0.md | v0.218.0 | 2026-08-11 |
| opentelemetry-js/experimental/packages/opentelemetry-instrumentation-grpc/v0.219.0.md | v0.219.0 | 2026-08-06 |
| opentelemetry-js/experimental/packages/opentelemetry-instrumentation-grpc/v0.220.0.md | v0.220.0 | 2026-08-06 |
| opentelemetry-js/experimental/packages/opentelemetry-instrumentation-grpc/v0.221.0.md | v0.221.0 | 2026-08-06 |
| opentelemetry-js/experimental/packages/opentelemetry-instrumentation-grpc/v0.222.0.md | v0.222.0 | 2026-09-03 |
| opentelemetry-js/experimental/packages/opentelemetry-instrumentation-grpc/v0.223.0.md | v0.223.0 | null |
| opentelemetry-js/experimental/packages/opentelemetry-instrumentation-http/v0.216.0.md | v0.216.0 | 2026-08-11 |
| opentelemetry-js/experimental/packages/opentelemetry-instrumentation-http/v0.217.0.md | v0.217.0 | 2026-08-11 |
| opentelemetry-js/experimental/packages/opentelemetry-instrumentation-http/v0.218.0.md | v0.218.0 | 2026-08-11 |
| opentelemetry-js/experimental/packages/opentelemetry-instrumentation-http/v0.219.0.md | v0.219.0 | 2026-08-06 |
| opentelemetry-js/experimental/packages/opentelemetry-instrumentation-http/v0.220.0.md | v0.220.0 | 2026-08-06 |
| opentelemetry-js/experimental/packages/opentelemetry-instrumentation-http/v0.221.0.md | v0.221.0 | 2026-10-14 |
| opentelemetry-js/experimental/packages/opentelemetry-instrumentation-http/v0.222.0.md | v0.222.0 | 2026-10-14 |
| opentelemetry-js/experimental/packages/opentelemetry-instrumentation-http/v0.223.0.md | v0.223.0 | 2026-10-14 |
| opentelemetry-js-contrib/packages/instrumentation-express/v0.64.0.md | v0.64.0 | 2026-08-11 |
| opentelemetry-js-contrib/packages/instrumentation-express/v0.65.0.md | v0.65.0 | 2026-08-11 |
| opentelemetry-js-contrib/packages/instrumentation-express/v0.66.0.md | v0.66.0 | 2026-08-11 |
| opentelemetry-js-contrib/packages/instrumentation-express/v0.67.0.md | v0.67.0 | 2026-08-06 |
| opentelemetry-js-contrib/packages/instrumentation-express/v0.68.0.md | v0.68.0 | 2026-08-06 |
| opentelemetry-js-contrib/packages/instrumentation-express/v0.69.0.md | v0.69.0 | 2026-08-06 |
| opentelemetry-js-contrib/packages/instrumentation-express/v0.70.0.md | v0.70.0 | 2026-09-03 |
| opentelemetry-js-contrib/packages/instrumentation-express/v0.71.0.md | v0.71.0 | 2026-10-14 |
| opentelemetry-js-contrib/packages/instrumentation-ioredis/v0.64.0.md | v0.64.0 | 2026-08-11 |
| opentelemetry-js-contrib/packages/instrumentation-ioredis/v0.65.0.md | v0.65.0 | 2026-08-11 |
| opentelemetry-js-contrib/packages/instrumentation-ioredis/v0.66.0.md | v0.66.0 | 2026-08-11 |
| opentelemetry-js-contrib/packages/instrumentation-ioredis/v0.67.0.md | v0.67.0 | 2026-08-06 |
| opentelemetry-js-contrib/packages/instrumentation-ioredis/v0.68.0.md | v0.68.0 | 2026-08-06 |
| opentelemetry-js-contrib/packages/instrumentation-ioredis/v0.69.0.md | v0.69.0 | 2026-08-06 |
| opentelemetry-js-contrib/packages/instrumentation-ioredis/v0.70.0.md | v0.70.0 | 2026-09-03 |
| opentelemetry-js-contrib/packages/instrumentation-ioredis/v0.71.0.md | v0.71.0 | null |
| opentelemetry-js-contrib/packages/instrumentation-mongodb/v0.69.0.md | v0.69.0 | 2026-08-11 |
| opentelemetry-js-contrib/packages/instrumentation-mongodb/v0.70.0.md | v0.70.0 | 2026-08-11 |
| opentelemetry-js-contrib/packages/instrumentation-mongodb/v0.71.0.md | v0.71.0 | 2026-08-11 |
| opentelemetry-js-contrib/packages/instrumentation-mongodb/v0.72.0.md | v0.72.0 | 2026-08-06 |
| opentelemetry-js-contrib/packages/instrumentation-mongodb/v0.73.0.md | v0.73.0 | 2026-08-06 |
| opentelemetry-js-contrib/packages/instrumentation-mongodb/v0.74.0.md | v0.74.0 | 2026-08-06 |
| opentelemetry-js-contrib/packages/instrumentation-mongodb/v0.75.0.md | v0.75.0 | 2026-09-03 |
| opentelemetry-js-contrib/packages/instrumentation-mongodb/v0.76.0.md | v0.76.0 | null |
| opentelemetry-js-contrib/packages/instrumentation-mysql2/v0.62.0.md | v0.62.0 | 2026-08-11 |
| opentelemetry-js-contrib/packages/instrumentation-mysql2/v0.63.0.md | v0.63.0 | 2026-08-11 |
| opentelemetry-js-contrib/packages/instrumentation-mysql2/v0.64.0.md | v0.64.0 | 2026-08-11 |
| opentelemetry-js-contrib/packages/instrumentation-mysql2/v0.65.0.md | v0.65.0 | 2026-08-06 |
| opentelemetry-js-contrib/packages/instrumentation-mysql2/v0.66.0.md | v0.66.0 | 2026-08-06 |
| opentelemetry-js-contrib/packages/instrumentation-mysql2/v0.67.0.md | v0.67.0 | 2026-08-06 |
| opentelemetry-js-contrib/packages/instrumentation-mysql2/v0.68.0.md | v0.68.0 | 2026-09-03 |
| opentelemetry-js-contrib/packages/instrumentation-mysql2/v0.69.0.md | v0.69.0 | null |
| opentelemetry-js-contrib/packages/instrumentation-pg/v0.68.0.md | v0.68.0 | 2026-08-11 |
| opentelemetry-js-contrib/packages/instrumentation-pg/v0.69.0.md | v0.69.0 | 2026-08-11 |
| opentelemetry-js-contrib/packages/instrumentation-pg/v0.70.0.md | v0.70.0 | 2026-08-11 |
| opentelemetry-js-contrib/packages/instrumentation-pg/v0.71.0.md | v0.71.0 | 2026-08-06 |
| opentelemetry-js-contrib/packages/instrumentation-pg/v0.72.0.md | v0.72.0 | 2026-08-06 |
| opentelemetry-js-contrib/packages/instrumentation-pg/v0.73.0.md | v0.73.0 | 2026-08-06 |
| opentelemetry-js-contrib/packages/instrumentation-pg/v0.74.0.md | v0.74.0 | 2026-09-03 |
| opentelemetry-js-contrib/packages/instrumentation-pg/v0.75.0.md | v0.75.0 | 2026-10-14 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-fastapi/v0.37b0.md | v0.37b0 | 2026-10-14 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-fastapi/v0.62b0.md | v0.62b0 | 2026-10-14 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-fastapi/v0.62b1.md | v0.62b1 | 2026-10-14 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-fastapi/v0.63b0.md | v0.63b0 | 2026-10-14 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-fastapi/v0.63b1.md | v0.63b1 | 2026-10-14 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-fastapi/v0.64b0.md | v0.64b0 | 2026-10-14 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-fastapi/v0.65b0.md | v0.65b0 | 2026-10-14 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-fastapi/v0.66b0.md | v0.66b0 | 2026-10-14 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-fastapi/v0.66b1.md | v0.66b1 | 2026-10-14 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-flask/v0.37b0.md | v0.37b0 | 2026-10-14 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-flask/v0.62b0.md | v0.62b0 | 2026-08-11 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-flask/v0.62b1.md | v0.62b1 | 2026-08-11 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-flask/v0.63b0.md | v0.63b0 | 2026-08-11 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-flask/v0.63b1.md | v0.63b1 | 2026-08-06 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-flask/v0.64b0.md | v0.64b0 | 2026-08-06 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-flask/v0.65b0.md | v0.65b0 | 2026-08-06 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-flask/v0.66b0.md | v0.66b0 | 2026-10-03 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-psycopg2/v0.37b0.md | v0.37b0 | 2026-10-14 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-psycopg2/v0.62b0.md | v0.62b0 | 2026-08-11 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-psycopg2/v0.62b1.md | v0.62b1 | 2026-08-11 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-psycopg2/v0.63b0.md | v0.63b0 | 2026-08-11 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-psycopg2/v0.63b1.md | v0.63b1 | 2026-08-06 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-psycopg2/v0.64b0.md | v0.64b0 | 2026-08-06 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-psycopg2/v0.65b0.md | v0.65b0 | 2026-08-06 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-psycopg2/v0.66b0.md | v0.66b0 | 2026-10-03 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-psycopg2/v0.66b1.md | v0.66b1 | 2026-10-14 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-redis/v0.37b0.md | v0.37b0 | 2026-10-14 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-redis/v0.62b0.md | v0.62b0 | 2026-08-11 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-redis/v0.62b1.md | v0.62b1 | 2026-08-11 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-redis/v0.63b0.md | v0.63b0 | 2026-08-11 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-redis/v0.63b1.md | v0.63b1 | 2026-08-06 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-redis/v0.64b0.md | v0.64b0 | 2026-08-06 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-redis/v0.65b0.md | v0.65b0 | 2026-08-06 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-redis/v0.66b0.md | v0.66b0 | 2026-10-14 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-redis/v0.66b1.md | v0.66b1 | 2026-10-14 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-requests/v0.37b0.md | v0.37b0 | 2026-08-11 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-requests/v0.62b1.md | v0.62b1 | 2026-08-11 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-requests/v0.63b0.md | v0.63b0 | 2026-08-11 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-requests/v0.63b1.md | v0.63b1 | 2026-08-06 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-requests/v0.64b0.md | v0.64b0 | 2026-08-06 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-requests/v0.65b0.md | v0.65b0 | 2026-08-06 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-requests/v0.66b0.md | v0.66b0 | 2026-10-03 |
| opentelemetry-python-contrib/instrumentation/opentelemetry-instrumentation-requests/v0.66b1.md | v0.66b1 | null |
  • SKILL.md 2.3 KB 
    ---
name: otel-telemetry-emissions
description: Version-pinned inventory of the telemetry (spans, metrics, logs, attributes) emitted by OpenTelemetry collector components and SDK instrumentation packages. Use when working with a covered component — what it emits at a given version, or how emission changed across versions — and when upgrading a component or SDK version, to see the telemetry after the change.
---

# Telemetry Emissions

A registry of what telemetry OpenTelemetry components actually emit, pinned to
upstream versions.

> **Note:** The telemetry emissions in these files were detected by LLM
> analysis of the upstream source and may contain errors. Verify against the
> component's source or docs before relying on a row for critical decisions.

## Layout

```
<repo basename>/<path in repo>/v<version>.md
```

Example: `opentelemetry-collector-contrib/receiver/kafkareceiver/v0.158.0.md`

One file per scanned version. The files in a component directory are its
telemetry history; `index.md` lists every file — start there to see what is
covered.

## Looking up a component at a version

1. Find the component's directory (or its row in `index.md`).
2. Pick the file matching the target version exactly.
3. If there is no exact match, use the file with the highest version below the
   target and say the exact version is unverified.
4. If the component or version is not covered at all, say so — do not infer
   telemetry from semantic conventions.

## What a data file contains

Frontmatter (`repo`, `path`, `version`, `scope_name`, `commit_sha`,
`last_verified`), then per-signal tables:

- **Traces** — span name, kind, attributes, notes
- **Metrics** — metric name, instrument type, unit, attributes, notes
- **Logs** — log/event name, attributes, notes

`scope_name` is the component's instrumentation scope — the anchor for
matching runtime telemetry back to the component. When helper or pipeline
telemetry uses another scope, its rows name that scope in `Notes`.
`last_verified: null` means the historical verification date could not be
substantiated; recheck the pinned source before presenting its rows as verified.
Absent signals are omitted
entirely. `Notes` marks conditional emission (feature gates, opt-in config,
experimental semconv). `Sources` lists the upstream files the data came from.

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.

Related

Claude Prompt
Tighten-my-prose editing prompt
Claude Skill
Adversarial code-review skill for Claude
Claude Workflow
Deep-research workflow (fan-out + verify)
Claude Skill
Conventional-commit writer for Claude