CLI tool to generate SLO dashboards, monitors & SLI data from OpenSLO configs. The resources are generated via terraform which can be consumed on its as as well.
Currently supported vendors/data sources.
A flow graph of SLO
to AlertPolicy
to AlertNotificationTarget
is also generated in the output dir as slo-dep-graph.png
.
Flow graphs for sample configs here (only supported for v1 onward specs).
go install github.com/OpenSLO/slogen@latest
latest golang release can be installed by using the directions here : https://github.com/udhos/update-golang#usage.
Add $GOPATH/bin
to your $PATH
.
It can be done with
export PATH=`go env GOPATH`/bin:$PATH
The pre-compiled binaries for specific platforms are also available on the release page.
ENV
variables as required by the terraform provider:slogen validate path/to/config
--apply
to just generate the files)slogen path/to/config --apply
If you remove any of the OpenSLO configs, then you should use
slogen path/to/config --apply --clean
the --clean
option will remove the generated terraform files for which the yaml config no longer exists.
set the following env variables in the bash session before running the tool
export HTTP_PROXY="http://proxyIp:proxyPort"
export HTTPS_PROXY="http://proxyIp:proxyPort"
slogen help
Usage:
slogen [paths to yaml config]... [flags]
slogen [command]
Examples:
slogen service/search.yaml
slogen ~/team-a/slo/ ~/team-b/slo ~/core/slo/login.yaml
slogen ~/team-a/slo/ -o team-a/tf
slogen ~/team-a/slo/ -o team-a/tf --apply --clean
Available sub-commands:
help Help about any command
list utility command to get additional info about your sumo resources e.g.
destroy destroy the content generated from the slogen command, equivalent to 'terraform destroy'
new create a sample config from given profile
validate config is as per OpesSLO standards and has valid values.
completion generate the autocompletion script for the specified shell
docs A brief description of your command
Flags:
-o, --out string : output directory where to create the terraform files (default "tf")
-d, --dashboardFolder : string output directory where to create the terraform files (default "slogen-tf-dashboards")
-m, --monitorFolder : string output directory where to create the terraform files (default "slogen-tf-monitors")
-i, --ignoreErrors : whether to continue validation even after encountering errors
-p, --plan : show plan output after generating the terraform config
-a, --apply : apply the generated terraform config as well
-c, --clean : clean the old tf files for which openslo config were not found in the path args
-h, --help : help for slogen
--asModule : whether to generate the terraform config as a module
--useViewHash : whether to use descriptive or hashed name for the scheduled views, hashed names ensure data for old view is not used when the query for it changes
Use "slogen [command] --help" for more information about a command. Example config with inline comment explaining the
various fields
run the below command
slogen destroy [path to out dir (default to './tf')]
It will show the resources that will be deleted and ask for confirmation before deleting them.
openslo/v1
openslo/v1alpha
Currently, the sumo UI doesn't provide a way to get the connection id's for alert notification. As a workaround, you can use the following command to get the id list.
slogen list -c
Slogen supports labels
from the OpenSLO config and applies them as tags to the native SLOs created in the vendor environment (Sumologic). In the OpenSLO spec, metadata.labels
is an optional map of keys to one or more values. Slogen supports only one value per unique key. The first value specified in the list of values will be considered.