influxdata / influxdata/docs-v2
influx_inspect cmd creates _series dir in /var/lib/influxdb if it doesnt exist.
- 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