The OpenSearch Alerting Dashboards plugin lets you manage your OpenSearch Alerting plugin to monitor your data and send notifications when certain criteria are met---all from OpenSearch Dashboards.
- Create and schedule monitors, which run period queries against data in Opensearch.
- Evaluate query results against triggers to see if they meet certain criteria.
- If trigger criteria are met, generate alerts and perform actions (e.g. post a message in a Slack channel).
Please see our documentation.
-
Download OpenSearch for the version that matches the OpenSearch Dashboard version specified in package.json.
-
Download and install the appropriate OpenSearch Alerting plugin.
-
Download the OpenSearch-Dashboards source code for the version specified in package.json you want to set up.
See the OpenSearch Dashboards developer guide for more instructions on setting up your development environment.
-
Change your node version to the version specified in
.node-version
inside the OpenSearch-Dashboards root directory. -
cd into the
plugins
directory of the OpenSearch-Dashboards source code directory. -
Check out this package from version control into the
plugins
directory. -
Run
yarn osd bootstrap
insideOpensearch-Dashboards/plugins/alerting-dashboards-plugin
.
Ultimately, your directory structure should look like this:
.
βββ OpenSearch-Dashboards
β βββ plugins
β βββ alerting-dashboards-plugin
To build the plugin's distributable zip simply run yarn build
.
Example output: ./build/opendistroAlertingDashboards-1.0.0.0.zip
-
yarn start
- Starts OpenSearch-Dashboards and includes this plugin. OpenSearch-Dashboards will be available on
localhost:5601
. - Please run in the OpenSearch-Dashboards root directory
- You must have OpenSearch running with the Alerting plugin
- Starts OpenSearch-Dashboards and includes this plugin. OpenSearch-Dashboards will be available on
There are unit/stubbed integration tests and Cypress e2e/integration tests.
-
yarn test:jest
- Runs the plugin unit tests.
-
yarn run cypress open
- Opens the Cypress test runner.
-
yarn run cypress run
- Runs all Cypress tests headlessly in the Electron browser.
To run the Cypress tests, you must have both OpenSearch and OpenSearch-Dashboards running with the Alerting plugin.
If you are running Cypress tests with OpenSearch-Dashboards development server, pass these 2 options to yarn start
:
--no-base-path
: opt out the BasePathProxy.--no-watch
: make sure your server is not restarted.
- Refer to CONTRIBUTING.md.
- Since this is an OpenSearch-Dashboards plugin, it can be useful to review the OpenSearch Dashboards contributing guide.
This code is licensed under the Apache 2.0 License.
Copyright 2019 Amazon.com, Inc. or its affiliates. All Rights Reserved.