What you can observe about Che

Che exposes metrics, logs, and telemetry data that help you monitor platform health, diagnose issues, and track workspace usage.

Che provides three categories of observability data:

Metrics

The Che server exposes JVM metrics (memory usage, classloading, garbage collection) on port 8087 via the che-host Service /metrics endpoint. The DevWorkspace Operator exposes workspace startup, failure, and performance metrics on port 8443 via the devworkspace-controller-metrics Service /metrics endpoint. The Kubernetes in-cluster monitoring stack (Prometheus) scrapes both endpoints. The Che Operator automatically creates the required ServiceMonitor, Role, and RoleBinding resources. You can view these metrics on custom dashboards in the Kubernetes web console.

Logs

The Che server uses configurable log levels for individual loggers. You can increase verbosity for specific components to isolate issues, log HTTP traffic between Che and the Kubernetes API server, and collect diagnostic logs with the chectl command-line tool. For log configuration procedures, see How server logging works.

Telemetry

Workspace activity events (start, stop, editor actions) can be sent to Segment and Woopra by using the built-in Woopra telemetry plugin, or to a custom analytics backend by using a telemetry plugin you build yourself. For details on building a custom plugin, see Creating a telemetry plugin.

Che does not include built-in alerting rules. To receive alerts when metrics exceed thresholds, configure Prometheus alerting rules for the metrics described in this guide.

Table 1. What do you need to observe?
Goal Description

Monitor server metrics

Enable Prometheus metrics for the Che server and view JVM dashboards.

Monitor workspace metrics

Enable Prometheus metrics for the DevWorkspace Operator and view workspace dashboards.

Configure logging

Control server log verbosity, log HTTP traffic, and collect diagnostic logs with chectl.

Configure telemetry

Send workspace activity data to Segment and Woopra with a CheCluster CR configuration change.