Skip to content

Commit

Permalink
Add ML Dashboards page (#2987)
Browse files Browse the repository at this point in the history
* Add ML Dashboards page

Signed-off-by: Naarcha-AWS <naarcha@amazon.com>

* Add experimental ML Dashboard for 2.6

Signed-off-by: Naarcha-AWS <naarcha@amazon.com>

* Slight adjustment to picture order

Signed-off-by: Naarcha-AWS <naarcha@amazon.com>

* Add instructions to enable ML commons

Signed-off-by: Naarcha-AWS <naarcha@amazon.com>

* Small tweak

Signed-off-by: Naarcha-AWS <naarcha@amazon.com>

* Update _ml-commons-plugin/ml-dashboard.md

Co-authored-by: Caroline <113052567+carolxob@users.noreply.github.com>

* Add feedback

Signed-off-by: Naarcha-AWS <naarcha@amazon.com>

* Add additonal feedback

Signed-off-by: Naarcha-AWS <naarcha@amazon.com>

* Update _ml-commons-plugin/ml-dashboard.md

Co-authored-by: Nathan Bower <nbower@amazon.com>

* Send fix through

Signed-off-by: Naarcha-AWS <naarcha@amazon.com>

* Add editorial feedback

Signed-off-by: Naarcha-AWS <naarcha@amazon.com>

---------

Signed-off-by: Naarcha-AWS <naarcha@amazon.com>
Co-authored-by: Caroline <113052567+carolxob@users.noreply.github.com>
Co-authored-by: Nathan Bower <nbower@amazon.com>
  • Loading branch information
3 people authored Feb 27, 2023
1 parent 5354774 commit 77da94d
Show file tree
Hide file tree
Showing 6 changed files with 68 additions and 1 deletion.
2 changes: 1 addition & 1 deletion _ml-commons-plugin/cluster-settings.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
layout: default
title: ML Commons cluster settings
has_children: false
nav_order: 10
nav_order: 160
---

# ML Commons cluster settings
Expand Down
67 changes: 67 additions & 0 deletions _ml-commons-plugin/ml-dashboard.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
---
layout: default
title: Managing ML models in OpenSearch Dashboards
nav_order: 120
---

Released in OpenSearch 2.6, the machine learning (ML) functionality in OpenSearch Dashboards is experimental and can't be used in a production environment. For updates or to leave feedback, see the [OpenSearch Forum discussion](https://forum.opensearch.org/t/feedback-ml-commons-ml-model-health-dashboard-for-admins-experimental-release/12494).
{: .warning }

Administrators of machine learning (ML) clusters can use OpenSearch Dashboards to manage and check the status of ML models running inside a cluster. This can help ML developers provision nodes to ensure their models run efficiently.

As of OpenSearch 2.6, you can only upload models using the API. For more information about how to upload a model to your cluster, see [Upload model to OpenSearch]({{site.url}}{{site.baseurl}}/ml-commons-plugin/model-serving-framework#upload-model-to-opensearch).

## Enabling ML in Dashboards

In OpenSearch 2.6, ML functionality is disabled by default. To enable it, you need to edit the configuration in `opensearch_dashboards.yml` and then restart your cluster.

To enable the feature:

1. In your OpenSearch cluster, navigate to your Dashboards home directory; for example, in Docker, `/usr/share/opensearch-dashboards`.
2. Open your local copy of the Dashboards configuration file `opensearch_dashboards.yml`. If you don't have a copy, get one from GitHub: [`opensearch_dashboards.yml`](https://github.com/opensearch-project/OpenSearch-Dashboards/blob/main/config/opensearch_dashboards.yml).
3. Add the setting `ml_commons_dashboards.enabled:` to `opensearch_dashboards.yml`. Then, set it to `ml_commons_dashboards.enabled: true` and save the configuration file.
4. Restart the Dashboards container.
5. Verify that the feature configuration settings were created and configured properly by launching OpenSearch Dashboards. The Machine Learning section should appear under **OpenSearch plugins**.

## Accessing ML functionality in Dashboards

To access ML functionality in OpenSearch Dashboards,select **OpenSearch plugins** > **Machine Learning**.

<img src="{{site.url}}{{site.baseurl}}/images/ml/ml-dashboard/ml-dashboard.png" alt="Machine Learning section in OpenSearch dashboards">

In the Machine Learning section, you now have access to the **Deployed models** dashboard.

## Deployed models dashboard

The deployed models dashboard gives admins the ability to check the status of any models stored inside your OpenSearch cluster.

<img src="{{site.url}}{{site.baseurl}}/images/ml/ml-dashboard/deployed-models.png" alt="The deployed models view.">

The dashboard includes the following information about the model:

- **Name**: The name of the model given upon upload.
- **Status**: The number of nodes for which the model responds.
- When all nodes are responsive, the status is **Green**.
- When some nodes are responsive,the status is **Yellow**.
- When all nodes are unresponsive,the status is **Red**.
- **Model ID**: The model ID.
- **Action**: What actions you can take with the model.

As of OpenSearch 2.6, the only action available is **View Status Details**, shown in the following image.

<img src="{{site.url}}{{site.baseurl}}/images/ml/ml-dashboard/view-status-details.png" alt="You can view status details under actions.">

When selected, the Status Details panel appears.

The panel provides the following details inside the panel:

- **Model ID**
- **Model status by node**: The number of nodes for which the model is responsive.

A list of nodes gives you a view of each node the model is running on, including each node’s **Node ID** and status, as shown in the following image. This is useful if you want to use the node's **Node ID** to determine why a node is unresponsive.

<img src="{{site.url}}{{site.baseurl}}/images/ml/ml-dashboard/model-node-details.png" alt="The status of each node running the model.">

## Next steps

For more information about how to manage ML models in OpenSearch, see [Model-serving framework]({{site.url}}{{site.baseurl}}/ml-commons-plugin/model-serving-framework/).
Binary file added images/ml/ml-dashboard/deployed-models.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/ml/ml-dashboard/ml-dashboard.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/ml/ml-dashboard/model-node-details.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/ml/ml-dashboard/view-status-details.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 77da94d

Please sign in to comment.