iSharkFly-Docs
/
opensearch-docs-cn
mirror of https://github.com/iSharkFly-Docs/opensearch-docs-cn
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #28 from sruti1312/pa-changes 

Update PA docs
This commit is contained in:
Andrew Etter 2021-06-07 18:33:59 -07:00 committed by GitHub
parent 55b296a2ed 2f0577869d
commit b9302d3d16
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
7 changed files with 21 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
docs/opensearch/install/docker.md
View File

@ -192,25 +192,25 @@ You can also configure `docker-compose.yml` and `opensearch.yml` [to take your o
1. Enable the Performance Analyzer plugin: 1. Enable the Performance Analyzer plugin:
```bash ```bash
curl -XPOST localhost:9200/_opensearch/_performanceanalyzer/cluster/config -H 'Content-Type: application/json' -d '{"enabled": true}' curl -XPOST localhost:9200/_plugins/_performanceanalyzer/cluster/config -H 'Content-Type: application/json' -d '{"enabled": true}'
``` ```
If you receive the `curl: (52) Empty reply from server` error, you are likely protecting your cluster with the security plugin and you need to provide credentials. Modify the following command to use your username and password: If you receive the `curl: (52) Empty reply from server` error, you are likely protecting your cluster with the security plugin and you need to provide credentials. Modify the following command to use your username and password:
```bash ```bash
curl -XPOST https://localhost:9200/_opensearch/_performanceanalyzer/cluster/config -H 'Content-Type: application/json' -d '{"enabled": true}' -u 'admin:admin' -k curl -XPOST https://localhost:9200/_plugins/_performanceanalyzer/cluster/config -H 'Content-Type: application/json' -d '{"enabled": true}' -u 'admin:admin' -k
``` ```
1. Enable the Root Cause Analyzer (RCA) framework 1. Enable the Root Cause Analyzer (RCA) framework
```bash ```bash
curl -XPOST localhost:9200/_opensearch/_performanceanalyzer/rca/cluster/config -H 'Content-Type: application/json' -d '{"enabled": true}' curl -XPOST localhost:9200/_plugins/_performanceanalyzer/rca/cluster/config -H 'Content-Type: application/json' -d '{"enabled": true}'
``` ```
Similar to step 1, if you run into `curl: (52) Empty reply from server`, run the command below to enable RCA Similar to step 1, if you run into `curl: (52) Empty reply from server`, run the command below to enable RCA
```bash ```bash
curl -XPOST https://localhost:9200/_opensearch/_performanceanalyzer/rca/cluster/config -H 'Content-Type: application/json' -d '{"enabled": true}' -u 'admin:admin' -k curl -XPOST https://localhost:9200/_plugins/_performanceanalyzer/rca/cluster/config -H 'Content-Type: application/json' -d '{"enabled": true}' -u 'admin:admin' -k
``` ```
1. By default, Performance Analyzer's endpoints are not accessible from outside the Docker container. 1. By default, Performance Analyzer's endpoints are not accessible from outside the Docker container.

2
docs/opensearch/install/plugins.md
View File

@ -244,7 +244,7 @@ Performance Analyzer requires some manual configuration after installing the plu
1. Send a test request: 1. Send a test request:
```bash ```bash
curl -XGET "localhost:9600/_opensearch/_performanceanalyzer/metrics?metrics=Latency,CPU_Utilization&agg=avg,max&dim=ShardID&nodes=all" curl -XGET "localhost:9600/_plugins/_performanceanalyzer/metrics?metrics=Latency,CPU_Utilization&agg=avg,max&dim=ShardID&nodes=all"
``` ```
{% endcomment %} {% endcomment %}

8
docs/opensearch/install/tar.md
View File

@ -118,25 +118,25 @@ In a tarball installation, Performance Analyzer collects data when it is enabled
1. In a separate window, enable the Performance Analyzer plugin: 1. In a separate window, enable the Performance Analyzer plugin:
```bash ```bash
curl -XPOST localhost:9200/_opensearch/_performanceanalyzer/cluster/config -H 'Content-Type: application/json' -d '{"enabled": true}' curl -XPOST localhost:9200/_plugins/_performanceanalyzer/cluster/config -H 'Content-Type: application/json' -d '{"enabled": true}'
``` ```
If you receive the `curl: (52) Empty reply from server` error, you are likely protecting your cluster with the security plugin and you need to provide credentials. Modify the following command to use your username and password: If you receive the `curl: (52) Empty reply from server` error, you are likely protecting your cluster with the security plugin and you need to provide credentials. Modify the following command to use your username and password:
```bash ```bash
curl -XPOST https://localhost:9200/_opensearch/_performanceanalyzer/cluster/config -H 'Content-Type: application/json' -d '{"enabled": true}' -u 'admin:admin' -k curl -XPOST https://localhost:9200/_plugins/_performanceanalyzer/cluster/config -H 'Content-Type: application/json' -d '{"enabled": true}' -u 'admin:admin' -k
``` ```
1. Finally, enable the Root Cause Analyzer (RCA) framework 1. Finally, enable the Root Cause Analyzer (RCA) framework
```bash ```bash
curl -XPOST localhost:9200/_opensearch/_performanceanalyzer/rca/cluster/config -H 'Content-Type: application/json' -d '{"enabled": true}' curl -XPOST localhost:9200/_plugins/_performanceanalyzer/rca/cluster/config -H 'Content-Type: application/json' -d '{"enabled": true}'
``` ```
Similar to step 4, if you run into `curl: (52) Empty reply from server`, run the command below to enable RCA Similar to step 4, if you run into `curl: (52) Empty reply from server`, run the command below to enable RCA
```bash ```bash
curl -XPOST https://localhost:9200/_opensearch/_performanceanalyzer/rca/cluster/config -H 'Content-Type: application/json' -d '{"enabled": true}' -u 'admin:admin' -k curl -XPOST https://localhost:9200/_plugins/_performanceanalyzer/rca/cluster/config -H 'Content-Type: application/json' -d '{"enabled": true}' -u 'admin:admin' -k
``` ```
{% comment %} {% comment %}

6
docs/pa/api.md
View File

@ -10,7 +10,7 @@ nav_order: 1
Performance Analyzer uses a single HTTP method and URI for most requests: Performance Analyzer uses a single HTTP method and URI for most requests:
``` ```
GET <endpoint>:9600/_opensearch/_performanceanalyzer/metrics GET <endpoint>:9600/_plugins/_performanceanalyzer/metrics
``` ```
Note the use of port 9600. Provide parameters for metrics, aggregations, dimensions, and nodes (optional): Note the use of port 9600. Provide parameters for metrics, aggregations, dimensions, and nodes (optional):
@ -25,7 +25,7 @@ For a full list of metrics, see [Metrics reference](../reference/). Performance
#### Sample request #### Sample request
``` ```
GET localhost:9600/_opensearch/_performanceanalyzer/metrics?metrics=Latency,CPU_Utilization&agg=avg,max&dim=ShardID&nodes=all GET localhost:9600/_plugins/_performanceanalyzer/metrics?metrics=Latency,CPU_Utilization&agg=avg,max&dim=ShardID&nodes=all
``` ```
@ -104,7 +104,7 @@ Performance Analyzer has one additional URI that returns the unit for each metri
#### Sample request #### Sample request
``` ```
GET localhost:9600/_opensearch/_performanceanalyzer/metrics/units GET localhost:9600/_plugins/_performanceanalyzer/metrics/units
``` ```

12
docs/pa/index.md
View File

@ -25,25 +25,25 @@ npm install -g @aws/opensearch-perftop
The basic syntax is: The basic syntax is:
```bash ```bash
./perf-top-<operating_system> --dashboard <dashboard>.json --endpoint <endpoint> ./opensearch-perf-top-<operating_system> --dashboard <dashboard>.json --endpoint <endpoint>
``` ```
If you're using npm, the syntax is similar: If you're using npm, the syntax is similar:
```bash ```bash
perf-top --dashboard <dashboard> --endpoint <endpoint> opensearch-perf-top --dashboard <dashboard> --endpoint <endpoint>
``` ```
If you're running PerfTop from a node (i.e. locally), specify port 9600: If you're running PerfTop from a node (i.e. locally), specify port 9600:
```bash ```bash
./perf-top-linux --dashboard dashboards/<dashboard>.json --endpoint localhost:9600 ./opensearch-perf-top-linux --dashboard dashboards/<dashboard>.json --endpoint localhost:9600
``` ```
Otherwise, just specify the OpenSearch endpoint: Otherwise, just specify the OpenSearch endpoint:
```bash ```bash
./perf-top-macos --dashboard dashboards/<dashboard>.json --endpoint my-cluster.my-domain.com ./opensearch-perf-top-macos --dashboard dashboards/<dashboard>.json --endpoint my-cluster.my-domain.com
``` ```
PerfTop has four pre-built dashboards in the `dashboards` directory, but you can also [create your own](dashboards/). PerfTop has four pre-built dashboards in the `dashboards` directory, but you can also [create your own](dashboards/).
@ -83,10 +83,10 @@ mount -o remount /dev/shm
### Security ### Security
Performance Analyzer supports encryption in transit for requests. It currently does *not* support client or server authentication for requests. To enable encryption in transit, edit `performance-analyzer.properties` in your `$ES_HOME` directory: Performance Analyzer supports encryption in transit for requests. It currently does *not* support client or server authentication for requests. To enable encryption in transit, edit `performance-analyzer.properties` in your `$OPENSEARCH_HOME` directory:
```bash ```bash
vi $ES_HOME/plugins/opensearch_performance_analyzer/pa_config/performance-analyzer.properties vi $OPENSEARCH_HOME/plugins/opensearch-performance-analyzer/pa_config/performance-analyzer.properties
``` ```
Change the following lines to configure encryption in transit. Note that `certificate-file-path` must be a certificate for the server, not a root CA: Change the following lines to configure encryption in transit. Note that `certificate-file-path` must be a certificate for the server, not a root CA:

4
docs/pa/rca/api.md
View File

@ -12,10 +12,10 @@ nav_order: 1
``` ```
# Request all available RCAs # Request all available RCAs
GET localhost:9600/_opensearch/_performanceanalyzer/rca GET localhost:9600/_plugins/_performanceanalyzer/rca
# Request a specific RCA # Request a specific RCA
GET localhost:9600/_opensearch/_performanceanalyzer/rca?name=HighHeapUsageClusterRca GET localhost:9600/_plugins/_performanceanalyzer/rca?name=HighHeapUsageClusterRca
``` ```

2
docs/pa/rca/reference.md
View File

@ -8,4 +8,4 @@ nav_order: 3
# RCA reference # RCA reference
You can find a reference of available RCAs and their purposes on [Github](https://github.com/opensearch-project/performance-analyzer-rca/tree/master/docs). You can find a reference of available RCAs and their purposes on [Github](https://github.com/opensearch-project/performance-analyzer-rca/tree/main/docs).