Browse Source

[doc] Modified alert doc files (#10714)

3.1.0-release
sneh-wha 3 years ago committed by GitHub
parent
commit
0cdae777ab
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
  1. 14
      docs/docs/en/guide/alert/alert_plugin_user_guide.md
  2. 34
      docs/docs/en/guide/alert/dingtalk.md
  3. 4
      docs/docs/en/guide/alert/email.md
  4. 33
      docs/docs/en/guide/alert/enterprise-webexteams.md
  5. 4
      docs/docs/en/guide/alert/enterprise-wechat.md
  6. 21
      docs/docs/en/guide/alert/http.md
  7. 17
      docs/docs/en/guide/alert/script.md
  8. 39
      docs/docs/en/guide/alert/telegram.md

14
docs/docs/en/guide/alert/alert_plugin_user_guide.md

@ -1,18 +1,22 @@
# Alert Component User Guide # Alert Component User Guide
## How to Create Alert Plugins and Alert Groups ## Alert Plugins and Alert Groups Creation
In version 2.0.0, users need to create alert instances, and needs to choose an alarm policy when defining an alarm instance, there are three options: send if the task succeeds, send on failure, and send on both success and failure. when the workflow or task is executed, if an alarm is triggered, calling the alarm instance send method needs a logical judgment, which matches the alarm instance with the task status, executes the alarm instance sending logic if it matches, and filters if it does not match. When create alert instances then associate them with alert groups. Alert group can use multiple alert instances. In version 2.0.0, users need to create alert instances, and needs to choose an alarm policy when defining an alarm instance, there are three options: send if the task succeeds, send on failure, and send on both success and failure. when the workflow or task is executed, if an alarm is triggered, calling the alarm instance send method needs a logical judgment, which matches the alarm instance with the task status, executes the alarm instance sending logic if it matches, and filters if it does not match. When create alert instances then associate them with alert groups. Alert group can use multiple alert instances.
The alarm module supports the following scenarios: The alarm module supports the following scenarios:
<img src="../../../../img/alert/alert_scenarios_en.png">
The steps to use are as follows: <img src="../../../../img/alert/alert_scenarios_en.png">
First, go to the Security Center page. Select Alarm Group Management, click Alarm Instance Management on the left and create an alarm instance. Select the corresponding alarm plug-in and fill in the relevant alarm parameters. Steps to be used are as follows:
Then select Alarm Group Management, create an alarm group, and choose the corresponding alarm instance. - Go to `Security -> Alarm Group Management -> Alarm Instance Management -> Alarm Instance`.
- Select the corresponding alarm plug-in and fill in the relevant alarm parameters.
- Select `Alarm Group Management`, create an alarm group, and choose the corresponding alarm instance.
![alert-instance01](../../../../img/new_ui/dev/alert/alert_instance01.png) ![alert-instance01](../../../../img/new_ui/dev/alert/alert_instance01.png)
![alert-instance02](../../../../img/new_ui/dev/alert/alert_instance02.png) ![alert-instance02](../../../../img/new_ui/dev/alert/alert_instance02.png)
![alert-instance03](../../../../img/new_ui/dev/alert/alert_instance03.png) ![alert-instance03](../../../../img/new_ui/dev/alert/alert_instance03.png)
![alert-instance04](../../../../img/new_ui/dev/alert/alert_instance04.png) ![alert-instance04](../../../../img/new_ui/dev/alert/alert_instance04.png)

34
docs/docs/en/guide/alert/dingtalk.md

@ -1,27 +1,25 @@
# DingTalk # DingTalk
If you need to use `DingTalk` for alerting, create an alert instance in the alert instance management and select the DingTalk plugin. If you need to use `DingTalk` for alerting, create an alert instance in the alert instance management and select the `DingTalk` plugin. The following shows the `DingTalk` configuration example:
The following shows the `DingTalk` configuration example:
![alert-dingtalk](../../../../img/new_ui/dev/alert/alert_dingtalk.png) ![alert-dingtalk](../../../../img/new_ui/dev/alert/alert_dingtalk.png)
## Parameter Configuration ## Parameter Configuration
* Webhook | **Parameter** | **Description** |
> The format is: https://oapi.dingtalk.com/robot/send?access_token=XXXXXX | --- | --- |
* Keyword | Warning Type | Alert on success or failure or both. |
> Custom keywords for security settings | WebHook | The format is: [https://oapi.dingtalk.com/robot/send?access\_token=XXXXXX](https://oapi.dingtalk.com/robot/send?access_token=XXXXXX) |
* Secret | Keyword | Custom keywords for security settings. |
> Signature of security settings | Secret | Signature of security settings |
* MessageType | Msg Type | Message parse type (support txt, markdown, markdownV2, html). |
> Support both text and markdown types | At User Mobile | When a custom bot sends a message, you can specify the "@person list" by their mobile phone number. When the selected people in the "@people list" receive the message, there will be a `@` message reminder. `No disturb` mode always receives reminders, and "someone @ you" appears in the message. The "At User Mobile" represents mobile phone number of the "@person" |
| At User Ids | The user ID by "@person" |
| Proxy | The proxy address of the proxy server. |
| Port | The proxy port of Proxy-Server. |
| User | Authentication(Username) for the proxy server. |
| Password | Authentication(Password) for the proxy server. |
When a custom bot sends a message, you can specify the "@person list" by their mobile phone number. When the selected people in the "@people list" receive the message, there will be a `@` message reminder. `No disturb` mode always receives reminders, and "someone @ you" appears in the message. ## Reference
* @Mobiles
> The mobile phone number of the "@person"
* @UserIds
> The user ID by "@person"
* @All
> @Everyone
[DingTalk Custom Robot Access Development Documentation](https://open.dingtalk.com/document/robots/custom-robot-access) - [DingTalk Custom Robot Access Development Documentation](https://open.dingtalk.com/document/robots/custom-robot-access)

4
docs/docs/en/guide/alert/email.md

@ -1,6 +1,10 @@
# Email # Email
If you need to use `Email` for alerting, create an alert instance in the alert instance management and select the Email plugin. If you need to use `Email` for alerting, create an alert instance in the alert instance management and select the Email plugin.
The following shows the `Email` configuration example: The following shows the `Email` configuration example:
![alert-email](../../../../img/alert/email-alter-setup1-en.png) ![alert-email](../../../../img/alert/email-alter-setup1-en.png)
![alert-email](../../../../img/alert/email-alter-setup2-en.png) ![alert-email](../../../../img/alert/email-alter-setup2-en.png)
![alert-email](../../../../img/alert/email-alter-setup3-en.png) ![alert-email](../../../../img/alert/email-alter-setup3-en.png)

33
docs/docs/en/guide/alert/enterprise-webexteams.md

@ -1,27 +1,22 @@
# Webex Teams # Webex Teams
If you need to use `Webex Teams` to alert, create an alert instance in the alert instance management, and choose the WebexTeams plugin. If you need to use `Webex Teams` to alert, create an alert instance in the alert instance management, and choose the WebexTeams plugin. You can pick private alert or room group chat alert.
You can pick private alert or room group chat alert.
The following is the `WebexTeams` configuration example: The following is the `WebexTeams` configuration example:
![enterprise-webexteams-plugin](../../../../img/alert/enterprise-webexteams-plugin.png) ![enterprise-webexteams-plugin](../../../../img/alert/enterprise-webexteams-plugin.png)
## Parameter Configuration ## Parameter Configuration
* botAccessToken | **Parameter** | **Description** |
> The robot's access token | --- | --- |
* roomID | botAccessToken | The access token of robot. |
> The ID of the room that receives message (only support one room ID) | roomID | The ID of the room that receives message (only support one room ID). |
* toPersonId | toPersonId | The person ID of the recipient when sending a private 1:1 message. |
> The person ID of the recipient when sending a private 1:1 message | toPersonEmail | The email address of the recipient when sending a private 1:1 message. |
* toPersonEmail | atSomeoneInRoom | If the message destination is room, the emails of the person being @, use `,` (eng commas) to separate multiple emails. |
> The email address of the recipient when sending a private 1:1 message | destination |The destination of the message (one message only support one destination). |
* atSomeoneInRoom
> If the message destination is room, the emails of the person being @, use `,` (eng commas) to separate multiple emails ## Create Bot
* destination
> The destination of the message (one message only support one destination)
## Create a Bot
Create a bot visit [Official Website My-Apps](https://developer.webex.com/my-apps) to `Create a New APP` and select `Create a Bot`, fill in the bot information and acquire `bot username` and `bot ID` for further usage. Create a bot visit [Official Website My-Apps](https://developer.webex.com/my-apps) to `Create a New APP` and select `Create a Bot`, fill in the bot information and acquire `bot username` and `bot ID` for further usage.
@ -60,5 +55,7 @@ The `Room ID` we can acquire it from the `id` of creating a new group chat room
![enterprise-webexteams-room-message-example](../../../../img/alert/enterprise-webexteams-room-msg.png) ![enterprise-webexteams-room-message-example](../../../../img/alert/enterprise-webexteams-room-msg.png)
[WebexTeams Application Bot Guide](https://developer.webex.com/docs/bots) ## References:
[WebexTeams Message Guide](https://developer.webex.com/docs/api/v1/messages/create-a-message)
- [WebexTeams Application Bot Guide](https://developer.webex.com/docs/bots)
- [WebexTeams Message Guide](https://developer.webex.com/docs/api/v1/messages/create-a-message)

4
docs/docs/en/guide/alert/enterprise-wechat.md

@ -66,6 +66,6 @@ The following is the `create new group chat` API and `query userId` API example:
![enterprise-wechat-create-group](../../../../img/alert/enterprise-wechat-query-userid.png) ![enterprise-wechat-create-group](../../../../img/alert/enterprise-wechat-query-userid.png)
#### References ## Reference
Group Chat:https://work.weixin.qq.com/api/doc/90000/90135/90248 - Group Chat:https://work.weixin.qq.com/api/doc/90000/90135/90248

21
docs/docs/en/guide/alert/http.md

@ -4,29 +4,26 @@ If you need to use `Http script` for alerting, create an alert instance in the a
## Parameter Configuration ## Parameter Configuration
* URL | **Parameter** | **Description** |
> The `Http` request URL needs to contain protocol, host, path and parameters if the method is `GET` | --- | --- |
* Request Type | URL | The `Http` request URL needs to contain protocol, host, path and parameters if the method is `GET`. |
> Select the request type from `POST` or `GET` | Request Type | Select the request type from `POST` or `GET`. |
* Headers | Headers | The headers of the `Http` request in JSON format. |
> The headers of the `Http` request in JSON format | Body | The request body of the `Http` request in JSON format, when using `POST` method to alert. |
* Body | Content Field | The field name to place the alert information. |
> The request body of the `Http` request in JSON format, when using `POST` method to alert
* Content Field
> The field name to place the alert information
## Send Type ## Send Type
Using `POST` and `GET` method to send `Http` request in the `Request Type`. Using `POST` and `GET` method to send `Http` request in the `Request Type`.
### GET Http ### GET HTTP
Send alert information by `Http` GET method. Send alert information by `Http` GET method.
The following shows the `GET` configuration example: The following shows the `GET` configuration example:
![enterprise-wechat-app-msg-config](../../../../img/alert/http-get-example.png) ![enterprise-wechat-app-msg-config](../../../../img/alert/http-get-example.png)
### POST Http ### POST HTTP
Send alert information inside `Http` body by `Http` POST method. Send alert information inside `Http` body by `Http` POST method.
The following shows the `POST` configuration example: The following shows the `POST` configuration example:

17
docs/docs/en/guide/alert/script.md

@ -1,4 +1,4 @@
# DingTalk # Script
If you need to use `Shell script` for alerting, create an alert instance in the alert instance management and select the `Script` plugin. If you need to use `Shell script` for alerting, create an alert instance in the alert instance management and select the `Script` plugin.
The following shows the `Script` configuration example: The following shows the `Script` configuration example:
@ -7,11 +7,12 @@ The following shows the `Script` configuration example:
## Parameter Configuration ## Parameter Configuration
* User Params | **Parameter** | **Description** |
> User defined parameters will pass to the script. | --- | --- |
* Script Path | User Params | User defined parameters will pass to the script. |
> The file location path in the server. | Script Path |The file location path in the server. |
* Type | Type | Support `Shell` script. |
> Support `Shell` script.
**_Notice:_** please consider the script file access privileges with the executing tenant. ### Note
Consider the script file access privileges with the executing tenant.

39
docs/docs/en/guide/alert/telegram.md

@ -7,26 +7,21 @@ The following shows the `Telegram` configuration example:
## Parameter Configuration ## Parameter Configuration
* WebHook: | **Parameter** | **Description** |
> The WebHook of Telegram when use robot to send message | --- | --- |
* botToken | WebHook | The WebHook of Telegram when use robot to send message. |
> The robot's access token | botToken | The access token of robot. |
* chatId | chatId | Sub Telegram Channel. |
> Sub Telegram Channel | parseMode | Message parse type (support txt, markdown, markdownV2, html). |
* parseMode | EnableProxy | Enable proxy sever. |
> Message parse type (support txt, markdown, markdownV2, html) | Proxy | The proxy address of the proxy server. |
* EnableProxy | Port | The proxy port of proxy server. |
> Enable proxy sever | User | Authentication(Username) for the proxy server. |
* Proxy | Password | Authentication(Password) for the proxy server. |
> the proxy address of the proxy server
* Port ### NOTE
> the proxy port of Proxy-Server
* User The webhook needs to be able to receive and use the same JSON body of HTTP POST that DolphinScheduler constructs and the following shows the JSON body:
> Authentication(Username) for the proxy server
* Password
> Authentication(Password) for the proxy server
**NOTICE**:The webhook needs to be able to receive and use the same JSON body of HTTP POST that DolphinScheduler constructs and the following shows the JSON body:
```json ```json
{ {
@ -35,8 +30,8 @@ The following shows the `Telegram` configuration example:
} }
``` ```
References: ## References:
- [Telegram Application Bot Guide](https://core.telegram.org/bots) - [Telegram Application Bot Guide](https://core.telegram.org/bots)
- [Telegram Bots Api](https://core.telegram.org/bots/api) - [Telegram Bots Api](https://core.telegram.org/bots/api)
- [Telegram SendMessage Api](https://core.telegram.org/bots/api#sendmessage) - [Telegram SendMessage Api](https://core.telegram.org/bots/api#sendmessage)

Loading…
Cancel
Save