Skip to content

Commit

Permalink
[DOC] Create Dashboard list extensions documentation (#3443)
Browse files Browse the repository at this point in the history
* Add documentation for Dashboard plugin list extension feature
---------
Signed-off-by: vagimeli <[email protected]>
Signed-off-by: Melissa Vagi <[email protected]>
Co-authored-by: kolchfa-aws <[email protected]>
Co-authored-by: Nathan Bower <[email protected]>
  • Loading branch information
vagimeli authored Apr 27, 2023
1 parent 546491c commit 93ef1c5
Show file tree
Hide file tree
Showing 5 changed files with 59 additions and 31 deletions.
43 changes: 43 additions & 0 deletions _dashboards/dashboard/plugins-dashboards.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
---
layout: default
title: Integrating plugins into a dashboard
parent: Observability
nav_order: 5
---

# Integrating plugins into a dashboard

Observability is a collection of plugins and applications that let you visualize data-driven events by using [Piped Processing Language]({{site.url}}{{site.baseurl}}/search-plugins/sql/ppl/index/) to explore, discover, and query data stored in OpenSearch. Observability provides a unified experience for collecting and monitoring metrics, logs, and traces from common data sources. With data collection and monitoring in one place, you have full-stack, end-to-end observability of your entire infrastructure.

As of OpenSearch 2.7, you can manage your observability plugins with **Observability Dashboards** or **Dashboard** instead of the plugins page. This feature provides you:

- **Instant access to installed plugins:** The dashboard displays all installed plugins in one place.
- **Improved efficiency:** With a list of plugins readily available from a dashboard, you can enable, disable, update, or remove plugins in the OpenSearch Dashboards UI.
- **Better troubleshooting:** Viewing a list of plugins from a dashboard can help you quickly identify which plugins may be causing a problem.
- **Enhanced security:** With a list of plugins readily available from a dashboard, you can easily see if any outdated or vulnerable plugins are present and then quickly remove or update them, minimizing or avoiding security risks.
- **Improved website performance:** Viewing a list of plugins from a dashboard can help you identify any plugins that may be slowing down your website or causing performance issues.

Get familiar with the basics of managing plugins from the Dashboard app in less than 20 seconds in the following video.

![Demo of using Dashboard to view a list of observability plugins](https://user-images.githubusercontent.com/105296784/234345611-50beb9a6-6118-449a-b015-b9f9e90b525e.gif)

## Viewing a list of installed plugins

To view a list of installed plugins from the Dashboard app, follow these steps:

1. From the OpenSearch Dashboards main menu, select **Dashboard**.
2. View the list of items and select your plugin. Plugins are categorized automatically as the Observability Dashboard data type, which you can filter in order to concentrate on just what you want to see.

## Adding and removing plugins

To add a plugin from the Dashboard app, follow these steps:

1. From the OpenSearch Dashboards main menu, select **Dashboard**.
2. In the **Dashboards** window, select **Create** > **Dashboard**.
3. In the **Create operational panel** window, enter a name in the **Name** field and then select **Create**. The plugin is added to both the Observability app and the Dashboard app.

You can remove a plugin from the Dashboard app by selecting the edit icon under the **Actions** column and then selecting **Delete**.

## Staying updated about OpenSearch Dashboards plugins

The [OpenSearch plugins repository](https://github.com/opensearch-project/opensearch-plugins) on GitHub is a great way to keep track of and contribute to tasks, features, enhancements, and bugs. The OpenSearch Project team welcomes your input.
41 changes: 13 additions & 28 deletions _install-and-configure/install-dashboards/plugins.md
Original file line number Diff line number Diff line change
@@ -1,24 +1,19 @@
---
layout: default
title: OpenSearch Dashboards plugins
parent: Installing OpenSearch Dashboards
nav_order: 50
title: Managing OpenSearch Dashboards plugins
nav_order: 100
redirect_from:
- /dashboards/install/plugins
- /install-and-configure/install-dashboards/plugins/
---

# Standalone plugin install
# Managing OpenSearch Dashboards plugins

If you don't want to use the all-in-one installation options, you can install the various plugins for OpenSearch Dashboards individually.
OpenSearch Dashboards provides a command line tool called `opensearch-plugin` for managing plugins. This tool allows you to:

---

#### Table of contents
1. TOC
{:toc}


---
- List installed plugins.
- Install plugins.
- Remove an installed plugin.

## Plugin compatibility

Expand All @@ -29,7 +24,7 @@ Major, minor, and patch plugin versions must match OpenSearch major, minor, and

- A compatible OpenSearch cluster
- The corresponding OpenSearch plugins [installed on that cluster]({{site.url}}{{site.baseurl}}/opensearch/install/plugins/)
- The corresponding version of [OpenSearch Dashboards]({{site.url}}{{site.baseurl}}/) (for example, OpenSearch Dashboards 2.1.0 works with OpenSearch 2.1.0)
- The corresponding version of [OpenSearch Dashboards]({{site.url}}{{site.baseurl}}/) (for example, OpenSearch Dashboards 2.3.0 works with OpenSearch 2.3.0)

## Available plugins

Expand All @@ -53,7 +48,7 @@ The following table lists available OpenSearch Dashboards plugins.

## Install

Navigate to the OpenSearch Dashboards home directory (likely `/usr/share/opensearch-dashboards`) and run the install command for each plugin.
Navigate to the OpenSearch Dashboards home directory (for example, `/usr/share/opensearch-dashboards`) and run the install command for each plugin.

{% comment %}

Expand All @@ -65,7 +60,6 @@ sudo bin/opensearch-dashboards-plugin install https://d3g5vo6xdbdb9a.cloudfront.

This plugin provides a user interface for managing users, roles, mappings, action groups, and tenants.


#### Alerting OpenSearch Dashboards

```bash
Expand All @@ -74,7 +68,6 @@ sudo bin/opensearch-dashboards-plugin install https://d3g5vo6xdbdb9a.cloudfront.

This plugin provides a user interface for creating monitors and managing alerts.


#### Index State Management OpenSearch Dashboards

```bash
Expand All @@ -83,7 +76,6 @@ sudo bin/opensearch-dashboards-plugin install https://d3g5vo6xdbdb9a.cloudfront.

This plugin provides a user interface for managing policies.


#### Anomaly Detection OpenSearch Dashboards

```bash
Expand All @@ -92,7 +84,6 @@ sudo bin/opensearch-dashboards-plugin install https://d3g5vo6xdbdb9a.cloudfront.

This plugin provides a user interface for adding detectors.


#### Query Workbench OpenSearch Dashboards

```bash
Expand All @@ -101,7 +92,6 @@ sudo bin/opensearch-dashboards-plugin install https://d3g5vo6xdbdb9a.cloudfront.

This plugin provides a user interface for using SQL queries to explore your data.


#### Trace Analytics

```bash
Expand All @@ -110,7 +100,6 @@ sudo bin/opensearch-dashboards-plugin install https://d3g5vo6xdbdb9a.cloudfront.

This plugin uses distributed trace data (indexed in OpenSearch using Data Prepper) to display latency trends, error rates, and more.


#### Notebooks OpenSearch Dashboards

```bash
Expand All @@ -119,7 +108,6 @@ sudo bin/opensearch-dashboards-plugin install https://d3g5vo6xdbdb9a.cloudfront.

This plugin lets you combine OpenSearch Dashboards visualizations and narrative text in a single interface.


#### Reports OpenSearch Dashboards

```bash
Expand All @@ -133,7 +121,6 @@ sudo bin/opensearch-dashboards-plugin install https://d3g5vo6xdbdb9a.cloudfront.

This plugin lets you export and share reports from OpenSearch Dashboards dashboards, visualizations, and saved searches.


#### Gantt Chart OpenSearch Dashboards

```bash
Expand All @@ -144,15 +131,14 @@ This plugin adds a new Gantt chart visualization.

{% endcomment %}

## List installed plugins
## Viewing a list of installed plugins

To check your installed plugins:
To view the list of installed plugins from the command line, use the following command:

```bash
sudo bin/opensearch-dashboards-plugin list
```


## Remove plugins

To remove a plugin:
Expand All @@ -171,8 +157,7 @@ sudo rm /usr/share/opensearch-dashboards/optimize/bundles/opensearch-anomaly-det

Then restart OpenSearch Dashboards. After you remove any plugin, OpenSearch Dashboards performs an optimize operation the next time you start it. This operation takes several minutes even on fast machines, so be patient.


## Update plugins
## Updating plugins

OpenSearch Dashboards doesn’t update plugins. Instead, you have to remove the old version and its optimized bundle, reinstall them, and restart OpenSearch Dashboards:

Expand Down
2 changes: 1 addition & 1 deletion _observing-your-data/ad/index.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
layout: default
title: Anomaly detection
nav_order: 90
nav_order: 80
has_children: true
redirect_from:
- /monitoring-plugins/ad/
Expand Down
2 changes: 1 addition & 1 deletion _observing-your-data/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
layout: default
title: Observability
nav_order: 1
has_children: false
has_children: true
redirect_from:
- /observability-plugin/index/
---
Expand Down
2 changes: 1 addition & 1 deletion _observing-your-data/notifications/index.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
layout: default
title: Notifications
nav_order: 80
nav_order: 90
has_children: true
redirect_from:
- /notifications-plugin/
Expand Down

0 comments on commit 93ef1c5

Please sign in to comment.