Go to file
David Randall 25f25810fc
Merge pull request #159 from NiceGuyIT/issue-158
Fix #158: collect_fake_json.sh
2023-10-25 04:37:22 -04:00
.circleci Update build 2023-10-25 10:30:01 +02:00
.github Update common Prometheus files 2023-10-02 17:50:16 +00:00
gentoo/app-metrics/smartctl_exporter Update build 2023-10-25 10:30:01 +02:00
systemd systemd service 2019-08-15 00:04:32 +03:00
.gitignore Fix Dockerfile (#53) 2022-08-08 17:03:53 +02:00
.golangci.yml Update linting 2023-08-12 10:34:18 +02:00
.promu.yml Update build 2023-10-25 10:30:01 +02:00
.yamllint Update common Prometheus files 2023-08-12 17:49:21 +00:00
CHANGELOG.md Release 0.11.0 2023-08-27 12:49:32 +03:00
CODE_OF_CONDUCT.md Update common Prometheus files 2022-06-17 19:51:12 +00:00
Dockerfile Reverts prometheus-community/smartctl_exporter#150 2023-08-26 06:55:06 -04:00
EXAMPLE.md Added disk form_factor meta label 2022-10-17 14:28:05 +07:00
LICENSE Update LICENSE 2023-03-03 10:01:24 +01:00
MAINTAINERS.md Update build 2023-10-25 10:30:01 +02:00
Makefile Reverts prometheus-community/smartctl_exporter#150 2023-08-26 06:55:06 -04:00
Makefile.common Update common Prometheus files 2023-09-02 17:50:53 +00:00
README.md Update README.md 2023-08-16 16:17:51 +08:00
SECURITY.md Update common Prometheus files 2022-06-17 19:51:12 +00:00
VERSION Release 0.11.0 2023-08-27 12:49:32 +03:00
collect_fake_json.sh Fix #158: collect_fake_json.sh 2023-08-26 10:33:33 -04:00
device_filter.go Add device filtering 2022-12-09 21:12:08 +01:00
device_filter_test.go Add device filtering 2022-12-09 21:12:08 +01:00
gjsonext.go Release 0.7.0 (#50) 2022-08-05 03:37:13 +02:00
go.mod Update build 2023-10-25 10:30:01 +02:00
go.sum Update build 2023-10-25 10:30:01 +02:00
main.go Merge pull request #129 from Knalltuete5000/devices_count 2023-08-15 19:17:09 -04:00
metrics.go * split block mine to mineBlockSize() from mineCapacity() 2023-08-26 21:28:31 +03:00
readjson.go Merge pull request #141 from k0ste/help2 2023-08-10 08:47:22 -04:00
smartctl.go * split block mine to mineBlockSize() from mineCapacity() 2023-08-26 21:28:31 +03:00
smartctlinfo.go Avoid running mineVersion when the SMARTctlInfo struct is not ready 2022-11-06 11:56:43 +01:00

README.md

CircleCI Container Repository on Quay

smartctl_exporter

Export smartctl statistics to prometheus

Example output you can show in EXAMPLE.md

Need more?

If you need additional metrics - contact me :) Create a feature request, describe the metric that you would like to have and attach exported from smartctl json file

Requirements

smartmontools >= 7.0, because export to json released in 7.0

Configuration

Command line options

The exporter will scan the system for available devices if no --smartctl.device flags are used.

usage: smartctl_exporter [<flags>]

Flags:
  -h, --help                   Show context-sensitive help (also try --help-long and --help-man).
      --smartctl.path="/usr/sbin/smartctl"  
                               The path to the smartctl binary
      --smartctl.interval=60s  The interval between smartctl polls
      --smartctl.rescan=10m    The interval between rescanning for new/disappeared devices. If the interval is smaller than 1s no
                               rescanning takes place. If any devices are configured with smartctl.device also no rescanning takes
                               place.
      --smartctl.device=SMARTCTL.DEVICE ...  
                               The device to monitor (repeatable)
      --smartctl.device-exclude=""
                               Regexp of devices to exclude from automatic scanning. (mutually exclusive to
                               device-include)
      --smartctl.device-include=""
                               Regexp of devices to include in automatic scanning. (mutually exclusive to
                               device-exclude)
      --web.telemetry-path="/metrics"  
                               Path under which to expose metrics
      --web.systemd-socket     Use systemd socket activation listeners instead of port listeners (Linux only).
      --web.listen-address=:9633 ...
                               Addresses on which to expose metrics and web interface. Repeatable for multiple
                               addresses.
      --web.config.file=""     [EXPERIMENTAL] Path to configuration file that can enable TLS or authentication.
      --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.

TLS and basic authentication

This exporter supports TLS and basic authentication.

To use TLS and/or basic authentication, you need to pass a configuration file using the --web.config.file parameter. The format of the file is described in the exporter-toolkit repository.

Example of running in Docker

Minimal functional docker-compose.yml:

version: "3"

services:
  smartctl-exporter:
    image: prometheuscommunity/smartctl-exporter
    privileged: true
    user: root
    ports:
      - "9633:9633"