DOC-153/oasis-metrics (#1079)

* generated output of oasisctl * described monitoring and metrics * fix typos * Update monitoring-metrics.md * Update monitoring-metrics.md Co-authored-by: ansoboleva <93702078+ansoboleva@users.noreply.github.com>

Author: nerpaula

_data/oasis.yml

@@ -15,6 +15,8 @@
  href: deployments.html
 - text: My Account
  href: my-account.html
+- text: Monitoring & Metrics
+ href: monitoring-metrics.html 
 - text: Security and Access Control
  href: access-control.html
 - text: Backups
@@ -163,6 +165,16 @@
  href: oasisctl-delete-project.html
  - text: Delete Role
  href: oasisctl-delete-role.html
+ - text: Disable
+ href: oasisctl-disable.html
+ children:
+ - text: Disable Scheduled Root Password Rotation
+ href: oasisctl-disable-scheduled-root-password-rotation.html
+ - text: Enable
+ href: oasisctl-enable.html
+ children:
+ - text: Enable Scheduled Root Password Rotation
+ href: oasisctl-enable-scheduled-root-password-rotation.html
  - text: Generate Docs
  href: oasisctl-generate-docs.html
  - text: Get

oasis/images/oasis-connect-metrics-section.png

@@ -0,0 +1,90 @@
+---
+layout: default
+description: How to use metrics
+title: Monitoring in ArangoDB Oasis
+---
+# Monitoring & Metrics
+
+ArangoDB Oasis provides metrics for each deployment in a 
+[Prometheus](https://prometheus.io/){:target="_blank"}
+compatible format.
+You can use these metrics to gather detailed insights into the current
+and previous states of your deployment.
+Once metrics are collected by Prometheus, you can inspect them using tools
+such as [Grafana](https://grafana.com/oss/grafana/){:target="_blank"}.
+
+To get started, select an existing deployment from within a project and
+open the **Monitoring** tab. 
+
+![Oasis Monitoring tab](images/oasis-monitoring-tab.png)
+
+![Oasis Connect Metrics Section](images/oasis-connect-metrics-section.png)
+
+## Metrics tokens
+
+The **Metrics tokens** section allows you to create a new metrics token,
+which is required for connecting to Prometheus.
+
+1. To create a metrics token, click **New metrics token**.
+2. For **Name**, enter a name for the metrics token.
+3. Optionally, you can also enter a **Short description**.
+4. Select the **Lifetime** of the metrics token. 
+5. Click **Create**.
+
+![Oasis Metrics Tokens](images/oasis-metrics-token.png)
+
+## How to connect Prometheus
+
+1. In the **Metrics** section, click **Connect Prometheus**.
+2. Create the `prometheus.yml` file with the following content:
+
+ ```yml
+ global:
+ scrape_interval: 60s
+ scrape_configs:
+ - job_name: 'deployment'
+ bearer_token: '<fill-your-metrics-token-here>'
+ scheme: 'https'
+ static_configs:
+ - targets: ['6775e7d48152.arangodb.cloud:8829']
+ tls_config:
+ insecure_skip_verify: true
+ ```
+3. Start Prometheus with the following command:
+
+ ```dockerfile
+ docker run -d \
+ -p 9090:9090 -p 3000:3000 --name prometheus \
+ -v $(pwd)/prometheus.yml:/etc/prometheus/prometheus.yml:ro \
+ prom/prometheus
+ ```
+ {% hint 'info' %}
+ This command also opens a port 3000 for Grafana. In a production environment,
+ this is not needed and not recommended to have it open.
+ {% endhint %}
+
+## How to connect Grafana
+
+1. Start Grafana with the following command:
+
+ ```dockerfile 
+ docker run -d \
+ --network container:prometheus \
+ grafana/grafana
+ ``` 
+2. Go to `localhost:3000` and log in with the following credentials:
+ - For username, enter *admin*.
+ - For password, enter *admin*. 
+ 
+ {% hint 'tip' %}
+ After the initial login, make sure to change your password.
+ {% endhint %}
+
+3. To add a data source, click **Add your first data source** and then do the following:
+ - Select **Prometheus**.
+ - For **HTTP URL**, enter `http://localhost:9090`.
+ - Click **Save & Test**. 
+4. To add a dashboard, open the menu and click **Create** and then **Import**.
+5. Download the [Grafana dashboard for ArangoDB Oasis](https://github.com/arangodb-managed/grafana-dashboards){:target="_blank"}.
+6. Copy the contents of the `main.json` file into the **Import via panel json** field in Grafana.
+7. Click **Load**.

oasis/images/oasis-metrics-token.png

@@ -22,6 +22,7 @@ oasisctl clone deployment backup [flags]
  -b, --backup-id string Clone a deployment from a backup using the backup's ID.
  -h, --help help for backup
  -o, --organization-id string Identifier of the organization to create the clone in
+ -p, --project-id string An optional identifier of the project to create the clone in
  -r, --region-id string An optionally defined region in which the new deployment should be created in.
 ```
 

oasis/images/oasis-monitoring-tab.png

@@ -27,6 +27,7 @@ oasisctl create backup policy [flags]
  -h, --help help for policy
  --hours int32 Hours part of the time of day (0-23)
  --minutes int32 Minutes part of the time of day (0-59)
+ --minutes-offset int32 Schedule should run with specific minutes offset (0-59)
  --monday If set, a backup will be created on Mondays
  --name string Name of the deployment
  --paused The policy is paused

oasis/monitoring-metrics.md

@@ -19,6 +19,7 @@ oasisctl create private endpoint service [flags]
 
 ```
  --alternate-dns-name strings DNS names used for the deployment in the private network
+ --aws-principal strings List of AWS Principals from which a Private Endpoint can be created (Format: <AccountID>[/Role/<RoleName>|/User/<UserName>])
  --azure-client-subscription-id strings List of Azure subscription IDs from which a Private Endpoint can be created
  -d, --deployment-id string Identifier of the deployment that the private endpoint service is connected to
  --description string Description of the private endpoint service

oasis/oasisctl-clone-deployment-backup.md

@@ -0,0 +1,38 @@
+---
+layout: default
+description: Description of the oasisctl disable scheduled-root-password-rotation command
+title: Oasisctl Disable Scheduled-Root-Password-Rotation
+---
+# Oasisctl Disable Scheduled-root-password-rotation
+
+Disable scheduled root password rotation
+
+## Synopsis
+
+Disable scheduled root password rotation
+
+```
+oasisctl disable scheduled-root-password-rotation [flags]
+```
+
+## Options
+
+```
+ -d, --deployment-id string Identifier of the deployment
+ -h, --help help for scheduled-root-password-rotation
+ -o, --organization-id string Identifier of the organization
+ -p, --project-id string Identifier of the project
+```
+
+## Options inherited from parent commands
+
+```
+ --endpoint string API endpoint of the ArangoDB Oasis (default "api.cloud.arangodb.com")
+ --format string Output format (table|json) (default "table")
+ --token string Token used to authenticate at ArangoDB Oasis
+```
+
+## See also
+
+* [oasisctl disable](oasisctl-disable.html) - Disable some settings related to deployment
+

oasis/oasisctl-create-backup-policy.md

@@ -0,0 +1,36 @@
+---
+layout: default
+description: Description of the oasisctl disable command
+title: Oasisctl Disable
+---
+# Oasisctl Disable
+
+Disable some settings related to deployment
+
+## Synopsis
+
+Disable some settings related to deployment
+
+```
+oasisctl disable [flags]
+```
+
+## Options
+
+```
+ -h, --help help for disable
+```
+
+## Options inherited from parent commands
+
+```
+ --endpoint string API endpoint of the ArangoDB Oasis (default "api.cloud.arangodb.com")
+ --format string Output format (table|json) (default "table")
+ --token string Token used to authenticate at ArangoDB Oasis
+```
+
+## See also
+
+* [oasisctl](oasisctl-options.html) - ArangoDB Oasis
+* [oasisctl disable scheduled-root-password-rotation](oasisctl-disable-scheduled-root-password-rotation.html) - Disable scheduled root password rotation
+