Skip to content

ASB-3754 Add log file integration docs and cleanup integration section #59

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 9 commits into from
Aug 15, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file removed docs/img/AddConfigSLACK.png
Binary file not shown.
Binary file removed docs/img/addslackapp.png
Binary file not shown.
Binary file removed docs/img/incomingwebhook.gif
Binary file not shown.
10 changes: 5 additions & 5 deletions docs/integrations/email-integration.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
# Setup SMTP notifications

# Setup SMTP / Email Notifications

On the Axonops application menu, select `Settings -> Integrations` .

`Click` on the `SMTP` area.
Click on the `SMTP` area.

!!! infomy

[![slack](./0.JPG)](./0.JPG)
[![slack](imgs/integrations.jpg)](imgs/integrations.jpg)

Fill in the appropriate details.

[![Routing key](./email.JPG)](./email.JPG)
[![Routing key](imgs/email-2.jpg)](imgs/email-2.jpg)

File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
Binary file added docs/integrations/imgs/slack-4.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
15 changes: 15 additions & 0 deletions docs/integrations/log-file-integration.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
# Send Notifications to Log Files

Unlike the other integrations, the Log Files Integration is configured by adding the `alert_log` key to your `axon-server.yml`, typically located at `/etc/axonops/axon-server.yml`.

When `alert_log.enabled` is `true`, logs will be written to `alert_log.path` for consumption by external services like Splunk.

```yaml
alert_log:
enabled: true
path: /var/log/axonops/axon-server-alert.log
max_size_mb: 50
max_files: 5
```

`max_size_mb` and `max_files` are used to define how log rotation is handled.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The main intended change.

49 changes: 22 additions & 27 deletions docs/integrations/microsoft-teams-integration.md
Original file line number Diff line number Diff line change
@@ -1,36 +1,31 @@
# Setup Microsoft Teams notifications
# Setup Microsoft Teams Integration

## Create Microsoft Teams Webhook

### Create Microsoft Teams Webhooks
On the Microsoft Teams interface, go to `Connectors`.

* On the Microsoft Teams interface, go to `Connectors`
<kbd>
![](2022-09-20-14-39-01.png)
</kbd>
![](imgs/teams-1.png)

<hr></hr>
* Click on configure on the `Incoming Webhook` connector
<kbd>
![](2022-09-20-14-27-58.png)
</kbd>
`Configure` the `Incoming Webhook` connector.

<hr></hr>
* Provide a name and select `Create`
<kbd>
![](2022-09-20-14-28-17.png)
</kbd>
![](imgs/teams-2.png)

<hr></hr>
* Copy the url provided to the clipboard
<kbd>
![](2022-09-20-14-28-45.png)
</kbd>
Provide a name and select `Create`.

<hr></hr>
* On the Axonops application menu, select `Settings -> Integrations`
* `Click` on the `Microsoft Teams` area.
![](imgs/teams-3.png)

![](2022-09-20-11-08-58.png)
Copy the url provided to the clipboard.

* Enter a `name` and copy the url in the `Webhook URL` field and select `Create`
![](2022-09-20-11-10-34.png)
![](imgs/teams-4.png)

## Create the Microsoft Teams Integration on axon-server

On the AxonOps application menu, select `Settings -> Integrations`.

Click on the `Microsoft Teams` area.

![](imgs/integrations.png)

Enter a `name`, copy the url in the `Webhook URL` field, and select `Create`.

![](imgs/teams-6.png)
17 changes: 9 additions & 8 deletions docs/integrations/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,17 +4,18 @@ The functionality is accessible via ***Settings > Integrations***

The current integrations are:

* SMTP
* Pagerduty
* Slack
* Microsoft Teams
* ServiceNow
* OpsGennie
* [SMTP / Email](email-integration.md)
* [Pagerduty](pagerduy-integration.md)
* [Slack](slack-integration.md)
* [Microsoft Teams](microsoft-teams-integration.md)
* [ServiceNow](servicenow-integration.md)
* OpsGenie
* Generic webhooks
* [Log file](log-file-integration.md) (configurable through `axon-server.yml`)
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added hyperlinks here.


!!! infomy

![](2022-09-20-11-08-58.png)
![](imgs/integrations.png)



Expand All @@ -34,7 +35,7 @@ The current routing options are:

Each severity (`info, warning, error`) can be routed independently

![](./routing.JPG)
![](imgs/routing.jpg)

### Errors per routing mechanism and severity levels

Expand Down
14 changes: 5 additions & 9 deletions docs/integrations/pagerduy-integration.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,8 @@
# Setup Pagerduty

# Setup Pagerduty Integration

### Create Pagerduty Routing Key

Using these [steps][1]. Please note down the pagerduty ***routing key***

[1]: https://support.pagerduty.com/docs/services-and-integrations
Using these [steps](https://support.pagerduty.com/docs/services-and-integrations){target="_blank"}, note the pagerduty `routing key`.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Standardizing on using {target="_blank"} for external resources.



### Insert Pagerduty Routing Key
Expand All @@ -16,10 +13,9 @@ On the Axonops application menu, select `Settings -> Integrations` .

!!! infomy

[![slack](./0.JPG)](./0.JPG)
[![slack](imgs/integrations.png)](imgs/integrations.png)

Add the Pagerduty `routing key` from the previous step into the `integration_key` field.



[![Routing key](./pd.JPG)](./pd.JPG)
[![Routing key](imgs/pagerduty-2.jpg)](imgs/pagerduty-2.jpg)

20 changes: 13 additions & 7 deletions docs/integrations/servicenow-integration.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,19 @@
Navigate to ***Settings > Integrations*** and click on ***ServiceNow***
# Setup ServiceNow Integration

![](2021-01-11-12-11-59.png)
## Login to ServiceNow

Once you have gathered your **instance name**, **username** and **password** from ServiceNow, you can validate the form:
![](2021-01-11-11-45-57.png)
Navigate to `Settings -> Integrations` and click on `ServiceNow`.

![](imgs/servicenow-1.png)

> If you want to see the detailed description of a notification, you'll need to add the `description` field from ServiceNow incidents templates.
Gather the `instance name`, `username`, and `password` from ServiceNow to fill out the form:
![](imgs/servicenow-2.png)

![](2021-01-11-12-06-23.png)
## Update ServiceNow Incident Template

If you want to see the detailed description of a notification, you'll need to add the `description` field into the ServiceNow incidents templates.

![](imgs/servicenow-3.png)

![](imgs/servicenow-4.png)

![](2021-01-11-12-02-26.png)
40 changes: 16 additions & 24 deletions docs/integrations/slack-integration.md
Original file line number Diff line number Diff line change
@@ -1,54 +1,46 @@
# Setup Slack

# Setup Slack Integration

### Create Slack Incoming Webhooks

* Go to Slack `Application`
* On the side menu click [![addslackapp](../img/addslackapp.png)](../img/addslackapp.png)
* In search box type `Incoming Webhook`s
* From the App directory click `Install` on `Incoming WebHooks App`.


!!! infomy

[![incomingwebhook](../img/incomingwebhook.gif)](../img/incomingwebhook.gif)
Add the [Incoming WebHooks](https://slack.com/marketplace/A0F7XDUAZ-incoming-webhooks){target="_blank"} app to Slack.

* `Click` Add Configuration
> Note: Ensure you're on the correct Slack Workspace by using the Workspace indicator on the top left.

!!! infomy

[![AddConfigSLACK](../img/AddConfigSLACK.png)](../img/AddConfigSLACK.png)

* In `Post to Channel` Box select an option from the `choose a channel` dropdown menu .
In the `Post to Channel` Box, select an option from the `Choose a channel...` dropdown menu.

* `Click` `Add Incoming WebHooks Integration`
Click `Add Incoming WebHooks Integration`.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Rewrote the above section since it seems like things had changed and using a direct link seemed cleaner, since it's always a struggle for me to navigate to Slack Workspace settings.


!!! infomy

[![ChannelBoxSLACK](../img/ChannelBoxSLACK.png)](../img/ChannelBoxSLACK.png)
[![ChannelBoxSLACK](imgs/slack-1.png)](imgs/slack-1.png)

* `Copy` and make a note of the `WebHook URL` that appears in the `Setup Instructions`.
Copy and make a note of the `WebHook URL` that appears in the `Setup Instructions`.

!!! infomy

[![SetupInstrucSLACK](../img/SetupInstrucSLACK.png)](../img/SetupInstrucSLACK.png)
[![SetupInstrucSLACK](imgs/slack-2.png)](imgs/slack-2.png)


### Creating the Slack integration on axon-server

On the Axonops application menu, select `Settings -> Integrations` .

`Click` on the `Slack` area.
Click on the `Slack` area.

!!! infomy

[![slack](./0.JPG)](./0.JPG)
[![slack](imgs/integrations.png)](imgs/integrations.png)


[1]: #create-slack-incoming-webhooks

Add the `Webhook URL` from the previous step into the `url` field.

Optionally, set the `Channel` field to send alerts to a channel other than the default channel
that was defined when the WebHooks Integration was added to the Slack Workspace.

!!! infomy

[![slack](./slack.JPG)](./slack.JPG)
[![slack](imgs/slack-4.png)](imgs/slack-4.png)


Binary file removed docs/integrations/slack.JPG
Binary file not shown.
7 changes: 4 additions & 3 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -203,11 +203,12 @@ nav:

- Notification Integrations:
- Overview : 'integrations/overview.md'
- PagerDuty Integration: 'integrations/pagerduy-integration.md'
- Slack Integration: 'integrations/slack-integration.md'
- PagerDuty: 'integrations/pagerduy-integration.md'
- Slack: 'integrations/slack-integration.md'
- Microsoft Teams: 'integrations/microsoft-teams-integration.md'
- ServiceNow: 'integrations/servicenow-integration.md'
- Email Integration: 'integrations/email-integration.md'
- SMTP / Email: 'integrations/email-integration.md'
- Log Files: 'integrations/log-file-integration.md'
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Standardized the heading since Integrations is already at the top-level.


- How-to:
- Setup Alert Rules: how-to/setup-alert-rules.md
Expand Down