InfluxDB Check

InfluxDB Check

InfluxDB Check validates connectivity and readiness of an InfluxDB 2.x instance (using the /health endpoint and requiring status pass).

Usage with Binary

./wait4it -type=influxdb -h=127.0.0.1 -p=8086 -t=60 -token=my-token

Usage with Docker

docker run ph4r5h4d/wait4it -type=influxdb -h=127.0.0.1 -p=8086 -t=60 -token=my-token

Environment Variables

VariableDescriptionDefault
W4IT_TYPEThe type of check (set to influxdb).-
W4IT_TIMEOUTTimeout in seconds.30
W4IT_HOSTThe host to check.127.0.0.1
W4IT_PORTThe port to check (InfluxDB default is 8086).8086
W4IT_INFLUX_TOKENAPI token for InfluxDB (optional for basic health checks).-
W4IT_INFLUX_ORGOrganization name (optional; not used by current basic health check).-
W4IT_INFLUX_BUCKETBucket name (optional; not used by current basic health check).-

Command-Line Arguments

ArgumentDescriptionDefault
-typeThe type of check (set to influxdb).-
-tTimeout in seconds.30
-hThe host to check.127.0.0.1
-pThe port to check.8086
-tokenInfluxDB API token (optional for basic health checks).-
-orgOrganization name (optional; currently unused).-
-bucketBucket name (optional; currently unused).-

Notes

  • The /health endpoint in InfluxDB 2.x is publicly accessible and does not require a token in standard OSS configurations. The checker succeeds only when the reported status is pass.
  • Token/Org/Bucket flags are accepted (for forward compatibility) but the current implementation only performs a basic instance health check and does not use Org/Bucket.
  • For full functionality (writes/queries) a valid token with appropriate permissions is required.
  • This checker targets InfluxDB 2.x. InfluxDB 1.x users can often use the generic tcp or http checkers. InfluxDB 3.x support may be added in a future release.
  • HTTPS: pass scheme via -h (e.g. -h=https://example -p=8086).

Exit Codes

CodeMeaning
0Connection / readiness successful.
1Timed out.
2Validation error or incorrect input.