Skip to content

Commit

Permalink
update (#2281)
Browse files Browse the repository at this point in the history
* update

* Update docs-2.0/nebula-dashboard-ent/8.faq.md

* Update docs-2.0/nebula-explorer/faq.md

* Update ex-ug-deploy.md

* Update faq.md
  • Loading branch information
cooper-lzy authored Oct 9, 2023
1 parent c17c65d commit dcb0df0
Show file tree
Hide file tree
Showing 10 changed files with 126 additions and 19 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
- [Back up and restore](../../nebula-dashboard-ent/4.cluster-operator/operator/backup-and-restore.md) support full backup to local.
- Add [Slow query analyst](../../nebula-dashboard-ent/4.cluster-operator/analysis-diagnosis/slow-query-analyst.md) function.
- The [Cluster diagnostics](../../nebula-dashboard-ent/4.cluster-operator/analysis-diagnosis/cluster-diagnosis.md) formula supports configuration.
- [Config Management](../../nebula-dashboard-ent/4.cluster-operator/operator/config-management.md) support **Add Config**, view the **Effective value** of the current configuration, and **View inconsistent configurations**.
- [Config Management](../../nebula-dashboard-ent/4.cluster-operator/operator/update-config.md) support **Add Config**, view the **Effective value** of the current configuration, and **View inconsistent configurations**.
- In the [Notification endpoint](../../nebula-dashboard-ent/system-settings/notification-endpoint.md), the webhook supports configuring the **Webhook request body**.
- Support [custom monitoring panel](../../nebula-dashboard-ent/4.cluster-operator/2.monitor.md).

Expand Down
4 changes: 2 additions & 2 deletions docs-2.0/nebula-dashboard-ent/10.tasks.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,12 +26,12 @@ At the top navigation bar of the Dashboard Enterprise Edition page, click Task C

Click the tab **Running Task** to view the progress of the running tasks.

- Click a task name to view the ID, node name, type, create time, and operator of the running task.
- Click a task name to view the ID, node name, type, create time, and operator of the running task.
- Clink **Task information** to view task details.

## Task history

Click **Task History** to view all ended tasks.

- You can filter historical tasks by status, type, date, and time.
- On the right side of the target historical task, click **Task information** to view task details, and click **Logs** to view task execution logs.
- On the right side of the target historical task, click **Task information** to view task details, click **Logs** to view task execution logs, and click **Retry** to re-execute the failed task.
35 changes: 30 additions & 5 deletions docs-2.0/nebula-dashboard-ent/2.deploy-connect-dashboard-ent.md
Original file line number Diff line number Diff line change
Expand Up @@ -229,6 +229,31 @@ The following section presents two methods for managing the Dashboard service. I
sudo systemctl stop nbd-prometheus.service
```

## Directory structure

The structure of the Dashboard Enterprise Edition is as follows:

```bash
├── assets # Static resource files
│   └── ...
├── bin # System executables
│   └──...
├── CMakeLists.txt # CMake configuration files
|
├── data # Database data files
│   └──...
├── download # Dependency packages
│   └──...
├── etc # Configuration files
│   └──...
├── logs # Log files
│   └──...
├── pids # Service process files
│   └──...
└── scripts # Scripts for managing services
└──...
```

## View logs

- Users who manage services using `dashboard.service` can view the Dashboard Enterprise Edition logs in the `logs` directory.
Expand All @@ -248,11 +273,11 @@ The following section presents two methods for managing the Dashboard service. I
|`prometheus.log`| Prometheus service log. |
|`br`| Backup and restore service log. |
|`webserver.log`| Dashboard service log. </br>It takes effect only when the `Log.Mode` in the Dashboard configuration is `console`. |
|`access.log`| Access log. </br>It takes effect only when the `Log.Mode` in the Dashboard configuration is `file`. |
|`error.log`| Error log. </br>It takes effect only when the `Log.Mode` in the Dashboard configuration is `file`. |
|`severe.log`| Severe log. </br>It takes effect only when the `Log.Mode` in the Dashboard configuration is `file`. |
|`slow.log`| Slow log. </br>It takes effect only when the `Log.Mode` in the Dashboard configuration is `file`. |
|`stat.log`| Statistic log. </br>It takes effect only when the `Log.Mode` in the Dashboard configuration is `file`. |
|`access.log`| Access log. Records all request messages for accessing the services, including request time, source address, requested URL, HTTP method, returned HTTP status code, etc.</br>It takes effect only when the `Log.Mode` in the Dashboard configuration is `file`. |
|`error.log`| Error log. Records error messages that occur during service running. This may include runtime errors, system errors, service logic errors, etc.</br>It takes effect only when the `Log.Mode` in the Dashboard configuration is `file`. |
|`severe.log`| Severe log. Records error messages that could cause the system to crash, or seriously affect the correct functioning of the system. This may include runtime errors, system errors, serious service logic errors, etc.</br>It takes effect only when the `Log.Mode` in the Dashboard configuration is `file`. |
|`slow.log`| Slow log. Records requests or operations whose execution time exceeds a preset threshold, helping users identify performance bottlenecks.</br>It takes effect only when the `Log.Mode` in the Dashboard configuration is `file`. |
|`stat.log`| Statistic log. Records statistical information about the service, the content of which depends on the needs of the application and may include a variety of performance metrics, usage statistics, etc.</br>It takes effect only when the `Log.Mode` in the Dashboard configuration is `file`. |

- Users managing services with systemd can access the logs for each Dashboard Enterprise Edition service through `journalctl`.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ Clicking the ![watch](https://docs-cdn.nebula-graph.com.cn/figures/watch.png) bu

!!! Caution

Before using Graph Space Metrics, users need to set `enable_space_level_metrics` to `true` in the Graph service. For specific operations, see [Update config](operator/config-management.md).
Before using Graph Space Metrics, users need to set `enable_space_level_metrics` to `true` in the Graph service. For specific operations, see [Update config](operator/update-config.md).

### Managing Monitoring

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ Follow the below steps to create a custom rule.

| Parameter | Description |
| -------- | ------------------------------------------------------------ |
| Metric Type | Set a metric type. Metric type includes the node metric type and the service type (graphd,storaged,metad). |
| Metric Type | Set a metric type. Metric type includes the node metric type, service metric type (graphd,storaged,metad), and graph space metric type. |
| Metric Rule | Click **+ Add condition** to set metric rules for a node or a service. It supports adding composite conditions (like the usage of AND). For more information, see [Monitoring metrics](../7.monitor-parameter.md).|
| Alert duration | Set how long an alert lasts before the alert message is triggered. Unit: Minute (Min). |

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,6 @@

On **Config Management** page, you can view and update the service configuration files.

## Precautions

You need to restart the corresponding service in the **Service** page after the configuration modification. For details, see [Service](service.md).

## Entry

1. At the top navigation bar of the Dashboard Enterprise Edition page, click **Cluster Management**.
Expand All @@ -18,9 +14,13 @@ You need to restart the corresponding service in the **Service** page after the
2. Locate the configuration to be modified and click **Edit** in the **Operation** column.
3. In the pop-up dialog box, you can modify the **Value** individually. They can also be modified uniformly at the top, and you need to click **Apply To All Services** after modification.

!!! note

The top of the dialog box displays whether the modification of the parameter requires a restart to take effect. Please restart the corresponding service on the **Services** page. For details, see [Service](service.md).

<img src="https://docs-cdn.nebula-graph.com.cn/figures/eo_dash_config_230913_en.png" width="1000" alt="A screenshot that shows the configuration of dashboard">

4. Click **Confirm** after the modification is complete.
4. Click **Confirm** or **Save and Apply** after the modification is complete.

## Add configuration

Expand Down
12 changes: 11 additions & 1 deletion docs-2.0/nebula-dashboard-ent/8.faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,4 +60,14 @@ When importing a cluster, you need to access the path where the NebulaGraph serv

If **Service Host** shows `127.0.0.1`, and your Dashboard and NebulaGraph are deployed on the same machine when authorizing service hosts, the system will prompt "SSH connection error”. You need to change the Host IP of each service to the real machine IP in the configuration files of all NebulaGraph services. For more information, see [Configuration management](../5.configurations-and-logs/1.configurations/1.configurations.md).

If you import a cluster deployed with Docker, it also prompts "SSH connection error". Dashboard does not support importing a cluster deployed with Docker.
If you import a cluster deployed with Docker, it also prompts "SSH connection error". Dashboard does not support importing a cluster deployed with Docker.

## How to implement a highly available architecture

Users can use third-party high-availability software (e.g. [HAProxy](https://www.haproxy.org/)) to implement the high-availability architecture for Dashboard and the high-availability architecture for LM.

For example, you can deploy Dashboard service, database service, Prometheus service, and LM service on multiple machines. Then use HAProxy to implement their respective load balancing.

Then fill in the external interfaces of each service into the configuration of the Dashboard, for example, fill in the external interface information of the database service, Prometheus service, LM service, so as to realize the highly available architecture.

For detailed solutions, you can contact the after-sales staff for consultation.
42 changes: 40 additions & 2 deletions docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md
Original file line number Diff line number Diff line change
Expand Up @@ -277,12 +277,50 @@ The Dag Controller can perform complex graph computing with NebulaGraph Analytic
exec_file: /home/xxx/nebula-analytics/scripts/run_algo.sh
```

## Directory structure

The structure of the Explorer Enterprise Edition is as follows:

```bash
├── CMakeLists.txt # CMake configuration files
|
├── config # Configuration files
│  
├── dag-ctrl # Dag Controller installation directory
│  
├── scripts # Scripts for managing services
│  
├── tmp # Temporary files
|
└── nebula-explorer-server # Explorer service application
```

## View logs

Users can view the Explorer Enterprise Edition logs in the `logs` directory.

For example:

```
cat logs/access.log
```

The descriptions of the log files are as follows.

|Log file| Description |
|:--|:--|
|`access.log`| Access log. Records all request messages for accessing the services, including request time, source address, requested URL, HTTP method, returned HTTP status code, etc.</br>It takes effect only when the `Log.Mode` in the Explorer configuration is `file`. |
|`error.log`| Error log. Records error messages that occur during service running. This may include runtime errors, system errors, service logic errors, etc.</br>It takes effect only when the `Log.Mode` in the Explorer configuration is `file`. |
|`severe.log`| Severe log. Records error messages that could cause the system to crash, or seriously affect the correct functioning of the system. This may include runtime errors, system errors, serious service logic errors, etc.</br>It takes effect only when the `Log.Mode` in the Explorer configuration is `file`. |
|`slow.log`| Slow log. Records requests or operations whose execution time exceeds a preset threshold, helping users identify performance bottlenecks.</br>It takes effect only when the `Log.Mode` in the Explorer configuration is `file`. |
|`stat.log`| Statistic log. Records statistical information about the service, the content of which depends on the needs of the application and may include a variety of performance metrics, usage statistics, etc.</br>It takes effect only when the `Log.Mode` in the Explorer configuration is `file`. |

## Configuration file description

```yaml
Name: explorer
Version: {{explorer.release}}
Database: yueshu
Database: nebula
Host: 0.0.0.0 # Specifies the address where explorer can be accessed.
Port: 7002 # The default access port for explorer.
Expand Down Expand Up @@ -346,7 +384,7 @@ IframeMode:
Any source is allowed by default.
# Origins: # The source whitelist of iframe. Any source is allowed by default.
# - "http://192.168.8.8"
LicenseManagerURL: http://192.168.8.100:9119 # license manager url.
LicenseManagerURL: http://192.168.8.100:9119 # License manager url.
CorsOrigins: [] # The list of domains that are allowed to initiate cross-domain requests.
```

Expand Down
34 changes: 34 additions & 0 deletions docs-2.0/nebula-explorer/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -84,3 +84,37 @@ If the port is not opened, an error similar to the following may be reported:
## How to resolve the error `broadcast.hpp:193] Check failed: (size_t)recv_bytes >= sizeof(chunk_tail_t) recv message too small: 0`?

The amount of data to be processed is too small, but the number of compute nodes and processes is too large. Smaller `clusterSize` and `processes` need to be set when submitting jobs.

## How to implement a highly available architecture

Users can use third-party high-availability software (e.g. [HAProxy](https://www.haproxy.org/)) to implement the high-availability architecture for Explorer and the high-availability architecture for LM.

For example, you can deploy Explorer service and database service on multiple machines. Then use HAProxy to implement their respective load balancing.

Then fill in the external interfaces of database service into the configuration of the Explorer, as shown in the example below:

```yaml
# The deployment mode of explorer, supports single and multiple instances.The optional values are single and multi.
# In multi-instance mode, local storage service (data import) will be disabled to ensure data consistency between instances.
AppInstance: "multi"

# Database configuration
DB:
Enable: true
LogLevel: 4 # Database runtime log levels. 1, 2, 3, and 4 correspond to Silent, ERROR, Warn, and INFO, respectively.
IgnoreRecordNotFoundError: false
AutoMigrate: true # Whether or not to automatically create database tables. The default is true.
Type: "mysql" # The type of database used in the backend. Supports mysql and sqlite3. PolarDB is fully compatible with MySQL, if it is PolarDB, just fill in mysql.
Host: "192.168.8.200:3306" # The external IP and port for the high availability database service.
Name: "nebula" # Database name.
User: "root" # Database username.
Password: "123456" # Database password.
# SqliteDbFilePath: "./data/tasks.db" # This parameter is required for sqlite3 only. The address of the database file.
MaxOpenConns: 30 # Maximum number of active connections in the connection pool.
MaxIdleConns: 10 # Maximum number of free connections in the connection pool.
LicenseManagerURL: http://192.168.8.100:9119 # License manager url.
```
Finally, just access the external interface of Explorer provided by HAProxy.
For detailed solutions, you can contact the after-sales staff for consultation.
2 changes: 1 addition & 1 deletion mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -615,7 +615,7 @@ nav:
# - Node: nebula-dashboard-ent/4.cluster-operator/operator/node.md
# - Scale: nebula-dashboard-ent/4.cluster-operator/operator/scale.md
# - Service: nebula-dashboard-ent/4.cluster-operator/operator/service.md
# - Config Management: nebula-dashboard-ent/4.cluster-operator/operator/config-management.md
# - Config Management: nebula-dashboard-ent/4.cluster-operator/operator/update-config.md
# - Version upgrade: nebula-dashboard-ent/4.cluster-operator/operator/version-upgrade.md
# - Backup and restore: nebula-dashboard-ent/4.cluster-operator/operator/backup-and-restore.md
# - Analysis:
Expand Down

0 comments on commit dcb0df0

Please sign in to comment.