Skip to content
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

SUMO-254678: Doc update Database apps migration V1 to V2 #5009

Open
wants to merge 37 commits into
base: main
Choose a base branch
from
Open
Changes from 1 commit
Commits
Show all changes
37 commits
Select commit Hold shift + click to select a range
e4233c0
SUMO-254678: Doc update Database apps migration V1 to V2
chetanchoudhary-sumo Jan 29, 2025
6643ff6
Updating monitor part
chetanchoudhary-sumo Jan 29, 2025
a44f0ee
updating fields section
chetanchoudhary-sumo Jan 29, 2025
4d9206f
updating FER section
chetanchoudhary-sumo Jan 29, 2025
a6d64e0
Merge branch 'main' into v1v2migration-db-apps-doc-updates
kimsauce Jan 30, 2025
1e67c7c
Fixing Fields section
chetanchoudhary-sumo Jan 30, 2025
d3f313d
Merge remote-tracking branch 'refs/remotes/origin/v1v2migration-db-ap…
chetanchoudhary-sumo Jan 30, 2025
dde2b09
Addressing review comments from PR #5017
chetanchoudhary-sumo Feb 3, 2025
5e56bf6
Update sql-server.md
amee-sumo Feb 3, 2025
35947f8
Update docs/integrations/amazon-aws/dynamodb.md
chetanchoudhary-sumo Feb 4, 2025
11df94a
Update docs/integrations/amazon-aws/dynamodb.md
chetanchoudhary-sumo Feb 4, 2025
c025cb1
Update docs/integrations/amazon-aws/dynamodb.md
chetanchoudhary-sumo Feb 4, 2025
21f2c0c
Update docs/integrations/databases/cassandra.md
chetanchoudhary-sumo Feb 4, 2025
d2b2779
Update docs/integrations/databases/cassandra.md
chetanchoudhary-sumo Feb 4, 2025
87390a5
Update docs/integrations/databases/cassandra.md
chetanchoudhary-sumo Feb 4, 2025
51d7c7e
Update docs/integrations/databases/couchbase.md
chetanchoudhary-sumo Feb 4, 2025
8332e5e
Update docs/integrations/databases/couchbase.md
chetanchoudhary-sumo Feb 4, 2025
c02a514
Update docs/integrations/databases/couchbase.md
chetanchoudhary-sumo Feb 4, 2025
871dc6d
Update docs/integrations/databases/mariadb.md
chetanchoudhary-sumo Feb 4, 2025
3b6ae78
Update docs/integrations/microsoft-azure/sql-server.md
chetanchoudhary-sumo Feb 4, 2025
6d71bdd
Update docs/observability/application-components.md
chetanchoudhary-sumo Feb 4, 2025
50fb40c
Update docs/integrations/databases/mysql.md
chetanchoudhary-sumo Feb 4, 2025
cf2dcbc
Update docs/integrations/databases/redis.md
chetanchoudhary-sumo Feb 4, 2025
75aeeb8
Update docs/integrations/databases/oracle.md
chetanchoudhary-sumo Feb 4, 2025
b10a1cf
Update docs/integrations/databases/mariadb.md
chetanchoudhary-sumo Feb 4, 2025
a5052b0
Update docs/integrations/databases/mariadb.md
chetanchoudhary-sumo Feb 4, 2025
aec6c18
Update docs/integrations/databases/memcached.md
chetanchoudhary-sumo Feb 4, 2025
593c49f
Update docs/integrations/databases/memcached.md
chetanchoudhary-sumo Feb 4, 2025
6d149e1
Update docs/integrations/databases/memcached.md
chetanchoudhary-sumo Feb 4, 2025
ead4389
Update docs/integrations/databases/mongodb.md
chetanchoudhary-sumo Feb 4, 2025
534d2ac
Update docs/integrations/databases/mongodb.md
chetanchoudhary-sumo Feb 4, 2025
fbccf2a
Update docs/integrations/databases/mongodb.md
chetanchoudhary-sumo Feb 4, 2025
59911bb
Update docs/integrations/databases/mongodb.md
chetanchoudhary-sumo Feb 4, 2025
efc20dd
Apply suggestions from code review
chetanchoudhary-sumo Feb 4, 2025
0cb57e2
Apply suggestions from code review
chetanchoudhary-sumo Feb 4, 2025
80d83ab
Merge branch 'main' into v1v2migration-db-apps-doc-updates
chetanchoudhary-sumo Feb 4, 2025
0062af6
Reverting DynamoDB documentation
chetanchoudhary-sumo Feb 4, 2025
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
Next Next commit
SUMO-254678: Doc update Database apps migration V1 to V2
chetanchoudhary-sumo committed Jan 29, 2025

Verified

This commit was created on GitHub.com and signed with GitHub’s verified signature.
commit e4233c009f7c02c76fa0a4ba335d21d126dbe568
92 changes: 7 additions & 85 deletions docs/integrations/databases/cassandra.md
Original file line number Diff line number Diff line change
@@ -522,91 +522,7 @@ At this point, Cassandra metrics and logs should start flowing into Sumo Logic.
</TabItem>
</Tabs>

## Installing Cassandra Monitors

:::note
This step is not needed if you are using the [Application Components Solution](/docs/observability/application-components) Terraform script.
:::

To install these monitors, you must have the **Manage Monitors** role capability. You can install monitors by importing a JSON file or using a Terraform script.

Sumo Logic has provided pre-packaged alerts available through [Sumo Logic monitors](/docs/alerts/monitors) to help you proactively determine if a Cassandra cluster is available and performing as expected. These monitors are based on metric and log data and include pre-set thresholds that reflect industry best practices and recommendations. For more information about individual alerts, see [Cassandra Alerts](#cassandra-alerts).

There are limits to how many alerts can be enabled. For more information, see [Monitors](/docs/alerts/monitors/create-monitor) for details.

### Method A: Importing a JSON file

1. Download the [JSON file](https://github.com/SumoLogic/terraform-sumologic-sumo-logic-monitor/blob/main/monitor_packages/Memcached/Memcached.json) that describes the monitors.
2. The [JSON](https://github.com/SumoLogic/terraform-sumologic-sumo-logic-monitor/blob/main/monitor_packages/Memcached/Memcached.json) contains the alerts that are based on Sumo Logic searches that do not have any scope filters and therefore will be applicable to all Cassandra clusters, the data for which has been collected via the instructions in the previous sections.

However, if you would like to restrict these alerts to specific clusters or environments, update the JSON file by replacing the text `db_cluster=*` with `<Your Custom Filter>`. Custom filter examples:
* For alerts applicable only to a specific cluster, your custom filter would be: `db_cluster=dev-cassandra-01`.
* For alerts applicable to all clusters that start with `cassandra-prod`, your custom filter would be: `db_cluster=cassandra-prod*`.
* For alerts applicable to specific clusters, within a production environment, your custom filter would be:`db_cluster=dev-cassandra-01` AND `environment=prod`. This assumes you have set the optional environment tag while configuring collection.
3. [**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the main Sumo Logic menu, select **Manage Data > Monitoring > Monitors**. <br/>[**New UI**](/docs/get-started/sumo-logic-ui). In the main Sumo Logic menu, select **Alerts > Monitors**. You can also click the **Go To...** menu at the top of the screen and select **Monitors**.
4. Click **Add**.
5. Click **Import**.
6. On the **Import Content popup**, enter **Cassandra** in the Name field, paste the JSON into the popup, and click **Import**.
7. The monitors are created in a "Cassandra" folder. The monitors are disabled by default. See the [Monitors](/docs/alerts/monitors) topic for information about enabling monitors and configuring notifications or connections.

### Method B: Using a Terraform script

1. Generate an access key and access ID for a user that has the **Manage Monitors** role capability. For instructions, see [Access Keys](/docs/manage/security/access-keys).
2. Download [Terraform 0.13](https://www.terraform.io/downloads.html) or later and install it.
3. Download the Sumo Logic Terraform package for Cassandra monitors. The alerts package is available in the Sumo Logic GitHub [repository](https://github.com/SumoLogic/terraform-sumologic-sumo-logic-monitor/tree/main/monitor_packages/Memcached). You can either download it using the git clone command or as a zip file.
4. Alert Configuration. After extracting the package, navigate to the `terraform-sumologic-sumo-logic-monitor/monitor_packages/Cassandra/` directory.
5. Edit the Cassandra.auto.tfvars file and add the Sumo Logic Access Key and Access ID from Step 1 and your Sumo Logic deployment. If you're not sure of your deployment, see [Sumo Logic Endpoints and Firewall Security](/docs/api/getting-started#sumo-logic-endpoints-by-deployment-and-firewall-security).
```bash
access_id = "<SUMOLOGIC ACCESS ID>"
access_key = "<SUMOLOGIC ACCESS KEY>"
environment = "<SUMOLOGIC DEPLOYMENT>"
```
6. The Terraform script installs the alerts without any scope filters, if you would like to restrict the alerts to specific clusters or environments, update the `cassandra_data_source` variable. For example:
* To configure alerts for a specific cluster, set `cassandra_data_source` to something like `db_cluster=cassandra.prod.01`
* To configure alerts for all clusters in an environment, set `cassandra_data_source` to something like `environment=prod`
* To configure alerts for multiple clusters using a wildcard, set `cassandra_data_source` to something like `db_cluster=cassandra-prod*`
* To configure alerts for...A specific clusters within a specific environment, set `cassandra_data_source` to something like `db_cluster=cassandra-1` and `environment=prod`. This assumes you have configured and applied Fields as described [Configure Fields in Sumo Logic](#step-1-configure-fields-in-sumo-logic) step.

All monitors are disabled by default on installation. To enable all of the monitors, set the `monitors_disabled` parameter to `false`. By default, the monitors will be located in a "Cassandra" folder on the **Monitors** page. To change the name of the folder, update the monitor folder name in the folder variable in the `Cassandra.auto.tfvars` file.

7. If you want your alerts to send email or connection notifications, edit the `Cassandra_notifications.auto.tfvars` file to populate the `connection_notifications` and `email_notifications` sections. Examples are provided below.

In the variable definition below, replace `<CONNECTION_ID>` with the connection ID of the Webhook connection. You can obtain the Webhook connection ID by calling the [Monitors API](https://api.sumologic.com/docs/#operation/listConnections).

```bash title="Pagerduty connection example"
connection_notifications = [
{
connection_type = "PagerDuty",
connection_id = "<CONNECTION_ID>",
payload_override = "{\"service_key\": \"your_pagerduty_api_integration_key\",\"event_type\": \"trigger\",\"description\": \"Alert: Triggered {{TriggerType}} for Monitor {{Name}}\",\"client\": \"Sumo Logic\",\"client_url\": \"{{QueryUrl}}\"}",
run_for_trigger_types = ["Critical", "ResolvedCritical"]
},
{
connection_type = "Webhook",
connection_id = "<CONNECTION_ID>",
payload_override = "",
run_for_trigger_types = ["Critical", "ResolvedCritical"]
}
]
```

For information about overriding the payload for different connection types, see [Set Up Webhook Connections](/docs/alerts/webhook-connections/set-up-webhook-connections).
```bash title="Email notifications example"
email_notifications = [
{
connection_type = "Email",
recipients = ["[email protected]"],
subject = "Monitor Alert: {{TriggerType}} on {{Name}}",
time_zone = "PST",
message_body = "Triggered {{TriggerType}} Alert on {{Name}}: {{QueryURL}}",
run_for_trigger_types = ["Critical", "ResolvedCritical"]
}
]
```

8. To install the Monitors, navigate to the `terraform-sumologic-sumo-logic-monitor/monitor_packages/Cassandra/` directory and run `terraform init`. This will initialize Terraform and download the required components.
9. Run `terraform plan` to view the monitors that Terraform will create or modify.
10. Run `terraform apply`.

## Installing the Cassandra app

@@ -739,7 +655,13 @@ Use this dashboard to:

<img src={useBaseUrl('img/integrations/databases/Cassandra-Write-Path.png')} alt="Cassandra dashboards" />

## Cassandra Alerts
## Create monitors for Cassandra app

import CreateMonitors from '../../reuse/apps/create-monitors.md';

<CreateMonitors/>

### Cassandra Alerts

Sumo Logic has provided out-of-the-box alerts available via [Sumo Logic monitors](/docs/alerts/monitors) to help you quickly determine if the Cassandra cluster is available and performing as expected.

103 changes: 6 additions & 97 deletions docs/integrations/databases/couchbase.md
Original file line number Diff line number Diff line change
@@ -378,101 +378,6 @@ At this point, Telegraf should start collecting the Couchbase metrics and forwar
</TabItem>
</Tabs>


## Installing Couchbase Monitors

The next sections provides instructions for installing the Couchbase app, as well as examples of each of the app dashboards. These instructions assume you have already set up the collection as described in the **Collecting Logs and Metrics for the Couchbase app** section.

#### Pre-Packaged Alerts

Sumo Logic has provided out-of-the-box alerts available through [Sumo Logic monitors](/docs/alerts/monitors) to help you monitor your Couchbase clusters. These alerts are built based on metrics and logs datasets and include preset thresholds based on industry best practices and recommendations.

For details on the individual alerts, see [Couchbase Alerts](#couchbase-alerts).
* To install these alerts, you need to have the Manage Monitors role capability.
* Alerts can be installed by either importing a JSON file or a Terraform script.

There are limits to how many alerts can be enabled - see the [Alerts FAQ](/docs/alerts/monitors/monitor-faq) for details.


### Method A: Importing a JSON file

1. Download the [JSON file](https://github.com/SumoLogic/terraform-sumologic-sumo-logic-monitor/blob/main/monitor_packages/Couchbase/couchbase.json) that describes the monitors.
2. The [JSON](https://github.com/SumoLogic/terraform-sumologic-sumo-logic-monitor/blob/main/monitor_packages/Couchbase/couchbase.json) contains the alerts that are based on Sumo Logic searches that do not have any scope filters and therefore will be applicable to all Couchbase clusters, the data for which has been collected via the instructions in the previous sections. However, if you would like to restrict these alerts to specific clusters or environments, update the JSON file by replacing the text `db_system=couchbase` with `<Your Custom Filter>`. Custom filter examples:
1. For alerts applicable only to a specific cluster, your custom filter would be `'db_cluster=couchbase-standalone.01'`.
2. For alerts applicable to all cluster that start with couchbase-standalone, your custom filter would be,`db_cluster=couchbase-standalone*`.
3. For alerts applicable to a specific cluster within a production environment, your custom filter would be `db_cluster=couchbase-1` and `environment=standalone` (This assumes you have set the optional environment tag while configuring collection).
3. [**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the main Sumo Logic menu, select **Manage Data > Monitoring > Monitors**. <br/>[**New UI**](/docs/get-started/sumo-logic-ui). In the main Sumo Logic menu, select **Alerts > Monitors**. You can also click the **Go To...** menu at the top of the screen and select **Monitors**.
4. Click **Add**:
5. Click **Import** and then copy-paste the above JSON to import monitors.
6. The monitors are disabled by default. Once you have installed the alerts using this method, navigate to the Couchbase folder under **Monitors** to configure them. See [Monitor Settings](/docs/alerts/monitors/settings) to learn how to enable monitors to send notifications to teams or connections. See the instructions detailed in [Create a Monitor](/docs/alerts/monitors/create-monitor).

### Method B: Using a Terraform script method

1. **Generate a Sumo Logic access key and ID**. Generate an access key and access ID for a user that has the Manage Monitors role capability in Sumo Logic using instructions in [Access Keys](/docs/manage/security/access-keys). Identify which deployment your Sumo Logic account is in using this [link](/docs/api/getting-started#sumo-logic-endpoints-by-deployment-and-firewall-security).
2. **[Download and install Terraform 0.13](https://www.terraform.io/downloads.html) or later**.
3. **Download the Sumo Logic Terraform package for Couchbase alerts**. The alerts package is available in the Sumo Logic GitHub [repository](https://github.com/SumoLogic/terraform-sumologic-sumo-logic-monitor/tree/main/monitor_packages/SquidProxy). You can either download it through the “git clone” command or as a zip file.
4. **Alert Configuration**. After the package has been extracted, navigate to the package directory `terraform-sumologic-sumo-logic-monitor/monitor_packages/Couchbase/`
5. Edit the **couchbase.auto.tfvars** file and add the Sumo Logic Access Key, Access Id, and Deployment from Step 1.
```bash
access_id = "<SUMOLOGIC ACCESS ID>"
access_key = "<SUMOLOGIC ACCESS KEY>"
environment = "<SUMOLOGIC DEPLOYMENT>"
```

The Terraform script installs the alerts without any scope filters, if you would like to restrict the alerts to specific farms or environments, update the variable `couchbase_data_source`. Custom filter examples:
* A specific cluster `db_cluster=couchbase.standalone.01`.
* All clusters in an environment `environment=standalone`.
* For alerts applicable to all clusters that start with `couchbase-standalone`, your custom filter would be: `db_cluster=couchbase-standalone`.
* For alerts applicable to a specific cluster within a production environment, your custom filter would be: `db_system=couchbase` and `environment=standalone`. This assumes you have set the optional environment tag while configuring collection.

All monitors are disabled by default on installation. If you would like to enable all the monitors, set the parameter `monitors_disabled` to `false` in this file.

By default, the monitors are configured in a monitor folder called “Couchbase”. If you would like to change the name of the folder, update the monitor folder name in “folder” key at `couchbase.auto.tfvars` file.

If you would like the alerts to send email or connection notifications, configure these in the file `couchbase_notifications.auto.tfvars`. For configuration examples, refer to the next section.

6. **Email and Connection Notification Configuration Examples**. Modify the file **couchbase_notifications.auto.tfvars** and populate `connection_notifications` and `email_notifications` as per below examples.

```bash title="Pagerduty Connection Example"
connection_notifications = [
{
connection_type = "PagerDuty",
connection_id = "<CONNECTION_ID>",
payload_override = "{\"service_key\": \"your_pagerduty_api_integration_key\",\"event_type\": \"trigger\",\"description\": \"Alert: Triggered {{TriggerType}} for Monitor {{Name}}\",\"client\": \"Sumo Logic\",\"client_url\": \"{{QueryUrl}}\"}",
run_for_trigger_types = ["Critical", "ResolvedCritical"]
},
{
connection_type = "Webhook",
connection_id = "<CONNECTION_ID>",
payload_override = "",
run_for_trigger_types = ["Critical", "ResolvedCritical"]
}
]
```

Replace `<CONNECTION_ID>` with the connection id of the webhook connection. The webhook connection id can be retrieved by calling the [Monitors API](https://api.sumologic.com/docs/#operation/listConnections).

For overriding payload for different connection types, refer to this [document](/docs/alerts/webhook-connections/set-up-webhook-connections).

```bash title="Email Notifications Example"
email_notifications = [
{
connection_type = "Email",
recipients = ["[email protected]"],
subject = "Monitor Alert: {{TriggerType}} on {{Name}}",
time_zone = "PST",
message_body = "Triggered {{TriggerType}} Alert on {{Name}}: {{QueryURL}}",
run_for_trigger_types = ["Critical", "ResolvedCritical"]
}
]
```

7. **Install the Alerts**. Navigate to the package directory `terraform-sumologic-sumo-logic-monitor/monitor_packages/Couchbase/` and run `terraform init`. This will initialize Terraform and will download the required components.
8. Run `terraform plan` to view the monitors which will be created/modified by Terraform.
9. Run `terraform apply`.
10. **Post Installation**. If you haven’t enabled alerts and/or configured notifications through the Terraform procedure outlined above, we highly recommend enabling alerts of interest and configuring each enabled alert to send notifications to other users or services. This is detailed in Step 4 of [this document](/docs/alerts/monitors/create-monitor). There are limits to how many alerts can be enabled - see the [Alerts FAQ](/docs/alerts/monitors/monitor-faq.md).


## Installing the Couchbase app

This section demonstrates how to install the Couchbase app.
@@ -600,9 +505,13 @@ Use this dashboard to:

<img src={useBaseUrl('img/integrations/databases/Couchbase-HTTP-Access.png')} alt="Cassandra dashboards" />

## Couchbase Alerts
## Create monitors for Couchbase app

import CreateMonitors from '../../reuse/apps/create-monitors.md';

<CreateMonitors/>

Sumo Logic has provided out-of-the-box alerts available via[ Sumo Logic monitors](/docs/alerts/monitors) to help you quickly determine if the Couchbase database cluster is available and performing as expected.
### Couchbase alerts

<table>
<tr>
Loading