This section outlines the custom metrics collected by the standalone Artifactory Federation service.
Metrics Granularity
Due to potential performance overhead, custom metrics are collected by default at the tenant level. However, selected metrics can collect data at the repo key or member level if predefined thresholds are exceeded.
Warning
These granular metrics should be implemented and used with caution due to their potential performance impact.
Available Metrics
Custom metrics for the Artifactory Federation service are divided into the following categories:
Lag Metrics
The Artifactory Federation service includes the lag metrics described in the table below.
Name | Description | Type | Granularity |
|---|---|---|---|
|
The lag time when transferring events to the remote member. The calculation: Lag = Current time - Trailing baseline time Trailing baseline time =
| Gauge | Per tenant |
| The lag of the Artifactory Federation queue (in milliseconds). | Gauge | Per tenant |
| The number of events that remain to be handled to overcome the lag. | Counter | Per tenant |
Event Metrics
The Artifactory Federation service includes the event metrics described in the table below.
Name | Description | Type | Granularity |
|---|---|---|---|
| The total number of events received by the Federation service from Artifactory. | Counter | Per tenant |
| The total number of deduped (deduplicated) events filtered out of the queue. For example, imagine an artifact with two events in the queue. In the first event, the artifact is updated and in the second it is deleted. The first event is removed from the queue to streamline the process, and only the deletion event is sent to the remote member. | Counter | Per tenant |
| The total number of events received by the tenant from remote members. | Counter | Per tenant |
| The number of events sent from the tenant to remote members. NoteThis metric includes both members running the Artifactory Federation service and members running the legacy Federation service. | Counter | Per tenant |
| Tracks the duration between the creation of partitions in the | Gauge | Per Tenant |
| Track the duration between the creation of partitions in the | Gauge | Per Tenant |
Full Sync Metrics
The Artifactory Federation service includes the Full Sync metrics described in the table below.
Name | Description | Type | Granularity |
|---|---|---|---|
| The total number of Full Sync operations that have been executed. | Counter | Per Tenant / Member |
| The total end-to-end duration of all Full Sync operations. Configure the threshold using the property: (default=30 min.) | Timer | Per Tenant / Member (per member if a single Full Sync operation exceeds the threshold) |
| The file list sort rate (in milliseconds). The rate is calculated by dividing the number of artifacts in the file list by the total sort time. Configure the threshold using the property:
(default = 10000 ms) | Gauge | Global |
| The artifact event propagation rate in milliseconds. The rate is calculated by dividing the number of artifact events sent to the remote member by the total amount of time needed to propagate them (i.e. elapsed time between sending events and receiving an OK response from the remote member). | Gauge | Global |
| The total number of artifacts in the file list of the local member. Configure the threshold using the property:
(default = 1 million) | Counter | Per Tenant / Member (if the threshold is exceeded) |
| The file list compilation rate in milliseconds. The rate is calculated by dividing the number of artifacts in the file list by the total amount of time to get the file list. Configure the threshold using the property:
(default = 5 sec.) | Gauge | Global |
Member State Metrics
The Artifactory Federation service includes the member state metrics described in the table below.
Name | Description | Type | Granularity |
|---|---|---|---|
| The total number of recovery operations that have been performed using the auto-healing process. For example, recovery performed once on 5 members is equivalent to recovery being performed on the same member 5 times. | Counter | Global |
| The current number of members in the following states:
Disabled members are filtered out. | Gauge | Per Tenant |
| The total number of members disabled locally by the user. | Counter | Per Tenant |
Miscellaneous Metrics
The Artifactory Federation service includes the additional metrics described in the table below.
Name | Description | Type | Granularity |
|---|---|---|---|
| The total number of HTTP errors between Artifactory and the Artifactory Federation service. | Counter | Global |
| The total number of failed database queries in the Artifactory Federation service. | Counter | Global |
| The total number of failed database queries. | Counter | Global |
| The amount of time that was needed to execute a specific query. | Counter | Depends on query |
| The percentage of available HTTP client connections. | Gauge | Global |
| The percentage of leased HTTP client connections. | Gauge | Global |
| The number of pending HTTP client connections. | Counter | Global |