Skip to content

JFrog Artifactory Prometheus Exporter written in Go

License

Notifications You must be signed in to change notification settings

lbpdt/artifactory_exporter

 
 

Repository files navigation

JFrog Artifactory Exporter

Go Build Publish Image Go Report Card

A Prometheus exporter for JFrog Artifactory stats.

Note

This exporter is under development and more metrics will be added later. Tested on Artifactory Commercial, Enterprise and OSS version 6.x and 7.x.

Authentication

The Artifactory exporter requires admin user and it supports multiple means of authentication. The following methods are supported:

  • Basic Auth
  • Bearer Token

Basic Auth

Basic auth may be used by setting ARTI_USERNAME and ARTI_PASSWORD environment variables.

Bearer Token

Artifactory access tokens may be used via the Authorization header by setting ARTI_ACCESS_TOKEN environment variable.

Usage

Binary

Download the binary for your operation system from release page and run it:

$ ./artifactory_exporter <flags>

Docker

Set the credentials in env_file_name and you can deploy this exporter using the peimanja/artifactory_exporter Docker image:

$ docker run --env-file=env_file_name -p 9531:9531 peimanja/artifactory_exporter:latest <flags>

Docker Compose

Running the exporter against an Artifactory instance with millions of artifacts will cause performance issues in case Prometheus will scrape too often.

To avoid such situations you can run nginx in front of the exporter and use it as a cache. The Artifactory responses will be cached in nginx and kept valid for PROXY_CACHE_VALID seconds. After that time any new request from Prometheus will re-request metrics from Artifactory and store again in the nginx cache.

Set the credentials in an environment file as described in the Docker section and store the file as .env next to docker-compose.yml and run the following command:

docker-compose up -d

Install with Helm

Helm must be installed to use the charts. Please refer to Helm's documentation to get started.

Source code for the exporter helm chart can be found here peimanja/helm-charts

Once Helm is set up properly, add the repo as follows:

Prerequisites

  • Kubernetes 1.8+ with Beta APIs enabled

Add Repo

helm repo add peimanja https://peimanja.github.io/helm-charts
helm repo update

See helm repo for command documentation.

Configuration

See Customizing the Chart Before Installing. To see all configurable options with detailed comments, visit the chart's values.yaml, or run these configuration commands:

# Helm 3
helm show values peimanja/prometheus-artifactory-exporter

Set your values in myvals.yaml:

artifactory:
  url: http://artifactory:8081/artifactory
  accessToken: "xxxxxxxxxxxxxxxxxxxx"
  existingSecret: false

options:
  logLevel: info
  logFormat: logfmt
  telemetryPath: /metrics
  verifySSL: false
  timeout: 5s

Install Chart

# Helm 3
helm install -f myvals.yaml [RELEASE_NAME] peimanja/prometheus-artifactory-exporter

See configuration below.

See helm install for command documentation.

Flags

$  docker run peimanja/artifactory_exporter:latest -h
usage: main --artifactory.user=ARTIFACTORY.USER [<flags>]

Flags:
  -h, --help                    Show context-sensitive help (also try --help-long and --help-man).
      --web.listen-address=":9531"
                                Address to listen on for web interface and telemetry.
      --web.telemetry-path="/metrics"
                                Path under which to expose metrics.
      --artifactory.scrape-uri="http://localhost:8081/artifactory"
                                URI on which to scrape JFrog Artifactory.
      --artifactory.ssl-verify  Flag that enables SSL certificate verification for the scrape URI
      --artifactory.timeout=5s  Timeout for trying to get stats from JFrog Artifactory.
      --log.level=info          Only log messages with the given severity or above. One of: [debug, info, warn, error]
      --log.format=logfmt       Output format of log messages. One of: [logfmt, json]
      --version                 Show application version.
Flag / Environment Variable Required Default Description
web.listen-address
WEB_LISTEN_ADDR
No :9531 Address to listen on for web interface and telemetry.
web.telemetry-path
WEB_TELEMETRY_PATH
No /metrics Path under which to expose metrics.
artifactory.scrape-uri
ARTI_SCRAPE_URI
No http://localhost:8081/artifactory URI on which to scrape JFrog Artifactory.
artifactory.ssl-verify
ARTI_SSL_VERIFY
No true Flag that enables SSL certificate verification for the scrape URI.
artifactory.timeout
ARTI_TIMEOUT
No 5s Timeout for trying to get stats from JFrog Artifactory.
log.level No info Only log messages with the given severity or above. One of: [debug, info, warn, error].
log.format No logfmt Output format of log messages. One of: [logfmt, json].
ARTI_USERNAME *No User to access Artifactory
ARTI_PASSWORD *No Password of the user accessing the Artifactory
ARTI_ACCESS_TOKEN *No Access token for accessing the Artifactory
  • Either ARTI_USERNAME and ARTI_PASSWORD or ARTI_ACCESS_TOKEN environment variables has to be set.

Metrics

Some metrics are not available with Artifactory OSS license. The exporter returns the following metrics:

Metric Description Labels OSS support
artifactory_up Was the last scrape of Artifactory successful.
artifactory_exporter_build_info Exporter build information. version, revision, branch, goversion
artifactory_exporter_total_scrapes Current total artifactory scrapes.
artifactory_exporter_total_api_errors Current total Artifactory API errors when scraping for stats.
artifactory_exporter_json_parse_failures Number of errors while parsing Json.
artifactory_replication_enabled Replication status for an Artifactory repository (1 = enabled). name, type, cron_exp
artifactory_security_groups Number of Artifactory groups.
artifactory_security_users Number of Artifactory users for each realm. realm
artifactory_storage_artifacts Total artifacts count stored in Artifactory.
artifactory_storage_artifacts_size_bytes Total artifacts Size stored in Artifactory in bytes.
artifactory_storage_binaries Total binaries count stored in Artifactory.
artifactory_storage_binaries_size_bytes Total binaries Size stored in Artifactory in bytes.
artifactory_storage_filestore_bytes Total space in the file store in bytes. storage_dir, storage_type
artifactory_storage_filestore_used_bytes Space used in the file store in bytes. storage_dir, storage_type
artifactory_storage_filestore_free_bytes Space free in the file store in bytes. storage_dir, storage_type
artifactory_storage_repo_used_bytes Space used by an Artifactory repository in bytes. name, package_type, type
artifactory_storage_repo_folders Number of folders in an Artifactory repository. name, package_type, type
artifactory_storage_repo_files Number files in an Artifactory repository. name, package_type, type
artifactory_storage_repo_items Number Items in an Artifactory repository. name, package_type, type
artifactory_artifacts_created_1m Number of artifacts created in the repo (last 1 minute). name, package_type, type
artifactory_artifacts_created_5m Number of artifacts created in the repo (last 5 minutes). name, package_type, type
artifactory_artifacts_created_15m Number of artifacts created in the repo (last 15 minutes). name, package_type, type
artifactory_artifacts_downloaded_1m Number of artifacts downloaded from the repository (last 1 minute). name, package_type, type
artifactory_artifacts_downloaded_5m Number of artifacts downloaded from the repository (last 5 minutes). name, package_type, type
artifactory_artifacts_downloaded_15m Number of artifacts downloaded from the repository (last 15 minute). name, package_type, type
artifactory_system_healthy Is Artifactory working properly (1 = healthy).
artifactory_system_license License type and expiry as labels, seconds to expiration as value type, licensed_to, expires
artifactory_system_version Version and revision of Artifactory as labels. version, revision

Grafana Dashboard

Dashboard can be found here.

Grafana dDashboard Grafana dDashboard

About

JFrog Artifactory Prometheus Exporter written in Go

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 98.4%
  • Dockerfile 1.6%