The Open Distro for Elasticsearch command line interface (odfe-cli) lets you manage your ODFE cluster from the command line and automate tasks.
Currently, odfe-cli supports the Anomaly Detection and k-NN plugins, along with arbitrary REST API paths. Among other things, you can use odfe-cli create and delete detectors, start and stop them, and check k-NN statistics.
Profiles let you easily access different clusters or sign requests with different credentials. odfe-cli supports unauthenticated requests, HTTP basic signing, and IAM signing for Amazon Web Services.
This example moves a detector (
ecommerce-count-quantity) from a staging cluster to a production cluster:
odfe-cli ad get ecommerce-count-quantity --profile staging > ecommerce-count-quantity.json odfe-cli ad create ecommerce-count-quantity.json --profile production odfe-cli ad start ecommerce-count-quantity.json --profile production odfe-cli ad stop ecommerce-count-quantity --profile staging odfe-cli ad delete ecommerce-count-quantity --profile staging
Download and extract the appropriate installation package for your computer.
chmod +x ./odfe-cli
Add the command to your path:
Check that the CLI is working properly:
Profiles let you easily switch between different clusters and user credentials. To get started, run
odfe-cli profile create with the
odfe-cli profile create --auth-type basic --endpoint https://localhost:9200 --name docker-local
Alternatively, save a configuration file to
profiles: - name: docker-local endpoint: https://localhost:9200 user: admin password: foobar - name: aws endpoint: https://some-cluster.us-east-1.es.amazonaws.com aws_iam: profile: "" service: es
odfe-cli commands use the following syntax:
odfe-cli <command> <subcommand> <flags>
For example, the following command retrieves information about a detector:
odfe-cli ad get my-detector --profile docker-local
For a request to the Elasticsearch CAT API, try the following command:
odfe-cli curl get --path _cat/plugins --profile aws
--help flag to see all supported commands, subcommands, or usage for a specific command:
odfe-cli -h odfe-cli ad -h odfe-cli ad get -h