File
Sysdig follows the Prometheus-compatible naming convention for both metrics and labels as opposed to the previous statsd-compatible, legacy Sysdig naming convention. This page shows metrics in the legacy Sysdig naming convention. See Metrics and Label Mapping for the mapping between Sysdig legacy and Prometheus naming conventions.
file.bytes.in
The number of bytes read from the file. By default, this metric displays the total value for the defined scope. For example, if the scope is set to a group of machines, the metric value will be the total value for the whole group.
| Metadata | Description |
|---|---|
| Metric Type | Counter |
| Value Type | Byte |
| Segment By | Host, Container, Process, Kubernetes, Mesos, Swarm, CloudProvider |
| Default Time Aggregation | Rate |
| Available Time Aggregation Formats | Avg, Rate, Sum, Min, Max |
| Default Group Aggregation | Sum |
| Available Group Aggregation Formats | Avg, Sum, Min, Max |
file.bytes.out
The number of bytes written to the file. By default, this metric displays the total value for the defined scope. For example, if the scope is set to a group of machines, the metric value will be the total value for the whole group.
| Metadata | Description |
|---|---|
| Metric Type | Counter |
| Value Type | Byte |
| Segment By | Host, Container, Process, Kubernetes, Mesos, Swarm, CloudProvider |
| Default Time Aggregation | Rate |
| Available Time Aggregation Formats | Avg, Rate, Sum, Min, Max |
| Default Group Aggregation | Sum |
| Available Group Aggregation Formats | Avg, Sum, Min, Max |
file.bytes.total
The total number of bytes written to, and read from, the file. By default, this metric displays the total value for the defined scope. For example, if the scope is set to a group of machines, the metric value will be the total value for the whole group.
| Metadata | Description |
|---|---|
| Metric Type | Counter |
| Value Type | Byte |
| Segment By | Host, Container, Process, Kubernetes, Mesos, Swarm, CloudProvider |
| Default Time Aggregation | Rate |
| Available Time Aggregation Formats | Avg, Rate, Sum, Min, Max |
| Default Group Aggregation | Sum |
| Available Group Aggregation Formats | Avg, Sum, Min, Max |
file.error.open.count
The number of errors that occurred when opening files. By default, this metric displays the total value for the defined scope. For example, if the scope is set to a group of machines, the metric value will be the total value for the whole group.
| Metadata | Description |
|---|---|
| Metric Type | Counter |
| Value Type | Integer |
| Segment By | Host, Container, Process, Kubernetes, Mesos, Swarm, CloudProvider |
| Default Time Aggregation | Rate |
| Available Time Aggregation Formats | Avg, Rate, Sum, Min, Max |
| Default Group Aggregation | Sum |
| Available Group Aggregation Formats | Avg, Sum, Min, Max |
file.error.total.count
The number of errors encountered by file system calls, such as open(),
close(), and create(). By default, this metric displays the total
value for the defined scope. For example, if the scope is defined as a
group of machines, the metric value will be the total value for the
whole group.
| Metadata | Description |
|---|---|
| Metric Type | Counter |
| Value Type | Integer |
| Segment By | Host, Container, Process, Kubernetes, Mesos, Swarm, CloudProvider |
| Default Time Aggregation | Rate |
| Available Time Aggregation Formats | Avg, Rate, Sum, Min, Max |
| Default Group Aggregation | Sum |
| Available Group Aggregation Formats | Avg, Sum, Min, Max |
file.iops.in
The number of file read operations per second. This metric is calculated by measuring the actual number of read requests made by a process. By default, this metric displays the total value for the defined scope. For example, if the scope is set to a group of machines, the metric value will be the total value for the whole group.
The value of file.iops.in can differ from the value other tools show,
as they are usually based on interpolating this value from the number of
bytes read and written to the file system.
| Metadata | Description |
|---|---|
| Metric Type | Counter |
| Value Type | Integer |
| Segment By | Host, Container, Process, Kubernetes, Mesos, Swarm, CloudProvider |
| Default Time Aggregation | Rate |
| Available Time Aggregation Formats | Avg, Rate, Sum, Min, Max |
| Default Group Aggregation | Sum |
| Available Group Aggregation Formats | Avg, Sum, Min, Max |
file.iops.out
The number of file write operations per second. This metric is calculated by measuring the actual number of write requests made by a process. By default, this metric displays the total value for the defined scope. For example, if the scope is set to a group of machines, the metric value will be the total value for the whole group.
The value of file.iops.out can differ from the value other tools show,
as they are usually based on interpolating this value from the number of
bytes read and written to the file system.
| Metadata | Description |
|---|---|
| Metric Type | Counter |
| Value Type | Integer |
| Segment By | Host, Container, Process, Kubernetes, Mesos, Swarm, CloudProvider |
| Default Time Aggregation | Rate |
| Available Time Aggregation Formats | Avg, Rate, Sum, Min, Max |
| Default Group Aggregation | Sum |
| Available Group Aggregation Formats | Avg, Sum, Min, Max |
file.iops.total
The number of file read and write operations per second. This metric is calculated by measuring the actual number of read/write requests made by a process. By default, this metric displays the total value for the defined scope. For example, if the scope is set to a group of machines, the metric value will be the total value for the whole group.
The value of file.iops.total can differ from the value other tools
show, as they are usually based on interpolating this value from the
number of bytes read and written to the file system.
| Metadata | Description |
|---|---|
| Metric Type | Counter |
| Value Type | Integer |
| Segment By | Host, Container, Process, Kubernetes, Mesos, Swarm, CloudProvider |
| Default Time Aggregation | Rate |
| Available Time Aggregation Formats | Avg, Rate, Sum, Min, Max |
| Default Group Aggregation | Sum |
| Available Group Aggregation Formats | Avg, Sum, Min, Max |
file.name
The name of the file.
| Metadata | Description |
|---|---|
| Metric Type | Gauge |
| Value Type | String |
| Segment By | Host |
| Default Time Aggregation | N/A |
| Available Time Aggregation Formats | N/A |
| Default Group Aggregation | N/A |
| Available Group Aggregation Formats | N/A |
file.open.count
When segmenting by file name, the metric represents the rate of open events for a particular file With other segmentations, it represents the number of all files currently open in a particular context (host, container, process, etc.).
| Metadata | Description |
|---|---|
| Metric Type | Counter |
| Value Type | Integer |
| Segment By | Host, Container, Process, Kubernetes, Mesos, Swarm, CloudProvider |
| Default Time Aggregation | Rate |
| Available Time Aggregation Formats | Avg, Rate, Sum, Min, Max |
| Default Group Aggregation | Sum |
| Available Group Aggregation Formats | Avg, Sum, Min, Max |
file.time.in
The time spent reading the file. By default, this metric displays the total value for the defined scope. For example, if the scope is set to a group of machines, the metric value will be the total value for the whole group.
| Metadata | Description |
|---|---|
| Metric Type | Counter |
| Value Type | relativeTime |
| Segment By | Host, Container, Process, Kubernetes, Mesos, Swarm, CloudProvider |
| Default Time Aggregation | Average |
| Available Time Aggregation Formats | Avg, Rate, Sum, Min, Max |
| Default Group Aggregation | Average |
| Available Group Aggregation Formats | Avg, Sum, Min, Max |
file.time.out
The time spent writing in the file. By default, this metric displays the total value for the defined scope. For example, if the scope is set to a group of machines, the metric value will be the total value for the whole group.
| Metadata | Description |
|---|---|
| Metric Type | Counter |
| Value Type | relativeTime |
| Segment By | Host, Container, Process, Kubernetes, Mesos, Swarm, CloudProvider |
| Default Time Aggregation | Average |
| Available Time Aggregation Formats | Avg, Rate, Sum, Min, Max |
| Default Group Aggregation | Average |
| Available Group Aggregation Formats | Avg, Sum, Min, Max |
file.time.total
The time spent during file I/O. By default, this metric displays the total value for the defined scope. For example, if the scope is set to a group of machines, the metric value will be the total value for the whole group.
| Metadata | Description |
|---|---|
| Metric Type | Counter |
| Value Type | relativeTime |
| Segment By | Host, Container, Process, Kubernetes, Mesos, Swarm, CloudProvider |
| Default Time Aggregation | Average |
| Available Time Aggregation Formats | Avg, Rate, Sum, Min, Max |
| Default Group Aggregation | Average |
| Available Group Aggregation Formats | Avg, Sum, Min, Max |
Feedback
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.