ARTIFACTORY: How to monitor the status of federated repositories?

Elina Floim
2023-01-22 11:10

Artifactory version 7.49.3 introduces a new feature that enables you to monitor the status of federated repositories using a set of dedicated REST APIs. These APIs can be used to get the status of the Federation for a specific repository, the federation mirror lag time, and information regarding unavailable mirrors.

Get federated repository status:

This REST API call can be used to retrieve the synchronization status of the federation for a specific repository. The information includes:

  • The number of tasks in progress
  • The number of failed tasks
  • The number of various types of pending events (create, update, delete, node property)
  • Server lag time (elapsed time since the last event not handled)
  • The number of fully (binary and metadata) and artificially (metadata only) replicated artifacts

Note: This API has a high impact on the database, therefore, it should be used carefully.

Get federated mirror lag time:

This REST API call can be used to retrieve the elapsed time since the last event that was not handled on each Federation mirror for all repositories. This API can be used to gather lag statistics at regular intervals. When a repository with significant lag is detected, the Get Federated Repository Status API can be used to get additional details.

Get unavailable mirrors:

This REST API call can be used to retrieve a list of unsynchronized federated mirrors from all repositories. Mirrors are considered unsynchronized in the following circumstances:

  • When the mirrors are first added to the federation
  • During repository migration from local to federated
  • When a certain error threshold is crossed