driftctl/doc/README.md

46 lines
1.4 KiB
Markdown

# User guide
### Global flags
#### Version check
By default, driftctl checks for a new version remotely. To disable this behavior, either use the flag `--no-version-check` or define the environment variable `DCTL_NO_VERSION_CHECK`.
#### Error reporting
When a crash occurs in driftctl, we do not send any crash reports.
For debugging purposes, you can add `--error-reporting` when running driftctl and crash data will be sent to us via [Sentry](https://sentry.io)
Details of reported data can be found [here](./cmd/flags/error-reporting.md)
#### Log level
By default driftctl logger only displays warning and error messages. You can set `LOG_LEVEL` environment variable to change the default level.
Valid values are : trace,debug,info,warn,error,fatal,panic.
**Note:** In trace level, terraform provider logs will be shown.
Example
```shell
$ LOG_LEVEL=debug driftctl scan
DEBU[0000] New provider library created
DEBU[0000] Found existing provider path=/home/driftctl/.driftctl/plugins/linux_amd64/terraform-provider-aws_v3.19.0_x5
DEBU[0000] Starting gRPC client alias=us-east-1
DEBU[0001] New gRPC client started alias=us-east-1
...
```
### Usage
- Commands
- Scan
- [Output format](cmd/scan/output.md)
- [Filtering resources](cmd/scan/filter.md)
- [Supported remotes](cmd/scan/supported_resources/README.md)
- [Iac sources](cmd/scan/iac_source.md)
- [Completion](cmd/completion/script.md)
## Issues
- [Known Issues & Limitations](LIMITATIONS.md)