Documentation

InfluxDB tools

This page documents an earlier version of InfluxDB OSS. InfluxDB OSS v2 is the latest stable version. See the equivalent InfluxDB v2 documentation: InfluxDB tools and integrations.

This section covers the available tools for interacting with InfluxDB.

influx command line interface (CLI)

The InfluxDB command line interface (influx) includes commands to manage many aspects of InfluxDB, including databases, organizations, users, and tasks.

influxd command

The influxd command starts and runs all the processes necessary for InfluxDB to function.

InfluxDB API client libraries

The list of client libraries for interacting with the InfluxDB API.

Influx Inspect disk shard utility

Influx Inspect is a tool designed to view detailed information about on disk shards, as well as export data from a shard to line protocol that can be inserted back into the database.

InfluxDB inch tool

Use the InfluxDB inch tool to test InfluxDB performance. Adjust metrics such as the batch size, tag values, and concurrent write streams to test how ingesting different tag cardinalities and metrics affects performance.

Graphs and dashboards

Use Chronograf or Grafana dashboards to visualize your time series data.

Tip: Use template variables in your dashboards to filter meta query results by a specified period of time (see example below).

Filter meta query results using template variables

The example below shows how to filter hosts retrieving data in the past hour.

Example
# Create a retention policy.
CREATE RETENTION POLICY "lookup" ON "prod" DURATION 1d REPLICATION 1

# Create a continuous query that groups by the tags you want to use in your template variables.
CREATE CONTINUOUS QUERY "lookupquery" ON "prod" BEGIN SELECT mean(value) as value INTO "your.system"."host_info" FROM "cpuload"
WHERE time > now() - 1h GROUP BY time(1h), host, team, status, location END;

# In your Grafana or Chronograf templates, include your tag values.
SHOW TAG VALUES FROM "your.system"."host_info" WITH KEY = “host”

Note: In Chronograf, you can also filter meta query results for a specified time range by creating a custom meta query template variable and adding a time range filter.


Was this page helpful?

Thank you for your feedback!


The future of Flux

Flux is going into maintenance mode. You can continue using it as you currently are without any changes to your code.

Read more

InfluxDB v3 enhancements and InfluxDB Clustered is now generally available

New capabilities, including faster query performance and management tooling advance the InfluxDB v3 product line. InfluxDB Clustered is now generally available.

InfluxDB v3 performance and features

The InfluxDB v3 product line has seen significant enhancements in query performance and has made new management tooling available. These enhancements include an operational dashboard to monitor the health of your InfluxDB cluster, single sign-on (SSO) support in InfluxDB Cloud Dedicated, and new management APIs for tokens and databases.

Learn about the new v3 enhancements


InfluxDB Clustered general availability

InfluxDB Clustered is now generally available and gives you the power of InfluxDB v3 in your self-managed stack.

Talk to us about InfluxDB Clustered