Operational Metrics
To better understand the behavior of Posit Package Manager, the server allows you to consume operational metrics via a Prometheus compatible HTTP endpoint. This standardized format allows you to monitor the health and behavior of Package Manager.
Metrics are enabled by default on port 2112, allowing the Package Manager to export metrics via URLs like http://localhost:2112/metrics. They can be disabled by setting Metrics.Enabled = false, and the port can be changed using Metrics.Listen = 2112.
Package Manager currently only supports HTTP connections to the Prometheus compatible endpoint.
Monitoring disk usage
Package Manager disk usage can vary depending on how the service is used. It can be helpful to monitor the exact consumption of the different storage classes. By enabling the StorageAudit configuration, Package Manager provides a way to monitor disk usage over time.
Package Manager provides the usage metrics for each storage class regardless of whether they are mounted on the same device. This will naturally result in duplicated values.
| Metric | Type | Description | Labels |
|---|---|---|---|
rspm_storage_calculation_time |
Gauge | The time in seconds it took to query for file system usage | path |
rspm_storage_free |
Gauge | The free space of the file system in GB | path |
rspm_storage_size |
Gauge | The size of the file system in GB | path |
rspm_storage_used |
Gauge | The used space in this path of the file system in GB | path |
Monitoring R package binary routing
Since Posit makes a best effort to serve binaries, there will be cases where a binary simply cannot be located for your environment. In these cases, the R package source will be served instead. You can retrieve the success rate of serving binaries using the provided metrics.
| Metric | Type | Description | Labels |
|---|---|---|---|
binary_routing_binary |
Counter | Binary requests fulfilled. | match |
binary_routing_distro |
Counter | Binary requests, by distro. | distro, status |
binary_routing_fallback |
Counter | Binary request failures. | reason |
Additional Metrics
Package Manager exposes a number of other Prometheus metrics that can help you understand its behaviour, detect issues, and troubleshoot operational errors:
| Metric | Type | Description | Labels |
|---|---|---|---|
rspm_git_build_duration_seconds |
Histogram | Duration of Git builds, in seconds. | None |
rspm_git_builds_failed_total |
Counter | Total number of failed Git builds. | None |
rspm_git_subprocess_cpu_seconds_total |
Counter | CPU usage, in seconds, of Git subprocesses. | None |
rspm_http_requests_inflight |
Gauge | Number of HTTP requests currently being served. | None |
rspm_http_requests_total |
Counter | Total HTTP requests served. | code, method |
rspm_http_response_size_bytes_total |
Counter | Total bytes served in HTTP responses. | code, method |
rspm_license_expiry |
Gauge | Timestamp for when this node’s product license expires. | None |
rspm_license_days_left |
Gauge | Days remaining until this node’s product license expires for easier alerting. | None |
rspm_support_days_left |
Gauge | Days remaining until this product version is outside the support window. | None |
rspm_repo_source_sync_checkpoints_total |
Counter | Total upstream checkpoints synced by sources. | type |
rspm_repo_source_sync_completed |
Gauge | Timestamp of the last completed upstream sync. | type |
rspm_repo_source_sync_duration_seconds |
Histogram | Duration of upstream syncs for sources, in seconds. | type |
rspm_repo_source_sync_operations_total |
Counter | Total upstream changes synced by sources. | type |