View the Status of All Repository Federations

JFrog Artifactory Documentation

Products
JFrog Artifactory
Content Type
User Guide
ft:sourceType
Paligo

Use the Federations dashboard to view a list of repository Federations and their current synchronization status.

To view the repository Federation status table: 

In the Administration module, select Monitoring > Federation Status.

Fed-dashboard_final-main.png

View Status Summaries

The tiles displayed above the table indicate how many repository Federations on this JPD are currently in the following statuses:

Status

Description

Healthy

Federations can attain a Healthy status only when all members are experiencing timely synchronization of metadata events. 

For example, a Federation cannot attain this status if one of its members has an error, is involved with a Full Sync operation, or is experiencing delays.

Delayed

Indicates how many Federations have at least one member with high latency, which means that synchronization of metadata events is taking longer than expected.

Error

Indicates how many Federations have at least one member with synchronization errors.

Pending Full Sync

Indicates how many Federations have at least one member waiting for a Full Sync to be performed. A Full Sync is performed during the initialization process when a Federation is created, and as a way to restore synchronization when regular synchronization and auto-healing are insufficient (for example, if there are purged events that are no longer available to be synchronized).

Full Sync Running

Indicates how many Federations have at least one member currently undergoing the Full Sync procedure.

The state of each member is based on an aggregation of all connections that are federated with the JPD on which this endpoint is run. The aggregation is based on the most severe state. In the example shown below, metadata events sent from the Federated repository gen-fed-fr are synchronizing in a timely fashion with gen-fed-au. Therefore, that connection is HEALTHY. However, there is a delay in sending events from gen-fed-fr to gen-fed-us. Therefore, the aggregated status of gen-fed-fr is DELAYED.

Federation_Repo_State_Summary_diagram_cropped.png

Filter the Repository Federations Table

Click one of the status cards to filter the Repository Federations table according to that status. For example, clicking the Healthy card shows only those Federations whose members are all synchronizing events in a timely fashion.

Fed-dashboard_healthy-filter.png

Tip

Click the filter icon Fed_dashboard_filter-table-icon.jpg above the table to filter it according to multiple statuses.

View the Status of Each Repository Federation

The Repository Federations table includes the following information:

Column

Description

Priority

A row displaying the flag icon indicates this Federated repository has been assigned priority to system resources. For more information, see Assign Priority to Federated Repositories.

Repository Key

The repository key of the member of the repository Federation on this JPD.

Members

The number of members in this repository Federation. For more information, see View Federation Members.

Status

The overall status of the repository Federation. The status is based on the most severe status among its members.

For example, if the Federation has 5 members, some of which are in Error status, the overall status of the Federation is shown as Error together with an indication of how many members have that status.

Note

The status severity order (from highest to lowest) is as follows:

  • Error

  • Delayed

  • Pending Full Sync

  • Full Sync Running

  • Disabled (the user has removed the member from the Federation)

  • Unsupported (the member is running a version of Artifactory that does not support the Federation dashboard)

  • Healthy

View Federation Members

In one of the table rows, click the rectangle displaying the number of Federation members to open a popup window with a list of the members and their current status.

Fed-dashboard_view-members2.png