# Grafana extension for the Chaos Toolkit Extension
[](https://img.shields.io/pypi/v/chaostoolkit-grafana.svg)
[](https://img.shields.io/pypi/l/chaostoolkit-grafana.svg)
[](https://github.com/chaostoolkit-incubator/chaostoolkit-grafana/actions/workflows/build.yaml)
[](https://codecov.io/gh/chaostoolkit-incubator/chaostoolkit-grafana)
[](https://www.python.org/)
This project should be used as a starting point to create your own
Chaos Toolkit extension.
## Install
This package requires Python 3.7+
To be used from your experiment, this package must be installed in the Python
environment where [chaostoolkit][] already lives.
[chaostoolkit]: https://github.com/chaostoolkit/chaostoolkit
```
$ pip install chaostoolkit-grafana
```
## Usage
### Sending Chaos Toolkit logs to Loki
To send the Chaos Toolkit logs to Loki endpoints, you need to enable the
according control as follows:
```json
{
"secrets": {
"grafana": {
"auth": ["admin", "admin"]
}
},
"controls": [
{
"name": "loki",
"provider": {
"type": "python",
"module": "chaosgrafana.controls.loki",
"secrets": ["grafana"],
"arguments": {
"loki_endpoint": "http://localhost:3100",
"tags": {"service": "something"}
}
}
}
]
}
```
You can set two other arguments to the control:
* `trace_id`: This must be a string which will identify this run uniquely in
your logs. If none is a provided, a random string is generated.
* `experiment_ref`: Sometimes it's useful to identify a particular experiment,
not just its run, throughout many runs. This is the string to do that. If
none is provided, a hash of the experiment is performed and used. The hash
is not stable across changes of the experiment of course.
These are particularly useful when you cpuple this extension with others like
Prometheus where you want to cross-reference between logs and metrics.
## Test
To run the tests for the project execute the following:
```
$ make tests
```
### Formatting and Linting
We use a combination of [`black`][black], [`flake8`][flake8], and [`isort`][isort]
to both lint and format this repositories code.
[black]: https://github.com/psf/black
[flake8]: https://github.com/PyCQA/flake8
[isort]: https://github.com/PyCQA/isort
Before raising a Pull Request, we recommend you run formatting against your
code with:
```console
$ make format
```
This will automatically format any code that doesn't adhere to the formatting
standards.
As some things are not picked up by the formatting, we also recommend you run:
```console
$ make lint
```
To ensure that any unused import statements/strings that are too long, etc.
are also picked up.
## Contribute
If you wish to contribute more functions to this package, you are more than
welcome to do so. Please, fork this project, make your changes following the
usual [PEP 8][pep8] code style, sprinkling with tests and submit a PR for
review.
[pep8]: https://pycodestyle.readthedocs.io/en/latest/