{"id":19157111,"url":"https://github.com/kinduff/firefly_iii_exporter","last_synced_at":"2025-05-07T07:47:35.534Z","repository":{"id":54668224,"uuid":"520613143","full_name":"kinduff/firefly_iii_exporter","owner":"kinduff","description":"Prometheus Exporter for Firefly III 🔥🪰","archived":false,"fork":false,"pushed_at":"2023-11-24T01:33:49.000Z","size":67,"stargazers_count":13,"open_issues_count":8,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-19T20:17:48.036Z","etag":null,"topics":["firefly-iii","grafana-dashboard","hacktoberfest","prometheus-exporter"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kinduff.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"kinduff","ko_fi":"kinduff","liberapay":"kinduff"}},"created_at":"2022-08-02T18:44:57.000Z","updated_at":"2025-03-10T00:05:41.000Z","dependencies_parsed_at":"2024-06-20T22:06:54.299Z","dependency_job_id":null,"html_url":"https://github.com/kinduff/firefly_iii_exporter","commit_stats":{"total_commits":8,"total_committers":1,"mean_commits":8.0,"dds":0.0,"last_synced_commit":"14cba1b46971aff0588ef504c95623dcac119a78"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kinduff%2Ffirefly_iii_exporter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kinduff%2Ffirefly_iii_exporter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kinduff%2Ffirefly_iii_exporter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kinduff%2Ffirefly_iii_exporter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kinduff","download_url":"https://codeload.github.com/kinduff/firefly_iii_exporter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252839096,"owners_count":21812083,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["firefly-iii","grafana-dashboard","hacktoberfest","prometheus-exporter"],"created_at":"2024-11-09T08:38:22.327Z","updated_at":"2025-05-07T07:47:35.507Z","avatar_url":"https://github.com/kinduff.png","language":"Go","funding_links":["https://github.com/sponsors/kinduff","https://ko-fi.com/kinduff","https://liberapay.com/kinduff"],"categories":[],"sub_categories":[],"readme":"# Firefly III Exporter\n\n[![GitHub release (latest by date)](https://img.shields.io/github/v/release/kinduff/firefly_iii_exporter?)][releases]\n[![Go Reference](https://pkg.go.dev/badge/github.com/kinduff/firefly_iii_exporter.svg?)][godoc]\n[![Go Report Card](https://goreportcard.com/badge/github.com/kinduff/firefly_iii_exporter?)][goreport]\n[![CodeFactor](https://www.codefactor.io/repository/github/kinduff/firefly_iii_exporter/badge)][codefactor]\n[![Test / Build](https://github.com/kinduff/firefly_iii_exporter/actions/workflows/ci.yml/badge.svg?branch=master)][workflow-c]\n[![Docker Pulls](https://img.shields.io/docker/pulls/kinduff/firefly_iii_exporter.svg?)][dockerhub]\n[![GitHub all releases](https://img.shields.io/github/downloads/kinduff/firefly_iii_exporter/total?)][releases]\n\nThis is a Prometheus exporter for [Firefly III](https://www.firefly-iii.org). It provides statistics from accounts, transactions, and categories.\n\nAn example of the output of this exporter can be found [here](extra/metrics_example.txt).\n\n## Feature list\n\nThis is a work in progress, please feel free to contribute with additional statistics by extending this exporting and submitting a Pull Request.\n\n- [x]  Accounts\n  - [x]  Count\n  - [x]  Balances\n- [x]  Transations\n  - [x]  Count\n- [x] Categories\n  - [x] Count\n  - [x] Transactions\n- [ ] Bills\n- [ ] Piggy banks\n- [ ] Budgets\n- [ ] Recurrences\n\n## Prerequisites\n\nOne of the two, depending on your running method.\n\n* [Go][go] `\u003e= 1.16`\n* [Docker][docker]\n\n## Running this exporter\n\nSee [Configuration][configuration] in order to set the necessary params to run the exporter.\n\n### Using a binary\n\nYou can download the latest version of the binary built for your architecture [here][releases].\n\n### Using Docker\n\nThe exporter is also available as a Docker image in [DockerHub][dockerhub] and [Github CR][ghcr]. You can run it using the following example and pass the configuration as environment variables:\n\n```shell\n$ docker run \\\n  --name firefly_iii_exporter \\\n  -p 4002:4002 \\\n  -e BASE_URL=\u003curl-to-firefly-iii\u003e \\\n  -e API_KEY=\u003cpersonal-access-token\u003e \\\n  kinduff/firefly_iii_exporter:latest\n```\n\nAlternative, you can use `ghcr.io/kinduff/firefly_iii_exporter` if you want to use the Github Container Registry.\n\n### Using the source\n\nOptionally, you can download and build it from the sources. You have to retrieve the project sources by using one of the following way:\n\n```shell\n$ go get -u github.com/kinduff/firefly_iii_exporter\n# or\n$ git clone https://github.com/kinduff/firefly_iii_exporter.git\n```\n\nInstall the needed vendors:\n\n```shell\n$ GO111MODULE=on go mod vendor\n```\n\nThen, build the binary:\n\n```shell\n$ go build -o firefly_iii_exporter .\n```\n\n## Configuration\n\nYou can use both environment variables or parameters in both the binary or the docker image. If you wish to use parameters, simply invoke the same environment variable but in downcase, or use the flag `--help` for more information.\n\n| Environment variable | Description                                                  | Default | Required |\n| -------------------- | ------------------------------------------------------------ | ------- | -------- |\n| `BASE_URL`           | URL path including protocol to the Firefly III instance      |         | Yes      |\n| `API_KEY`            | Your Personal Access Token                                   |         | Yes      |\n| `HTTP_PORT`          | The port the exporter will be running the HTTP server        | 4002    |          |\n| `SCRAPE_INTERVAL`    | Time in natural format to scrap statistics from the instance | `30s`   |          |\n\n## Available Prometheus metrics\n\n| Metric name                                   | Description                                          |\n| --------------------------------------------- | ---------------------------------------------------- |\n| `firefly_iii_account_balance_metrics`         | Current balance of each of the available accounts    |\n| `firefly_iii_account_transactions_metrics`    | Total transactions of each of the available accounts |\n| `firefly_iii_accounts_metrics`                | Total accounts available                             |\n| `firefly_iii_transaction_by_category_metrics` | Total transactions per available category            |\n| `firefly_iii_transactions_metrics`            | Total transactions available                         |\n\n[codefactor]: https://www.codefactor.io/repository/github/kinduff/firefly_iii_exporter\n[configuration]: #configuration\n[docker]: https://docs.docker.com\n[dockerhub]: https://hub.docker.com/r/kinduff/firefly_iii_exporter\n[ghcr]: #ghcr\n[go]: https://golang.org\n[godoc]: https://pkg.go.dev/github.com/kinduff/firefly_iii_exporter\n[goreport]: https://goreportcard.com/report/github.com/kinduff/firefly_iii_exporter\n[releases]: https://github.com/kinduff/firefly_iii_exporter/releases\n[steam-api]: https://steamcommunity.com/dev/apikey\n[workflow-c]: https://github.com/kinduff/firefly_iii_exporter/actions/workflows/ci.yml\n[metrics_example]: extra/metrics_example.txt\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkinduff%2Ffirefly_iii_exporter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkinduff%2Ffirefly_iii_exporter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkinduff%2Ffirefly_iii_exporter/lists"}