diff --git a/receiver/dockerstatsreceiver/documentation.md b/receiver/dockerstatsreceiver/documentation.md index 1df1ffe717790..5e99b56bf17f7 100644 --- a/receiver/dockerstatsreceiver/documentation.md +++ b/receiver/dockerstatsreceiver/documentation.md @@ -18,9 +18,9 @@ Number of bytes transferred to/from the disk by the group and descendant groups. More docs for [cgroups v1](https://www.kernel.org/doc/Documentation/cgroup-v1/blkio-controller.txt) and [cgroups v2](https://www.kernel.org/doc/Documentation/cgroup-v2.txt) -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | true | development | #### Attributes @@ -34,33 +34,33 @@ More docs for [cgroups v1](https://www.kernel.org/doc/Documentation/cgroup-v1/bl Time spent by tasks of the cgroup in kernel mode (Linux). Time spent by all container processes in kernel mode (Windows). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| ns | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| ns | Sum | Int | Cumulative | true | development | ### container.cpu.usage.total Total CPU time consumed. -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| ns | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| ns | Sum | Int | Cumulative | true | development | ### container.cpu.usage.usermode Time spent by tasks of the cgroup in user mode (Linux). Time spent by all container processes in user mode (Windows). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| ns | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| ns | Sum | Int | Cumulative | true | development | ### container.cpu.utilization Percent of CPU used by the container. -| Unit | Metric Type | Value Type | -| ---- | ----------- | ---------- | -| 1 | Gauge | Double | +| Unit | Metric Type | Value Type | Stability | +| ---- | ----------- | ---------- | --------- | +| 1 | Gauge | Double | development | ### container.memory.file @@ -68,49 +68,49 @@ Amount of memory used to cache filesystem data, including tmpfs and shared memor [More docs](https://www.kernel.org/doc/Documentation/cgroup-v2.txt) -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | false | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | false | development | ### container.memory.percent Percentage of memory used. Not supported on Windows. -| Unit | Metric Type | Value Type | -| ---- | ----------- | ---------- | -| 1 | Gauge | Double | +| Unit | Metric Type | Value Type | Stability | +| ---- | ----------- | ---------- | --------- | +| 1 | Gauge | Double | development | ### container.memory.total_cache Total amount of memory used by the processes of this cgroup (and descendants) that can be associated with a block on a block device. Also accounts for memory used by tmpfs (Only available with cgroups v1). Not supported on Windows. -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | false | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | false | development | ### container.memory.usage.limit Memory limit of the container. Not supported on Windows. -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | false | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | false | development | ### container.memory.usage.total Memory usage of the container. This excludes the cache. -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | false | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | false | development | ### container.network.io.usage.rx_bytes Bytes received by the container. -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | true | development | #### Attributes @@ -122,9 +122,9 @@ Bytes received by the container. Incoming packets dropped. -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| {packets} | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| {packets} | Sum | Int | Cumulative | true | development | #### Attributes @@ -136,9 +136,9 @@ Incoming packets dropped. Bytes sent. -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | true | development | #### Attributes @@ -150,9 +150,9 @@ Bytes sent. Outgoing packets dropped. -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| {packets} | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| {packets} | Sum | Int | Cumulative | true | development | #### Attributes @@ -176,9 +176,9 @@ Number of bios/requests merged into requests belonging to this cgroup and its de [More docs](https://www.kernel.org/doc/Documentation/cgroup-v1/blkio-controller.txt). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| {operations} | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| {operations} | Sum | Int | Cumulative | true | development | #### Attributes @@ -194,9 +194,9 @@ Number of requests queued up for this cgroup and its descendant cgroups (Only av [More docs](https://www.kernel.org/doc/Documentation/cgroup-v1/blkio-controller.txt). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| {operations} | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| {operations} | Sum | Int | Cumulative | true | development | #### Attributes @@ -212,9 +212,9 @@ Total amount of time in nanoseconds between request dispatch and request complet [More docs](https://www.kernel.org/doc/Documentation/cgroup-v1/blkio-controller.txt). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| ns | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| ns | Sum | Int | Cumulative | true | development | #### Attributes @@ -230,9 +230,9 @@ Number of IOs (bio) issued to the disk by the group and descendant groups (Only [More docs](https://www.kernel.org/doc/Documentation/cgroup-v1/blkio-controller.txt). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| {operations} | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| {operations} | Sum | Int | Cumulative | true | development | #### Attributes @@ -248,9 +248,9 @@ Disk time allocated to cgroup (and descendant cgroups) per device in millisecond [More docs](https://www.kernel.org/doc/Documentation/cgroup-v1/blkio-controller.txt). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| ms | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| ms | Sum | Int | Cumulative | true | development | #### Attributes @@ -266,9 +266,9 @@ Total amount of time the IOs for this cgroup (and descendant cgroups) spent wait [More docs](https://www.kernel.org/doc/Documentation/cgroup-v1/blkio-controller.txt). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| ns | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| ns | Sum | Int | Cumulative | true | development | #### Attributes @@ -284,9 +284,9 @@ Number of sectors transferred to/from disk by the group and descendant groups (O [More docs](https://www.kernel.org/doc/Documentation/cgroup-v1/blkio-controller.txt). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| {sectors} | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| {sectors} | Sum | Int | Cumulative | true | development | #### Attributes @@ -302,57 +302,57 @@ CPU limit set for the container. This metric is only reported if the container has limits set with -cpus, -cpuset-cpus or -cpu-quota. -| Unit | Metric Type | Value Type | -| ---- | ----------- | ---------- | -| {cpus} | Gauge | Double | +| Unit | Metric Type | Value Type | Stability | +| ---- | ----------- | ---------- | --------- | +| {cpus} | Gauge | Double | development | ### container.cpu.logical.count Number of cores available to the container. -| Unit | Metric Type | Value Type | -| ---- | ----------- | ---------- | -| {cpus} | Gauge | Int | +| Unit | Metric Type | Value Type | Stability | +| ---- | ----------- | ---------- | --------- | +| {cpus} | Gauge | Int | development | ### container.cpu.shares CPU shares set for the container. -| Unit | Metric Type | Value Type | -| ---- | ----------- | ---------- | -| 1 | Gauge | Int | +| Unit | Metric Type | Value Type | Stability | +| ---- | ----------- | ---------- | --------- | +| 1 | Gauge | Int | development | ### container.cpu.throttling_data.periods Number of periods with throttling active. -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| {periods} | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| {periods} | Sum | Int | Cumulative | true | development | ### container.cpu.throttling_data.throttled_periods Number of periods when the container hits its throttling limit. -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| {periods} | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| {periods} | Sum | Int | Cumulative | true | development | ### container.cpu.throttling_data.throttled_time Aggregate time the container was throttled. -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| ns | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| ns | Sum | Int | Cumulative | true | development | ### container.cpu.usage.percpu Per-core CPU usage by the container (Only available with cgroups v1). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| ns | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| ns | Sum | Int | Cumulative | true | development | #### Attributes @@ -366,17 +366,17 @@ System CPU usage, as reported by docker. Note this is the usage for the system, not the container. -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| ns | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| ns | Sum | Int | Cumulative | true | development | ### container.memory.active_anon The amount of anonymous memory that has been identified as active by the kernel. -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | false | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | false | development | ### container.memory.active_file @@ -384,9 +384,9 @@ Cache memory that has been identified as active by the kernel. [More docs](https://docs.docker.com/config/containers/runmetrics/) -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | false | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | false | development | ### container.memory.anon @@ -394,57 +394,57 @@ Amount of memory used in anonymous mappings such as brk(), sbrk(), and mmap(MAP_ [More docs](https://www.kernel.org/doc/Documentation/cgroup-v2.txt) -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | false | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | false | development | ### container.memory.cache The amount of memory used by the processes of this control group that can be associated precisely with a block on a block device (Only available with cgroups v1). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | false | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | false | development | ### container.memory.dirty Bytes that are waiting to get written back to the disk, from this cgroup (Only available with cgroups v1). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | false | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | false | development | ### container.memory.fails Number of times the memory limit was hit. -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| {fails} | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| {fails} | Sum | Int | Cumulative | true | development | ### container.memory.hierarchical_memory_limit The maximum amount of physical memory that can be used by the processes of this control group (Only available with cgroups v1). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | false | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | false | development | ### container.memory.hierarchical_memsw_limit The maximum amount of RAM + swap that can be used by the processes of this control group (Only available with cgroups v1). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | false | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | false | development | ### container.memory.inactive_anon The amount of anonymous memory that has been identified as inactive by the kernel. -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | false | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | false | development | ### container.memory.inactive_file @@ -452,33 +452,33 @@ Cache memory that has been identified as inactive by the kernel. [More docs](https://docs.docker.com/config/containers/runmetrics/) -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | false | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | false | development | ### container.memory.mapped_file Indicates the amount of memory mapped by the processes in the control group (Only available with cgroups v1). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | false | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | false | development | ### container.memory.pgfault Indicate the number of times that a process of the cgroup triggered a page fault. -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| {faults} | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| {faults} | Sum | Int | Cumulative | true | development | ### container.memory.pgmajfault Indicate the number of times that a process of the cgroup triggered a major fault. -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| {faults} | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| {faults} | Sum | Int | Cumulative | true | development | ### container.memory.pgpgin @@ -486,9 +486,9 @@ Number of pages read from disk by the cgroup (Only available with cgroups v1). [More docs](https://www.kernel.org/doc/Documentation/cgroup-v1/memory.txt). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| {operations} | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| {operations} | Sum | Int | Cumulative | true | development | ### container.memory.pgpgout @@ -496,33 +496,33 @@ Number of pages written to disk by the cgroup (Only available with cgroups v1). [More docs](https://www.kernel.org/doc/Documentation/cgroup-v1/memory.txt). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| {operations} | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| {operations} | Sum | Int | Cumulative | true | development | ### container.memory.rss The amount of memory that doesn’t correspond to anything on disk: stacks, heaps, and anonymous memory maps (Only available with cgroups v1). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | false | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | false | development | ### container.memory.rss_huge Number of bytes of anonymous transparent hugepages in this cgroup (Only available with cgroups v1). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | false | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | false | development | ### container.memory.total_active_anon The amount of anonymous memory that has been identified as active by the kernel. Includes descendant cgroups (Only available with cgroups v1). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | false | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | false | development | ### container.memory.total_active_file @@ -530,25 +530,25 @@ Cache memory that has been identified as active by the kernel. Includes descenda [More docs](https://docs.docker.com/config/containers/runmetrics/). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | false | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | false | development | ### container.memory.total_dirty Bytes that are waiting to get written back to the disk, from this cgroup and descendants (Only available with cgroups v1). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | false | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | false | development | ### container.memory.total_inactive_anon The amount of anonymous memory that has been identified as inactive by the kernel. Includes descendant cgroups (Only available with cgroups v1). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | false | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | false | development | ### container.memory.total_inactive_file @@ -556,113 +556,113 @@ Cache memory that has been identified as inactive by the kernel. Includes descen [More docs](https://docs.docker.com/config/containers/runmetrics/). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | false | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | false | development | ### container.memory.total_mapped_file Indicates the amount of memory mapped by the processes in the control group and descendant groups (Only available with cgroups v1). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | false | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | false | development | ### container.memory.total_pgfault Indicate the number of times that a process of the cgroup (or descendant cgroups) triggered a page fault (Only available with cgroups v1). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| {faults} | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| {faults} | Sum | Int | Cumulative | true | development | ### container.memory.total_pgmajfault Indicate the number of times that a process of the cgroup (or descendant cgroups) triggered a major fault (Only available with cgroups v1). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| {faults} | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| {faults} | Sum | Int | Cumulative | true | development | ### container.memory.total_pgpgin Number of pages read from disk by the cgroup and descendant groups (Only available with cgroups v1). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| {operations} | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| {operations} | Sum | Int | Cumulative | true | development | ### container.memory.total_pgpgout Number of pages written to disk by the cgroup and descendant groups (Only available with cgroups v1). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| {operations} | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| {operations} | Sum | Int | Cumulative | true | development | ### container.memory.total_rss The amount of memory that doesn’t correspond to anything on disk: stacks, heaps, and anonymous memory maps. Includes descendant cgroups (Only available with cgroups v1). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | false | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | false | development | ### container.memory.total_rss_huge Number of bytes of anonymous transparent hugepages in this cgroup and descendant cgroups (Only available with cgroups v1). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | false | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | false | development | ### container.memory.total_unevictable The amount of memory that cannot be reclaimed. Includes descendant cgroups (Only available with cgroups v1). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | false | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | false | development | ### container.memory.total_writeback Number of bytes of file/anon cache that are queued for syncing to disk in this cgroup and descendants (Only available with cgroups v1). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | false | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | false | development | ### container.memory.unevictable The amount of memory that cannot be reclaimed. -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | false | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | false | development | ### container.memory.usage.max Maximum memory usage. -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | false | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | false | development | ### container.memory.writeback Number of bytes of file/anon cache that are queued for syncing to disk in this cgroup (Only available with cgroups v1). -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| By | Sum | Int | Cumulative | false | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| By | Sum | Int | Cumulative | false | development | ### container.network.io.usage.rx_errors Received errors. Not supported on Windows. -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| {errors} | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| {errors} | Sum | Int | Cumulative | true | development | #### Attributes @@ -674,9 +674,9 @@ Received errors. Not supported on Windows. Packets received. -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| {packets} | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| {packets} | Sum | Int | Cumulative | true | development | #### Attributes @@ -688,9 +688,9 @@ Packets received. Sent errors. Not supported on Windows. -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| {errors} | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| {errors} | Sum | Int | Cumulative | true | development | #### Attributes @@ -702,9 +702,9 @@ Sent errors. Not supported on Windows. Packets sent. -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| {packets} | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| {packets} | Sum | Int | Cumulative | true | development | #### Attributes @@ -718,9 +718,9 @@ Number of pids in the container's cgroup. It requires docker API 1.23 or higher and kernel version >= 4.3 with pids cgroup supported. [More docs](https://www.kernel.org/doc/Documentation/cgroup-v1/pids.txt) -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| {pids} | Sum | Int | Cumulative | false | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| {pids} | Sum | Int | Cumulative | false | development | ### container.pids.limit @@ -728,25 +728,25 @@ Maximum number of pids in the container's cgroup. It requires docker API 1.23 or higher and kernel version >= 4.3 with pids cgroup supported. [More docs](https://www.kernel.org/doc/Documentation/cgroup-v1/pids.txt) -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| {pids} | Sum | Int | Cumulative | false | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| {pids} | Sum | Int | Cumulative | false | development | ### container.restarts Number of restarts for the container. -| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | -| ---- | ----------- | ---------- | ----------------------- | --------- | -| {restarts} | Sum | Int | Cumulative | true | +| Unit | Metric Type | Value Type | Aggregation Temporality | Monotonic | Stability | +| ---- | ----------- | ---------- | ----------------------- | --------- | --------- | +| {restarts} | Sum | Int | Cumulative | true | development | ### container.uptime Time elapsed since container start time. -| Unit | Metric Type | Value Type | -| ---- | ----------- | ---------- | -| s | Gauge | Double | +| Unit | Metric Type | Value Type | Stability | +| ---- | ----------- | ---------- | --------- | +| s | Gauge | Double | development | ## Resource Attributes diff --git a/receiver/dockerstatsreceiver/metadata.yaml b/receiver/dockerstatsreceiver/metadata.yaml index 4d8cd49e01769..c929043c91015 100644 --- a/receiver/dockerstatsreceiver/metadata.yaml +++ b/receiver/dockerstatsreceiver/metadata.yaml @@ -72,6 +72,8 @@ metrics: # CPU container.cpu.usage.system: enabled: false + stability: + level: development description: "System CPU usage, as reported by docker." extended_documentation: "Note this is the usage for the system, not the container." unit: ns @@ -81,6 +83,8 @@ metrics: aggregation_temporality: cumulative container.cpu.usage.total: enabled: true + stability: + level: development description: "Total CPU time consumed." unit: ns sum: @@ -89,6 +93,8 @@ metrics: aggregation_temporality: cumulative container.cpu.usage.kernelmode: enabled: true + stability: + level: development description: >- Time spent by tasks of the cgroup in kernel mode (Linux). Time spent by all container processes in kernel mode (Windows). @@ -99,6 +105,8 @@ metrics: aggregation_temporality: cumulative container.cpu.usage.usermode: enabled: true + stability: + level: development description: >- Time spent by tasks of the cgroup in user mode (Linux). Time spent by all container processes in user mode (Windows). @@ -109,6 +117,8 @@ metrics: aggregation_temporality: cumulative container.cpu.usage.percpu: enabled: false + stability: + level: development description: "Per-core CPU usage by the container (Only available with cgroups v1)." unit: ns sum: @@ -119,6 +129,8 @@ metrics: - core container.cpu.throttling_data.periods: enabled: false + stability: + level: development description: "Number of periods with throttling active." unit: "{periods}" sum: @@ -127,6 +139,8 @@ metrics: aggregation_temporality: cumulative container.cpu.throttling_data.throttled_periods: enabled: false + stability: + level: development description: "Number of periods when the container hits its throttling limit." unit: "{periods}" sum: @@ -135,6 +149,8 @@ metrics: aggregation_temporality: cumulative container.cpu.throttling_data.throttled_time: enabled: false + stability: + level: development description: "Aggregate time the container was throttled." unit: ns sum: @@ -143,12 +159,16 @@ metrics: aggregation_temporality: cumulative container.cpu.utilization: enabled: true + stability: + level: development description: "Percent of CPU used by the container." unit: "1" gauge: value_type: double container.cpu.limit: enabled: false + stability: + level: development description: "CPU limit set for the container." extended_documentation: "This metric is only reported if the container has limits set with -cpus, -cpuset-cpus or -cpu-quota." unit: "{cpus}" @@ -156,12 +176,16 @@ metrics: value_type: double container.cpu.shares: enabled: false + stability: + level: development description: "CPU shares set for the container." unit: "1" gauge: value_type: int container.cpu.logical.count: enabled: false + stability: + level: development description: "Number of cores available to the container." unit: "{cpus}" gauge: @@ -171,6 +195,8 @@ metrics: # Memory container.memory.usage.limit: enabled: true + stability: + level: development description: "Memory limit of the container. Not supported on Windows." unit: By sum: @@ -179,6 +205,8 @@ metrics: monotonic: false container.memory.usage.total: enabled: true + stability: + level: development description: "Memory usage of the container. This excludes the cache." unit: By sum: @@ -187,6 +215,8 @@ metrics: monotonic: false container.memory.usage.max: enabled: false + stability: + level: development description: "Maximum memory usage." unit: By sum: @@ -195,12 +225,16 @@ metrics: monotonic: false container.memory.percent: enabled: true + stability: + level: development description: "Percentage of memory used. Not supported on Windows." unit: "1" gauge: value_type: double container.memory.cache: enabled: false + stability: + level: development description: "The amount of memory used by the processes of this control group that can be associated precisely with a block on a block device (Only available with cgroups v1)." unit: By sum: @@ -209,6 +243,8 @@ metrics: monotonic: false container.memory.rss: enabled: false + stability: + level: development description: "The amount of memory that doesn’t correspond to anything on disk: stacks, heaps, and anonymous memory maps (Only available with cgroups v1)." unit: By sum: @@ -217,6 +253,8 @@ metrics: monotonic: false container.memory.rss_huge: enabled: false + stability: + level: development description: "Number of bytes of anonymous transparent hugepages in this cgroup (Only available with cgroups v1)." unit: By sum: @@ -225,6 +263,8 @@ metrics: monotonic: false container.memory.dirty: enabled: false + stability: + level: development description: "Bytes that are waiting to get written back to the disk, from this cgroup (Only available with cgroups v1)." unit: By sum: @@ -233,6 +273,8 @@ metrics: monotonic: false container.memory.writeback: enabled: false + stability: + level: development description: "Number of bytes of file/anon cache that are queued for syncing to disk in this cgroup (Only available with cgroups v1)." unit: By sum: @@ -241,6 +283,8 @@ metrics: monotonic: false container.memory.mapped_file: enabled: false + stability: + level: development description: "Indicates the amount of memory mapped by the processes in the control group (Only available with cgroups v1)." unit: By sum: @@ -249,6 +293,8 @@ metrics: monotonic: false container.memory.pgpgin: enabled: false + stability: + level: development description: "Number of pages read from disk by the cgroup (Only available with cgroups v1)." extended_documentation: "[More docs](https://www.kernel.org/doc/Documentation/cgroup-v1/memory.txt)." unit: "{operations}" @@ -258,6 +304,8 @@ metrics: monotonic: true container.memory.pgpgout: enabled: false + stability: + level: development description: "Number of pages written to disk by the cgroup (Only available with cgroups v1)." extended_documentation: "[More docs](https://www.kernel.org/doc/Documentation/cgroup-v1/memory.txt)." unit: "{operations}" @@ -267,6 +315,8 @@ metrics: monotonic: true container.memory.pgfault: enabled: false + stability: + level: development description: "Indicate the number of times that a process of the cgroup triggered a page fault." unit: "{faults}" sum: @@ -275,6 +325,8 @@ metrics: monotonic: true container.memory.pgmajfault: enabled: false + stability: + level: development description: "Indicate the number of times that a process of the cgroup triggered a major fault." unit: "{faults}" sum: @@ -283,6 +335,8 @@ metrics: monotonic: true container.memory.inactive_anon: enabled: false + stability: + level: development description: "The amount of anonymous memory that has been identified as inactive by the kernel." unit: By sum: @@ -291,6 +345,8 @@ metrics: monotonic: false container.memory.active_anon: enabled: false + stability: + level: development description: "The amount of anonymous memory that has been identified as active by the kernel." unit: By sum: @@ -299,6 +355,8 @@ metrics: monotonic: false container.memory.inactive_file: enabled: false + stability: + level: development description: "Cache memory that has been identified as inactive by the kernel." extended_documentation: "[More docs](https://docs.docker.com/config/containers/runmetrics/)" unit: By @@ -308,6 +366,8 @@ metrics: monotonic: false container.memory.active_file: enabled: false + stability: + level: development description: "Cache memory that has been identified as active by the kernel." extended_documentation: "[More docs](https://docs.docker.com/config/containers/runmetrics/)" unit: By @@ -317,6 +377,8 @@ metrics: monotonic: false container.memory.unevictable: enabled: false + stability: + level: development description: "The amount of memory that cannot be reclaimed." unit: By sum: @@ -325,6 +387,8 @@ metrics: monotonic: false container.memory.hierarchical_memory_limit: enabled: false + stability: + level: development description: "The maximum amount of physical memory that can be used by the processes of this control group (Only available with cgroups v1)." unit: By sum: @@ -333,6 +397,8 @@ metrics: monotonic: false container.memory.hierarchical_memsw_limit: enabled: false + stability: + level: development description: "The maximum amount of RAM + swap that can be used by the processes of this control group (Only available with cgroups v1)." unit: By sum: @@ -341,6 +407,8 @@ metrics: monotonic: false container.memory.total_cache: enabled: true + stability: + level: development description: "Total amount of memory used by the processes of this cgroup (and descendants) that can be associated with a block on a block device. Also accounts for memory used by tmpfs (Only available with cgroups v1). Not supported on Windows." unit: By sum: @@ -349,6 +417,8 @@ metrics: monotonic: false container.memory.total_rss: enabled: false + stability: + level: development description: "The amount of memory that doesn’t correspond to anything on disk: stacks, heaps, and anonymous memory maps. Includes descendant cgroups (Only available with cgroups v1)." unit: By sum: @@ -357,6 +427,8 @@ metrics: monotonic: false container.memory.total_rss_huge: enabled: false + stability: + level: development description: "Number of bytes of anonymous transparent hugepages in this cgroup and descendant cgroups (Only available with cgroups v1)." unit: By sum: @@ -365,6 +437,8 @@ metrics: monotonic: false container.memory.total_dirty: enabled: false + stability: + level: development description: "Bytes that are waiting to get written back to the disk, from this cgroup and descendants (Only available with cgroups v1)." unit: By sum: @@ -373,6 +447,8 @@ metrics: monotonic: false container.memory.total_writeback: enabled: false + stability: + level: development description: "Number of bytes of file/anon cache that are queued for syncing to disk in this cgroup and descendants (Only available with cgroups v1)." unit: By sum: @@ -381,6 +457,8 @@ metrics: monotonic: false container.memory.total_mapped_file: enabled: false + stability: + level: development description: "Indicates the amount of memory mapped by the processes in the control group and descendant groups (Only available with cgroups v1)." unit: By sum: @@ -389,6 +467,8 @@ metrics: monotonic: false container.memory.total_pgpgin: enabled: false + stability: + level: development description: "Number of pages read from disk by the cgroup and descendant groups (Only available with cgroups v1)." unit: "{operations}" sum: @@ -397,6 +477,8 @@ metrics: monotonic: true container.memory.total_pgpgout: enabled: false + stability: + level: development description: "Number of pages written to disk by the cgroup and descendant groups (Only available with cgroups v1)." unit: "{operations}" sum: @@ -405,6 +487,8 @@ metrics: monotonic: true container.memory.total_pgfault: enabled: false + stability: + level: development description: "Indicate the number of times that a process of the cgroup (or descendant cgroups) triggered a page fault (Only available with cgroups v1)." unit: "{faults}" sum: @@ -413,6 +497,8 @@ metrics: monotonic: true container.memory.total_pgmajfault: enabled: false + stability: + level: development description: "Indicate the number of times that a process of the cgroup (or descendant cgroups) triggered a major fault (Only available with cgroups v1)." unit: "{faults}" sum: @@ -421,6 +507,8 @@ metrics: monotonic: true container.memory.total_inactive_anon: enabled: false + stability: + level: development description: "The amount of anonymous memory that has been identified as inactive by the kernel. Includes descendant cgroups (Only available with cgroups v1)." unit: By sum: @@ -429,6 +517,8 @@ metrics: monotonic: false container.memory.total_active_anon: enabled: false + stability: + level: development description: "The amount of anonymous memory that has been identified as active by the kernel. Includes descendant cgroups (Only available with cgroups v1)." unit: By sum: @@ -437,6 +527,8 @@ metrics: monotonic: false container.memory.total_inactive_file: enabled: false + stability: + level: development description: "Cache memory that has been identified as inactive by the kernel. Includes descendant cgroups (Only available with cgroups v1)." extended_documentation: "[More docs](https://docs.docker.com/config/containers/runmetrics/)." unit: By @@ -446,6 +538,8 @@ metrics: monotonic: false container.memory.total_active_file: enabled: false + stability: + level: development description: "Cache memory that has been identified as active by the kernel. Includes descendant cgroups (Only available with cgroups v1)." extended_documentation: "[More docs](https://docs.docker.com/config/containers/runmetrics/)." unit: By @@ -455,6 +549,8 @@ metrics: monotonic: false container.memory.total_unevictable: enabled: false + stability: + level: development description: "The amount of memory that cannot be reclaimed. Includes descendant cgroups (Only available with cgroups v1)." unit: By sum: @@ -463,6 +559,8 @@ metrics: monotonic: false container.memory.anon: enabled: false + stability: + level: development description: "Amount of memory used in anonymous mappings such as brk(), sbrk(), and mmap(MAP_ANONYMOUS) (Only available with cgroups v2)." extended_documentation: "[More docs](https://www.kernel.org/doc/Documentation/cgroup-v2.txt)" unit: By @@ -472,6 +570,8 @@ metrics: monotonic: false container.memory.file: enabled: true + stability: + level: development description: "Amount of memory used to cache filesystem data, including tmpfs and shared memory (Only available with cgroups v2)." extended_documentation: "[More docs](https://www.kernel.org/doc/Documentation/cgroup-v2.txt)" unit: By @@ -481,6 +581,8 @@ metrics: monotonic: false container.memory.fails: enabled: false + stability: + level: development description: "Number of times the memory limit was hit." unit: "{fails}" sum: @@ -492,6 +594,8 @@ metrics: # BlockIO (cgroup v1) and IO (cgroup v2) controllers container.blockio.io_merged_recursive: enabled: false + stability: + level: development description: "Number of bios/requests merged into requests belonging to this cgroup and its descendant cgroups (Only available with cgroups v1)." extended_documentation: "[More docs](https://www.kernel.org/doc/Documentation/cgroup-v1/blkio-controller.txt)." unit: "{operations}" @@ -505,6 +609,8 @@ metrics: - operation container.blockio.io_queued_recursive: enabled: false + stability: + level: development description: "Number of requests queued up for this cgroup and its descendant cgroups (Only available with cgroups v1)." extended_documentation: "[More docs](https://www.kernel.org/doc/Documentation/cgroup-v1/blkio-controller.txt)." unit: "{operations}" @@ -518,6 +624,8 @@ metrics: - operation container.blockio.io_service_bytes_recursive: enabled: true + stability: + level: development description: "Number of bytes transferred to/from the disk by the group and descendant groups." extended_documentation: >- More docs @@ -534,6 +642,8 @@ metrics: - operation container.blockio.io_service_time_recursive: enabled: false + stability: + level: development description: "Total amount of time in nanoseconds between request dispatch and request completion for the IOs done by this cgroup and descendant cgroups (Only available with cgroups v1)." extended_documentation: "[More docs](https://www.kernel.org/doc/Documentation/cgroup-v1/blkio-controller.txt)." unit: ns @@ -547,6 +657,8 @@ metrics: - operation container.blockio.io_serviced_recursive: enabled: false + stability: + level: development description: "Number of IOs (bio) issued to the disk by the group and descendant groups (Only available with cgroups v1)." extended_documentation: "[More docs](https://www.kernel.org/doc/Documentation/cgroup-v1/blkio-controller.txt)." unit: "{operations}" @@ -560,6 +672,8 @@ metrics: - operation container.blockio.io_time_recursive: enabled: false + stability: + level: development description: "Disk time allocated to cgroup (and descendant cgroups) per device in milliseconds (Only available with cgroups v1)." extended_documentation: "[More docs](https://www.kernel.org/doc/Documentation/cgroup-v1/blkio-controller.txt)." unit: ms @@ -573,6 +687,8 @@ metrics: - operation container.blockio.io_wait_time_recursive: enabled: false + stability: + level: development description: "Total amount of time the IOs for this cgroup (and descendant cgroups) spent waiting in the scheduler queues for service (Only available with cgroups v1)." extended_documentation: "[More docs](https://www.kernel.org/doc/Documentation/cgroup-v1/blkio-controller.txt)." unit: ns @@ -586,6 +702,8 @@ metrics: - operation container.blockio.sectors_recursive: enabled: false + stability: + level: development description: "Number of sectors transferred to/from disk by the group and descendant groups (Only available with cgroups v1)." extended_documentation: "[More docs](https://www.kernel.org/doc/Documentation/cgroup-v1/blkio-controller.txt)." unit: "{sectors}" @@ -601,6 +719,8 @@ metrics: # Network container.network.io.usage.rx_bytes: enabled: true + stability: + level: development description: "Bytes received by the container." unit: By sum: @@ -611,6 +731,8 @@ metrics: - interface container.network.io.usage.tx_bytes: enabled: true + stability: + level: development description: "Bytes sent." unit: By sum: @@ -621,6 +743,8 @@ metrics: - interface container.network.io.usage.rx_dropped: enabled: true + stability: + level: development description: "Incoming packets dropped." unit: "{packets}" sum: @@ -631,6 +755,8 @@ metrics: - interface container.network.io.usage.tx_dropped: enabled: true + stability: + level: development description: "Outgoing packets dropped." unit: "{packets}" sum: @@ -641,6 +767,8 @@ metrics: - interface container.network.io.usage.rx_errors: enabled: false + stability: + level: development description: "Received errors. Not supported on Windows." unit: "{errors}" sum: @@ -651,6 +779,8 @@ metrics: - interface container.network.io.usage.tx_errors: enabled: false + stability: + level: development description: "Sent errors. Not supported on Windows." unit: "{errors}" sum: @@ -661,6 +791,8 @@ metrics: - interface container.network.io.usage.rx_packets: enabled: false + stability: + level: development description: "Packets received." unit: "{packets}" sum: @@ -671,6 +803,8 @@ metrics: - interface container.network.io.usage.tx_packets: enabled: false + stability: + level: development description: "Packets sent." unit: "{packets}" sum: @@ -683,6 +817,8 @@ metrics: # Pids container.pids.count: enabled: false + stability: + level: development description: "Number of pids in the container's cgroup." extended_documentation: "It requires docker API 1.23 or higher and kernel version >= 4.3 with pids cgroup supported. [More docs](https://www.kernel.org/doc/Documentation/cgroup-v1/pids.txt)" unit: "{pids}" @@ -693,6 +829,8 @@ metrics: container.pids.limit: enabled: false + stability: + level: development description: "Maximum number of pids in the container's cgroup." extended_documentation: "It requires docker API 1.23 or higher and kernel version >= 4.3 with pids cgroup supported. [More docs](https://www.kernel.org/doc/Documentation/cgroup-v1/pids.txt)" unit: "{pids}" @@ -704,6 +842,8 @@ metrics: # Base container.uptime: enabled: false + stability: + level: development description: "Time elapsed since container start time." unit: s gauge: @@ -712,6 +852,8 @@ metrics: # Container container.restarts: enabled: false + stability: + level: development description: "Number of restarts for the container." unit: "{restarts}" sum: