Federated Repository Metrics

JFrog Artifactory Documentation

Products
JFrog Artifactory
Content Type
User Guide
ft:sourceType
Paligo

The metrics available for monitoring Federated repositories are based on the Get Federation Mirror Lag Time REST API:Get Federation Mirror Lag Time

GET api/federation/status/mirrorsLag

Important

The first 4 metrics described below ignore Federated repositories that are disabled.

Federation Mirror Lag

Example:

jfrt_federation_member_lag_total{local_repo_key="example-repo-local", remote_repo_key="test3-repo", remote_url="http://docker.for.mac.localhost:10102/artifactory/"} 5000 1575374691025

Records all Federated repositories whose sync lag exceeds the defined threshold (in milliseconds).

Note

The measured lag must exceed the minimum threshold value defined in the system property artifactory.federated.metrics.sync.threshold.time.ms.

Federation Mirror Maximum Lag

Example:

jfrt_federation_max_lag_ms_total 500 1575374698000

Records the maximum lag value (500 in the example above) from among all Federated repositories in milliseconds.

Number of Mirrors Exceeding the Sync Threshold Value

Example:

jfrt_federation_num_mirrors_exceeding_lag_threshold_total 17 1575374698000

Records the total number of mirrors (17 in the example above) that have a sync lag larger than the default threshold. If no mirrors have a log above the threshold, the recorded value will be 0.

Number of Federated Repositories Exceeding the Sync Threshold Value

Example:

jfrt_federation_num_repos_exceeding_lag_threshold_total 9 1575374698000

Records the total number of distinct Federated repositories (9 in the example above) that have a sync lag larger than the default threshold. This value will always be equal to or less than the Number of Mirrors Exceeding the Sync Threshold value. If no repositories have a log above the threshold, the recorded value will be 0.

Number of Disabled Federated Members

Example:

jfrt_federation_num_members_disabled_total 2 1575374698000

Records the number of disabled mirrors (2 in the example above), including disabled Federated repositories from the JPD in context as well as disabled remote Federated repositories that are part of any existing Federation from the JPD in context.

Number of Federated Repositories per Status

Examples:

jfrt_federation_num_repos_status_total{status="healthy"} 232 1575374691025 
jfrt_federation_num_repos_status_total{status="out_of_sync"} 22 1575374691025 
jfrt_federation_num_repos_status_total{status="error_exhausted"} 13 1575374691025 
jfrt_federation_num_repos_status_total{status="pending_fullsync"} 41 1575374691025

Records the number of Federated repositories that have the indicated status. Possible statuses include: healthy, pending full sync, full sync running, out of sync, exhausted, disabled.