Skip to content

Commit

Permalink
Update docs for kubedb/cli@3b3001df
Browse files Browse the repository at this point in the history
Signed-off-by: 1gtm <[email protected]>
  • Loading branch information
1gtm committed Feb 14, 2024
1 parent 4b0b609 commit 77353cd
Show file tree
Hide file tree
Showing 5 changed files with 209 additions and 28 deletions.
3 changes: 1 addition & 2 deletions docs/reference/cli/kubectl-dba.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,12 +59,11 @@ kubectl-dba [flags]

* [kubectl-dba completion](/docs/reference/cli/kubectl-dba_completion.md) - Generate completion script
* [kubectl-dba connect](/docs/reference/cli/kubectl-dba_connect.md) - Connect to a database.
* [kubectl-dba dashboard](/docs/reference/cli/kubectl-dba_dashboard.md) - Check availability of a grafana dashboard
* [kubectl-dba data](/docs/reference/cli/kubectl-dba_data.md) - Insert, Drop or Verify data in a database
* [kubectl-dba debug](/docs/reference/cli/kubectl-dba_debug.md) - Debug any Database issue
* [kubectl-dba describe](/docs/reference/cli/kubectl-dba_describe.md) - Show details of a specific resource or group of resources
* [kubectl-dba exec](/docs/reference/cli/kubectl-dba_exec.md) - Execute script or command to a database.
* [kubectl-dba get-alerts](/docs/reference/cli/kubectl-dba_get-alerts.md) - Alerts associated with a database
* [kubectl-dba monitor](/docs/reference/cli/kubectl-dba_monitor.md) - Monitoring related commands for a database
* [kubectl-dba options](/docs/reference/cli/kubectl-dba_options.md) - Print the list of flags inherited by all commands
* [kubectl-dba pause](/docs/reference/cli/kubectl-dba_pause.md) - Pause the processing of an object.
* [kubectl-dba remote-config](/docs/reference/cli/kubectl-dba_remote-config.md) - generate appbinding , secrets for remote replica
Expand Down
83 changes: 83 additions & 0 deletions docs/reference/cli/kubectl-dba_monitor.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,83 @@
---
title: Kubectl-Dba Monitor
menu:
docs_{{ .version }}:
identifier: kubectl-dba-monitor
name: Kubectl-Dba Monitor
parent: reference-cli
menu_name: docs_{{ .version }}
section_menu_id: reference
---
## kubectl-dba monitor

Monitoring related commands for a database

### Synopsis

All monitoring related commands from AppsCode.

```
kubectl-dba monitor
```

### Examples

```
# Check triggered alerts for a specific database
kubectl dba monitor get-alerts [DATABASE] [DATABASE_NAME] -n [NAMESPACE]
# Check availability of grafana dashboard of a database
kubectl dba monitor dashboard [DATABASE] [DASHBOARD_NAME]
# Check connection status of target with prometheus server for a specific database
kubectl dba monitor check-connection [DATABASE] [DATABASE_NAME] -n [NAMESPACE]
# Common Flags
--prom-svc-name : name of the prometheus service
--prom-svc-namespace : namespace of the prometheus service
--prom-svc-port : port of the prometheus service
```

### Options

```
-h, --help help for monitor
--prom-svc-name string name of the prometheus service
--prom-svc-namespace string namespace of the prometheus service
--prom-svc-port int port of the prometheus service (default 9090)
```

### Options inherited from parent commands

```
--as string Username to impersonate for the operation. User could be a regular user or a service account in a namespace.
--as-group stringArray Group to impersonate for the operation, this flag can be repeated to specify multiple groups.
--as-uid string UID to impersonate for the operation.
--cache-dir string Default cache directory (default "/home/runner/.kube/cache")
--certificate-authority string Path to a cert file for the certificate authority
--client-certificate string Path to a client certificate file for TLS
--client-key string Path to a client key file for TLS
--cluster string The name of the kubeconfig cluster to use
--context string The name of the kubeconfig context to use
--default-seccomp-profile-type string Default seccomp profile
--disable-compression If true, opt-out of response compression for all requests to the server
--insecure-skip-tls-verify If true, the server's certificate will not be checked for validity. This will make your HTTPS connections insecure
--kubeconfig string Path to the kubeconfig file to use for CLI requests.
--match-server-version Require server version to match client version
-n, --namespace string If present, the namespace scope for this CLI request
--password string Password for basic authentication to the API server
--request-timeout string The length of time to wait before giving up on a single server request. Non-zero values should contain a corresponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't timeout requests. (default "0")
-s, --server string The address and port of the Kubernetes API server
--tls-server-name string Server name to use for server certificate validation. If it is not provided, the hostname used to contact the server is used
--token string Bearer token for authentication to the API server
--user string The name of the kubeconfig user to use
--username string Username for basic authentication to the API server
```

### SEE ALSO

* [kubectl-dba](/docs/reference/cli/kubectl-dba.md) - kubectl plugin for KubeDB
* [kubectl-dba monitor check-connection](/docs/reference/cli/kubectl-dba_monitor_check-connection.md) - Check connection status of prometheus targets with server
* [kubectl-dba monitor dashboard](/docs/reference/cli/kubectl-dba_monitor_dashboard.md) - Check availability of a grafana dashboard
* [kubectl-dba monitor get-alerts](/docs/reference/cli/kubectl-dba_monitor_get-alerts.md) - Alerts associated with a database

84 changes: 84 additions & 0 deletions docs/reference/cli/kubectl-dba_monitor_check-connection.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,84 @@
---
title: Kubectl-Dba Monitor Check-Connection
menu:
docs_{{ .version }}:
identifier: kubectl-dba-monitor-check-connection
name: Kubectl-Dba Monitor Check-Connection
parent: reference-cli
menu_name: docs_{{ .version }}
section_menu_id: reference
---
## kubectl-dba monitor check-connection

Check connection status of prometheus targets with server

### Synopsis

Check connection status for different targets with prometheus server for specific DB.

```
kubectl-dba monitor check-connection
```

### Examples

```
kubectl dba monitor check-connection [DATABASE] [DATABASE_NAME] -n [NAMESPACE] \
--prom-svc=[PROM_SVC_NAME] --prom-svc-namespace=[PROM_SVC_NS] --prom-svc-port=[PROM_SVC_PORT]
# Check connection status for different targets with prometheus server for a specific postgres database
kubectl dba monitor check-connection mongodb sample_mg -n demo \
--prom-svc-name=prometheus-kube-prometheus-prometheus --prom-svc-namespace=monitoring --prom-svc-port=9090
Valid resource types include:
* elasticsearch
* kafka
* mariadb
* mongodb
* mysql
* perconaxtradb
* postgres
* proxysql
* redis
```

### Options

```
-h, --help help for check-connection
```

### Options inherited from parent commands

```
--as string Username to impersonate for the operation. User could be a regular user or a service account in a namespace.
--as-group stringArray Group to impersonate for the operation, this flag can be repeated to specify multiple groups.
--as-uid string UID to impersonate for the operation.
--cache-dir string Default cache directory (default "/home/runner/.kube/cache")
--certificate-authority string Path to a cert file for the certificate authority
--client-certificate string Path to a client certificate file for TLS
--client-key string Path to a client key file for TLS
--cluster string The name of the kubeconfig cluster to use
--context string The name of the kubeconfig context to use
--default-seccomp-profile-type string Default seccomp profile
--disable-compression If true, opt-out of response compression for all requests to the server
--insecure-skip-tls-verify If true, the server's certificate will not be checked for validity. This will make your HTTPS connections insecure
--kubeconfig string Path to the kubeconfig file to use for CLI requests.
--match-server-version Require server version to match client version
-n, --namespace string If present, the namespace scope for this CLI request
--password string Password for basic authentication to the API server
--prom-svc-name string name of the prometheus service
--prom-svc-namespace string namespace of the prometheus service
--prom-svc-port int port of the prometheus service (default 9090)
--request-timeout string The length of time to wait before giving up on a single server request. Non-zero values should contain a corresponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't timeout requests. (default "0")
-s, --server string The address and port of the Kubernetes API server
--tls-server-name string Server name to use for server certificate validation. If it is not provided, the hostname used to contact the server is used
--token string Bearer token for authentication to the API server
--user string The name of the kubeconfig user to use
--username string Username for basic authentication to the API server
```

### SEE ALSO

* [kubectl-dba monitor](/docs/reference/cli/kubectl-dba_monitor.md) - Monitoring related commands for a database

Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
---
title: Kubectl-Dba Dashboard
title: Kubectl-Dba Monitor Dashboard
menu:
docs_{{ .version }}:
identifier: kubectl-dba-dashboard
name: Kubectl-Dba Dashboard
identifier: kubectl-dba-monitor-dashboard
name: Kubectl-Dba Monitor Dashboard
parent: reference-cli
menu_name: docs_{{ .version }}
section_menu_id: reference
---
## kubectl-dba dashboard
## kubectl-dba monitor dashboard

Check availability of a grafana dashboard

Expand All @@ -17,32 +17,36 @@ Check availability of a grafana dashboard
Check availability of metrics in prometheus server used in a grafana dashboard.

```
kubectl-dba dashboard
kubectl-dba monitor dashboard
```

### Examples

```
# Check availability of mongodb-summary-dashboard grafana dashboard of mongodb
kubectl dba dashboard mongodb mongodb-summary-dashboard
kubectl dba monitor dashboard [DATABASE] [DASHBOARD_NAME] \
--prom-svc=[PROM_SVC_NAME] --prom-svc-namespace=[PROM_SVC_NS] --prom-svc-port=[PROM_SVC_PORT]
# Check availability of a postgres grafana dashboard
kubectl-dba monitor dashboard postgres postgres_databases_dashboard \
--prom-svc-name=prometheus-kube-prometheus-prometheus --prom-svc-namespace=monitoring --prom-svc-port=9090
Valid dashboards include:
* elasticsearch
* mongodb
* kafka
* mariadb
* mongodb
* mysql
* perconaxtradb
* postgres
* proxysql
* redis
```

### Options

```
-b, --branch string branch name of the github repo (default "master")
-h, --help help for dashboard
--prom-svc-name string name of the prometheus service
--prom-svc-namespace string namespace of the prometheus service
--prom-svc-port int port of the prometheus service (default 9090)
-b, --branch string branch name of the github repo (default "master")
-h, --help help for dashboard
```

### Options inherited from parent commands
Expand All @@ -64,6 +68,9 @@ kubectl-dba dashboard
--match-server-version Require server version to match client version
-n, --namespace string If present, the namespace scope for this CLI request
--password string Password for basic authentication to the API server
--prom-svc-name string name of the prometheus service
--prom-svc-namespace string namespace of the prometheus service
--prom-svc-port int port of the prometheus service (default 9090)
--request-timeout string The length of time to wait before giving up on a single server request. Non-zero values should contain a corresponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't timeout requests. (default "0")
-s, --server string The address and port of the Kubernetes API server
--tls-server-name string Server name to use for server certificate validation. If it is not provided, the hostname used to contact the server is used
Expand All @@ -74,5 +81,5 @@ kubectl-dba dashboard

### SEE ALSO

* [kubectl-dba](/docs/reference/cli/kubectl-dba.md) - kubectl plugin for KubeDB
* [kubectl-dba monitor](/docs/reference/cli/kubectl-dba_monitor.md) - Monitoring related commands for a database

Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
---
title: Kubectl-Dba Get-Alerts
title: Kubectl-Dba Monitor Get-Alerts
menu:
docs_{{ .version }}:
identifier: kubectl-dba-get-alerts
name: Kubectl-Dba Get-Alerts
identifier: kubectl-dba-monitor-get-alerts
name: Kubectl-Dba Monitor Get-Alerts
parent: reference-cli
menu_name: docs_{{ .version }}
section_menu_id: reference
---
## kubectl-dba get-alerts
## kubectl-dba monitor get-alerts

Alerts associated with a database

Expand All @@ -17,30 +17,35 @@ Alerts associated with a database
Get the prometheus alerts for a specific database in just one command

```
kubectl-dba get-alerts
kubectl-dba monitor get-alerts
```

### Examples

```
kubectl dba get-alerts mongodb -n demo sample-mongodb --prom-svc-name=prometheus-kube-prometheus-prometheus --prom-svc-namespace=monitoring
kubectl dba monitor get-alerts [DATABASE] [DATABASE_NAME] -n [NAMESPACE] \
--prom-svc=[PROM_SVC_NAME] --prom-svc-namespace=[PROM_SVC_NS] --prom-svc-port=[PROM_SVC_PORT]
# Get triggered alert for a specific mongodb
kubectl dba monitor get-alerts mongodb sample-mongodb -n demo \
--prom-svc-name=prometheus-kube-prometheus-prometheus --prom-svc-namespace=monitoring --prom-svc-port=9090
Valid resource types include:
* elasticsearch
* mongodb
* kafka
* mariadb
* mongodb
* mysql
* perconaxtradb
* postgres
* proxysql
* redis
```

### Options

```
-h, --help help for get-alerts
--prom-svc-name string name of the prometheus service
--prom-svc-namespace string namespace of the prometheus service
--prom-svc-port int port of the prometheus service (default 9090)
-h, --help help for get-alerts
```

### Options inherited from parent commands
Expand All @@ -62,6 +67,9 @@ kubectl-dba get-alerts
--match-server-version Require server version to match client version
-n, --namespace string If present, the namespace scope for this CLI request
--password string Password for basic authentication to the API server
--prom-svc-name string name of the prometheus service
--prom-svc-namespace string namespace of the prometheus service
--prom-svc-port int port of the prometheus service (default 9090)
--request-timeout string The length of time to wait before giving up on a single server request. Non-zero values should contain a corresponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't timeout requests. (default "0")
-s, --server string The address and port of the Kubernetes API server
--tls-server-name string Server name to use for server certificate validation. If it is not provided, the hostname used to contact the server is used
Expand All @@ -72,5 +80,5 @@ kubectl-dba get-alerts

### SEE ALSO

* [kubectl-dba](/docs/reference/cli/kubectl-dba.md) - kubectl plugin for KubeDB
* [kubectl-dba monitor](/docs/reference/cli/kubectl-dba_monitor.md) - Monitoring related commands for a database

0 comments on commit 77353cd

Please sign in to comment.