{"id":13819912,"url":"https://github.com/kumina/postfix_exporter","last_synced_at":"2025-05-16T07:32:28.967Z","repository":{"id":18744714,"uuid":"82308287","full_name":"kumina/postfix_exporter","owner":"kumina","description":"A Prometheus exporter for Postfix.","archived":false,"fork":false,"pushed_at":"2024-02-08T14:53:50.000Z","size":150,"stargazers_count":237,"open_issues_count":50,"forks_count":139,"subscribers_count":23,"default_branch":"master","last_synced_at":"2024-08-05T08:08:31.284Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kumina.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"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}},"created_at":"2017-02-17T15:05:22.000Z","updated_at":"2024-08-03T18:58:38.000Z","dependencies_parsed_at":"2024-01-13T16:12:24.917Z","dependency_job_id":"2c281489-82c2-4a1a-ba05-6eab0e4ba991","html_url":"https://github.com/kumina/postfix_exporter","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kumina%2Fpostfix_exporter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kumina%2Fpostfix_exporter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kumina%2Fpostfix_exporter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kumina%2Fpostfix_exporter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kumina","download_url":"https://codeload.github.com/kumina/postfix_exporter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225413743,"owners_count":17470617,"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":[],"created_at":"2024-08-04T08:00:54.857Z","updated_at":"2024-11-19T19:30:52.613Z","avatar_url":"https://github.com/kumina.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# Prometheus Postfix exporter\n\nPrometheus metrics exporter for [the Postfix mail server](http://www.postfix.org/).\nThis exporter provides histogram metrics for the size and age of messages stored in\nthe mail queue. It extracts these metrics from Postfix by connecting to\na UNIX socket under `/var/spool`. It also counts events by parsing Postfix's\nlog entries, using regular expression matching. The log entries are retrieved from\nthe systemd journal, the Docker logs, or from a log file.\n\n## Options\n\nThese options can be used when starting the `postfix_exporter`\n\n| Flag                     | Description                                          | Default                           |\n|--------------------------|------------------------------------------------------|-----------------------------------|\n| `--web.listen-address`   | Address to listen on for web interface and telemetry | `9154`                            |\n| `--web.telemetry-path`   | Path under which to expose metrics                   | `/metrics`                        |\n| `--postfix.showq_path`   | Path at which Postfix places its showq socket        | `/var/spool/postfix/public/showq` |\n| `--postfix.logfile_path` | Path where Postfix writes log entries                | `/var/log/mail.log`               |\n| `--log.unsupported`      | Log all unsupported lines                            | `false`                           |\n| `--docker.enable`        | Read from the Docker logs instead of a file          | `false`                           |\n| `--docker.container.id`  | The container to read Docker logs from               | `postfix`                         |\n| `--systemd.enable`       | Read from the systemd journal instead of file        | `false`                           |\n| `--systemd.unit`         | Name of the Postfix systemd unit                     | `postfix.service`                 |\n| `--systemd.slice`        | Name of the Postfix systemd slice.                   | `\"\"`                              |\n| `--systemd.journal_path` | Path to the systemd journal                          | `\"\"`                              |\n\n## Events from Docker\n\nPostfix servers running in a [Docker](https://www.docker.com/)\ncontainer can be monitored using the `--docker.enable` flag. The\ndefault container ID is `postfix`, but can be customized with the\n`--docker.container.id` flag.\n\nThe default is to connect to the local Docker, but this can be\ncustomized using [the `DOCKER_HOST` and\nsimilar](https://pkg.go.dev/github.com/docker/docker/client?tab=doc#NewEnvClient)\nenvironment variables.\n\n## Events from log file\n\nThe log file is tailed when processed. Rotating the log files while the exporter\nis running is OK. The path to the log file is specified with the\n`--postfix.logfile_path` flag.\n\n## Events from systemd\n\nRetrieval from the systemd journal is enabled with the `--systemd.enable` flag.\nThis overrides the log file setting.\nIt is possible to specify the unit (with `--systemd.unit`) or slice (with `--systemd.slice`).\nAdditionally, it is possible to read the journal from a directory with the `--systemd.journal_path` flag.\n\n## Build options\n\nDefault the exporter is build with systemd journal functionality (but it is disabled at default).\nBecause the systemd headers are required for building with systemd, there is\nan option to build the exporter without systemd. Use the build tag `nosystemd`.\n\n```\ngo build -tags nosystemd\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkumina%2Fpostfix_exporter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkumina%2Fpostfix_exporter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkumina%2Fpostfix_exporter/lists"}