# Semaphore-exporter

Semaphore-exporter is a self-hosted development app. Prometheus exporter for Semaphore (semaphoreui.com), which has no native /metrics endpoint. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2571/semaphore-exporter

## Description

Prometheus exporter for Semaphore (semaphoreui.com), which has no native /metrics endpoint. Read-only: only GETs from Semaphore's API. Exports semaphore_task_running_seconds for every non-terminal task, so a task stuck running for hours shows up, not just failed/succeeded ones.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

36/100 (Low), based on 4 of 4 factors.
- Maintained: 69 (last commit 65 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 10 (16 GB minimum RAM)

## Links

- Docker Hub: https://hub.docker.com/r/louij2/semaphore-exporter
- GitHub: https://github.com/louij2/semaphore-exporter
- Unraid: https://ca.unraid.net/apps/semaphore-exporter-0el7j1h0c39ant?q=semaphore-exporter

## Common questions

### Can the exporter start, stop, or modify Semaphore tasks?

No. It is read-only and only performs GET requests against Semaphore's API, never changing a task or template.

### Which endpoint and port should Prometheus scrape?

Run the Docker container with port 9825 mapped and scrape /metrics on that port, for example :9825/metrics.

### What environment variables must be set when starting the container?

Set SEMAPHORE_URL to the Semaphore base URL and SEMAPHORE_API_TOKEN to the API token used for API access.

### Which metric helps identify tasks stuck in running state?

It exports semaphore_task_running_seconds for every non-terminal task, so a task stuck running for hours is visible in Prometheus.

### Does frequent Prometheus scraping hammer Semaphore's API?

The exporter polls Semaphore's REST API and caches the results briefly so a scrape storm cannot hammer it.

## Alternatives

- Azure DevOps: Continuous Delivery Services for teams to share code, track work, and ship software – for any language, all in a single package.
- GitLab: GitLab is a self-hosted Git repository server and software delivery platform for individuals and teams to privately plan, version, build, t…
- Jenkins: Jenkins is a fork of Hudson and is a continuous build system for software projects.
- semaphore: Semaphore is a modern web interface for managing DevOps tools such as Ansible, Terraform, OpenTofu, and PowerShell.

---
Source: Our Local Host (https://ourlocalhost.com/app/2571/semaphore-exporter), the self-hosted and open-source app directory.
