Artifactory Federation Service Metrics Reference

The Artifactory Federation Service (RTFS) exposes operational metrics in OpenMetrics format, compatible with Prometheus and other monitoring systems. These metrics provide visibility into federation health, synchronization performance, and system resources.

All RTFS custom metrics use the prefix jfrtfs_. The metrics endpoint also exposes system/JVM/Actuator metrics.

Note: OpenMetrics for RTFS is available for self-hosted deployments only, not JFrog Cloud.
Since: 7.111.12, 7.117.5

Usage:

GET /rtfs/api/v1/metrics

Produces: text/plain (OpenMetrics format)

Sample Usage:

curl -H "Authorization: Bearer <ACCESS_TOKEN>" https://<ARTIFACTORY_URL>/rtfs/api/v1/metrics

Prometheus Integration (Kubernetes)

RTFS includes a ServiceMonitor for Prometheus Operator. Enable in Helm values:

serviceMonitor:
  enabled: true
  interval: 60s
  scrapeTimeout: 15s

Federation Health Metrics

Metric Name	Type	Description	Labels
`jfrtfs_members_in_status`	Gauge	Number of federation members in a specific status	`tenant`, `member_status`
`jfrtfs_members_in_status_target_sh`	Gauge	Number of self-hosted target members in error status	`tenant`, `member_status`
`jfrtfs_disabled_members`	Gauge	Count of disabled federation members	`tenant`

Member Status Values: FULL_SYNC_RUNNING, PENDING_FS, IMPORT_IN_PROGRESS, FULL_SYNC_PREPARING, FOR_REMOVAL, READ_ONLY, ERROR_GENERIC, ERROR_OUT_OF_SYNC, ERROR_INACTIVE

Synchronization Metrics

Metric Name	Type	Description	Labels
`jfrtfs_worker_lag`	Gauge	Maximum lag (ms) between oldest event and processing completion	`tenant`
`jfrtfs_worker_repo_lag`	Gauge	Per-repository lag (ms) for top lagging repositories	`tenant`, `source_and_remote_repo_keys`, `remote_member_jpd_url`
`jfrtfs_events_sent_to_remote_instance`	Counter	Total events sent to remote instances	tenant, propagation_type or error
`jfrtfs_events_received_from_remote_rtfs`	Counter	Total events received from remote RTFS	`tenant`
`jfrtfs_events_removed_in_filter`	Counter	Events filtered out during processing	`tenant`

Full Sync Metrics

Metric Name	Type	Description	Labels
`jfrtfs_full_sync_e2e_member_execution`	Timer	Full sync duration per member	`tenant`, `source_jpd_url`, `source_repo_key`, `remote_member_jpd_url`, `remote_member_repo_key`
`jfrtfs_full_sync_file_list_artifacts`	Gauge	Number of artifacts in file list	`tenant`, `source_repo_key`
`jfrtfs_full_sync_file_list_rate_artifact_per_sec`	Gauge	File list processing rate (artifacts/sec)	`tenant`, `source_repo_key`
`jfrtfs_full_sync_sort_rate_artifact_per_sec`	Gauge	File list sort rate (artifacts/sec)	`tenant`, `source_repo_key`
`jfrtfs_full_sync_artifact_events_propagation_rate`	Gauge	Event propagation rate (per ms)	`tenant`
`jfrtfs_full_sync_failure`	Counter	Full sync failure count	`tenant`, `error`

Binary Tasks Metrics

Metric Name	Type	Description	Labels
`jfrtfs_binary_tasks_total_count_by_status`	Counter	Binary tasks count by status	`tenant`, `binary_task_status`
`jfrtfs_binary_tasks_counter_pending_with_lag_per_tenant`	MultiGauge	Binary tasks pending with lag per tenant	`tenant`
`jfrtfs_binary_tasks_counter_executing_with_lag_per_tenant`	MultiGauge	Binary tasks executing with lag per tenant	`tenant`
`jfrtfs_binary_tasks_handler_execution_duration_millis`	Timer	Binary handler execution time	-

Auto-Healing Metrics

Metric Name	Type	Description	Labels
`jfrtfs_auto_healing_recovered_members`	Counter	Members recovered by auto-healing	`member_status`

Database Metrics

Metric Name	Type	Description	Labels
`jfrtfs_db_failed_query_count`	Counter	Failed database query count	`query`
`jfrtfs_event_dao_add_artifact_events`	Timer	Time to add events to database	-
`jfrtfs_worker_load_next_events`	Timer	Time to load next events batch	-
`jfrtfs_worker_send_events`	Timer	Time for worker to send events	-
`jfrtfs_single_worker_event_send_avg_time`	Timer	Average time per individual event handling	-

HTTP Client Metrics

Metric Name	Type	Description	Labels
`jfrtfs_http_client_connections_available`	Gauge	Available HTTP connections (%)	-
`jfrtfs_http_client_connections_leased`	Gauge	Leased HTTP connections (%)	-
`jfrtfs_http_client_connections_pending`	Gauge	Pending HTTP connection requests	-

Configuration Integrity Metrics

Metric Name	Type	Description	Labels
`jfrtfs_inconsistent_repo_configs_to_remote_rtfs_count`	Gauge	Repos not synced with remote members	`tenant`
`jfrtfs_inconsistent_repo_configs_to_local_rt_count`	Gauge	Repos not synced with local Artifactory	`tenant`
`jfrtfs_total_repo_configs_in_rtfs`	Gauge	Total repos configured in RTFS	`tenant`
`jfrtfs_total_repo_configs_in_rt`	Gauge	Total repos in Artifactory	`tenant`
`jfrtfs_rt_to_rt_enabled_mismatch_count`	Gauge	Enable/disable mismatch between Artifactory instances	`tenant`
`jfrtfs_rt_to_access_enabled_mismatch_count`	Gauge	Enable/disable mismatch between local Artifactory and Access	`tenant`
`jfrtfs_member_state_to_access_enabled_mismatch_count`	Gauge	Enable/disable mismatch between local member state and remote Access	`tenant`
`jfrtfs_member_state_jpd_to_jpd_config_mismatch_count`	Counter	JPDs whose config does not exist	`tenant`
`jfrtfs_member_state_jpd_to_master_token_mismatch_count`	Counter	JPDs whose master token does not exist	`tenant`

Event Processing Metrics

Metric Name	Type	Description	Labels
`jfrtfs_source_repo_event_failures`	Counter	Failures processing repo events on source member	`tenant`
`jfrtfs_target_repo_event_failures`	Counter	Failures processing repo events on target member	`Tenant, error`

Partition Management Metrics

Metric Name	Type	Description	Labels
`jfrtfs_repo_management_events_duration_between_partition_creations`	Gauge	Time between event partition creations (ms)	`tenant`
`jfrtfs_repo_management_message_blob_duration_between_partition_creations`	Gauge	Time between blob partition creations (ms)	`tenant`
`jfrtfs_sub_partition_total_count`	Gauge	Total sub-partitions count	`tenant`, `table_name`
`jfrtfs_sub_partition_pk_count`	Gauge	Sub-partitions with primary keys	`tenant`, `table_name`

Available Metric Labels

Label	Description
`tenant`	Tenant identifier
`source_jpd_url`	Source JPD URL
`source_repo_key`	Source repository key
`remote_member_jpd_url`	Remote member JPD URL
`remote_member_repo_key`	Remote member repository key
`source_and_remote_repo_keys`	Combined source and remote repo keys (format: `localRepoKey__remoteRepoKey`)
`member_status`	Member state status
`error`	Error type or phase
`query`	Database query identifier
`binary_task_status`	Binary task status
`table_name`	Database table name

Example Prometheus Queries

Monitor Federation Lag

# Alert if worker lag exceeds 5 minutes
jfrtfs_worker_lag{tenant="my-tenant"} > 300000

Track Sync Failures

# Rate of full sync failures over 1 hour
rate(jfrtfs_full_sync_failure[1h])

Check Member Health

# Members in error state
jfrtfs_members_in_status{member_status=~"ERROR.*"}

Monitor HTTP Client Pool

# Alert if available connections drop below 20%
jfrtfs_http_client_connections_available < 20

Track Disabled Members

# Count of disabled federation members per tenant
jfrtfs_disabled_members