{"id":16104751,"url":"https://github.com/sergeymakinen/clamav_exporter","last_synced_at":"2025-08-02T05:10:24.854Z","repository":{"id":57637972,"uuid":"429967051","full_name":"sergeymakinen/clamav_exporter","owner":"sergeymakinen","description":"Export ClamAV daemon stats via a TCP socket to Prometheus","archived":false,"fork":false,"pushed_at":"2025-03-29T12:22:10.000Z","size":139,"stargazers_count":4,"open_issues_count":2,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-26T21:12:52.214Z","etag":null,"topics":["clamav","clamd","go","golang","prometheus","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":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sergeymakinen.png","metadata":{"files":{"readme":"README.md","changelog":null,"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,"zenodo":null}},"created_at":"2021-11-20T00:05:29.000Z","updated_at":"2025-03-29T12:20:54.000Z","dependencies_parsed_at":"2024-06-20T09:29:48.164Z","dependency_job_id":"38fc13a6-53d1-404a-ba9e-5748284b0efd","html_url":"https://github.com/sergeymakinen/clamav_exporter","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/sergeymakinen/clamav_exporter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sergeymakinen%2Fclamav_exporter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sergeymakinen%2Fclamav_exporter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sergeymakinen%2Fclamav_exporter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sergeymakinen%2Fclamav_exporter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sergeymakinen","download_url":"https://codeload.github.com/sergeymakinen/clamav_exporter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sergeymakinen%2Fclamav_exporter/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268338289,"owners_count":24234540,"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","status":"online","status_checked_at":"2025-08-02T02:00:12.353Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["clamav","clamd","go","golang","prometheus","prometheus-exporter"],"created_at":"2024-10-09T19:06:12.160Z","updated_at":"2025-08-02T05:10:24.819Z","avatar_url":"https://github.com/sergeymakinen.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ClamAV Exporter\n\n[![tests](https://github.com/sergeymakinen/clamav_exporter/workflows/tests/badge.svg)](https://github.com/sergeymakinen/clamav_exporter/actions?query=workflow%3Atests)\n[![Go Reference](https://pkg.go.dev/badge/github.com/sergeymakinen/clamav_exporter.svg)](https://pkg.go.dev/github.com/sergeymakinen/clamav_exporter/v2)\n[![Go Report Card](https://goreportcard.com/badge/github.com/sergeymakinen/clamav_exporter/v2)](https://goreportcard.com/report/github.com/sergeymakinen/clamav_exporter/v2)\n[![codecov](https://codecov.io/gh/sergeymakinen/clamav_exporter/branch/main/graph/badge.svg)](https://codecov.io/gh/sergeymakinen/clamav_exporter)\n[![Docker Pulls](https://img.shields.io/docker/pulls/sergeymakinen/clamav_exporter)](https://hub.docker.com/r/sergeymakinen/clamav_exporter)\n\nExport ClamAV daemon stats via a TCP socket to Prometheus.\n\nTo run it:\n\n```bash\nmake\n./clamav_exporter [flags]\n```\n\n## Using Docker\n\nYou can deploy this exporter using\nthe [sergeymakinen/clamav_exporter](https://hub.docker.com/r/sergeymakinen/clamav_exporter) Docker image.\n\nFor example:\n\n```bash\ndocker pull sergeymakinen/clamav_exporter\n\ndocker run -d -p 9906:9906 sergeymakinen/clamav_exporter \\\n  --clamav.address tcp://clamav:3310\n```\n\n## Exported metrics\n\n| Metric                           | Meaning                                                     | Labels         \n|----------------------------------|-------------------------------------------------------------|----------------\n| clamav_up                        | Was the last scrape successful.                             |\n| clamav_version                   | The version of this ClamAV.                                 | version        \n| clamav_db_version                | Currently installed ClamAV Virus Database version.          |\n| clamav_db_timestamp_seconds      | Unix timestamp of the ClamAV Virus Database build time.     |\n| clamav_pool_state                | State of the thread pool.                                   | index, primary \n| clamav_pool_live_threads         | Number of live threads in the pool.                         | index, primary \n| clamav_pool_idle_threads         | Number of idle threads in the pool.                         | index, primary \n| clamav_pool_max_threads          | Maximum number of threads in the pool.                      | index, primary \n| clamav_pool_idle_timeout_threads | Number of idle timeout threads in the pool.                 | index, primary \n| clamav_pool_queue_length         | Number of items in the pool queue.                          | index, primary \n| clamav_pool_queue_min_wait_sec   | Minimum time a currently queued item has been waiting.      | index, primary \n| clamav_pool_queue_max_wait_sec   | Maximum time a currently queued item has been waiting.      | index, primary \n| clamav_pool_queue_avg_wait_sec   | Average time that currently queued items have been waiting. | index, primary \n| clamav_memory_heap_bytes         | Number of bytes allocated on the heap.                      |\n| clamav_memory_mmap_bytes         | Number of bytes currently allocated using mmap.             |\n| clamav_memory_used_bytes         | Number of bytes used by in-use allocations.                 |\n| clamav_memory_free_bytes         | Number of bytes in free blocks.                             |\n| clamav_memory_releasable_bytes   | Number of bytes releasable at the heap.                     |\n| clamav_memory_pools_used_bytes   | Number of bytes currently used by all pools.                |\n| clamav_memory_pools_total_bytes  | Number of bytes available to all pools.                     |\n\n### Pool state mapping\n\n| Name    | State value \n|---------|-------------\n| INVALID | 0           \n| VALID   | 1           \n| EXIT    | 2           \n\n## Flags\n\n```bash\n./clamav_exporter --help\n```\n\n* __`clamav.address`:__ ClamAV daemon socket address. Example: `tcp://127.0.0.1:3310`.\n* __`clamav.timeout`:__ ClamAV daemon socket timeout.\n* __`clamav.retries`:__ ClamAV daemon socket connect retries. `0` by default.\n* __`web.listen-address`:__ Address to listen on for web interface and telemetry.\n* __`web.telemetry-path`:__ Path under which to expose metrics.\n* __`log.level`:__ Logging level. `info` by default.\n* __`log.format`:__ Set the log target and format. Example: `logger:syslog?appname=bob\u0026local=7`\n  or `logger:stdout?json=true`.\n\n### TLS and basic authentication\n\nThe clamav_exporter supports TLS and basic authentication.\nTo use TLS and/or basic authentication, you need to pass a configuration file\nusing the `--web.config.file` parameter. The format of the file is described\n[in the exporter-toolkit repository](https://github.com/prometheus/exporter-toolkit/blob/master/docs/web-configuration.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsergeymakinen%2Fclamav_exporter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsergeymakinen%2Fclamav_exporter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsergeymakinen%2Fclamav_exporter/lists"}