Process

Note: Sysdig follows the Prometheus-compabtible naming convention for both metrics and labels as opposed to the previous statsd-compatible, legacy Sysdig naming convention. However, this page still shows metrics in the legacy Sysdig naming convention. Until this page is updated, see Metrics and Label Mapping for the mapping between Sysdig legacy and Prometheus naming conventions.

fd.used.percent

The percentage of used file descriptors out of the maximum available. By default, this metric displays the average value for the defined scope. For example, if the scope is set to a group of machines, the metric value will be the average value for the whole group.

This metric should be monitored carefully, and used for alerts, as when a process reaches its file descriptor limit, the process will stop operating correctly, and potentially crash.

MetadataDescription
Metric TypeGauge
Value Type%
Segment ByHost, Container, Process, Kubernetes, Mesos, Swarm, CloudProvider
Default Time AggregationAverage
Available Time Aggregation FormatsAvg, Rate, Sum, Min, Max
Default Group AggregationAverage
Available Group Aggregation FormatsAvg, Sum, Min, Max

proc.commandLine

Command line used to start the process.

MetadataDescription
Metric TypeGauge
Value TypeString
Segment ByProcess
Default Time AggregationN/a
Available Time Aggregation FormatsN/A
Default Group AggregationN/A
Available Group Aggregation FormatsN/A

proc.count

The number of processes on host or container, excluding any processes that do not have .exe or command line parameters in the process table. These processes typically are kernel or system level, and are typically identified by square brackets (for example, [kthreadd]).

As some processes are excluded, the host level proc.count value will be lower than the value reported by the ps -ef command on the host.

MetadataDescription
Metric TypeCounter
Value TypeInteger
Segment ByHost, Container, Process, Kubernetes, Mesos, Swarm, CloudProvider
Default Time AggregationRate
Available Time Aggregation FormatsAvg, Rate, Sum, Min, Max
Default Group AggregationSum
Available Group Aggregation FormatsAvg, Sum, Min, Max

proc.name

Name of the process.

MetadataDescription
Metric TypeGauge
Value TypeString
Segment ByProcess
Default Time AggregationN/A
Available Time Aggregation FormatsN/A
Default Group AggregationN/A
Available Group Aggregation FormatsN/A

proc.name.client

Name of the Client process.

MetadataDescription
Metric TypeGauge
Value TypeString
Segment ByProcess
Default Time AggregationN/A
Available Time Aggregation FormatsN/A
Default Group AggregationN/A
Available Group Aggregation FormatsN/A

proc.name.server

Name of the server process.

MetadataDescription
Metric TypeGauge
Value TypeString
Segment ByProcess
Default Time AggregationN/A
Available Time Aggregation FormatsN/A
Default Group AggregationN/A
Available Group Aggregation FormatsN/A

proc.start.count

Number of process starts on host or container.

MetadataDescription
Metric TypeGauge
Value TypeInteger
Segment ByHost, CloudProvider
Default Time AggregationRate
Available Time Aggregation FormatsAvg, Rate, Sum, Min, Max
Default Group AggregationSum
Available Group Aggregation FormatsAvg, Sum, Min, Max