influxdata / influxdata/docs-v2

influx_inspect cmd creates _series dir in /var/lib/influxdb if it doesnt exist.

Open Beginner friendly
#4,970 2 comments 0 reactions 0 assignees View on GitHub
Enterprise 1.x product:v1-enterprise
Dominant language
JavaScript
Stars
82
Forks
326
Avg merge
1d 1h
Merged PRs (30d)
82

Description

_influx_inspect creates /var/lib/influxdb/data/_series dir if it does not exist already_

The doc should have a big warning near the top indicating that if you run this and the _series dir does not already exist within the /ver/lib/influxdb/data dir) the outcome may be less than desired. run the cmd as the influxdb user to avoid the problem.

if you run `influx_inspect reporttsi -db-path /var/lib/influxdb/data -top 20`
and there is no /var/lib/influxdb/data/_series dir, the cmd causes one to be created but with the ownership of the user executing influx_inspect.

That creates a problem next time influxd starts.
`2023-06-06T11:46:02.053361+00:00 localhost influxd[10989]: run: open server: open tsdb store: mkdir /var/lib/influxdb/data/_series/ _series: permission denied `

This issue was found in several influx 1.8 enterprise clusters where influx_inspect cmd was being used to help to pinpoint measurement with un-constrained series cardinality.

##### Relevant URLs
- https://docs.influxdata.com/influxdb/v1.8/tools/influx_inspect/

Contributor guide

No contributing guide indexed for this repository

Research direction

Start with the influx_inspect documentation at https://docs.influxdata.com/influxdb/v1.8/tools/influx_inspect/ and review the reporttsi command usage. Add a prominent warning near the top covering creation and ownership of the _series directory, recommend running the command as the influxdb user, and ensure the documented outcome matches the reported startup failure.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
1-3 hours
Activity status
Active
Clarity
Clearly specified
Newbie friendliness
82/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.