-
Notifications
You must be signed in to change notification settings - Fork 500
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
* 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
1 parent
5354774
commit 77da94d
Showing
6 changed files
with
68 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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/). |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.