Skip to content

Redwood layout changes to HeatWave and MySQL EE workshops #358

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
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
20 changes: 20 additions & 0 deletions .github/workflows/jekyll-docker.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
name: Jekyll site CI

on:
push:
branches: [ "main" ]
pull_request:
branches: [ "main" ]

jobs:
build:

runs-on: ubuntu-latest

steps:
- uses: actions/checkout@v4
- name: Build the site in the jekyll/builder container
run: |
docker run \
-v ${{ github.workspace }}:/srv/jekyll -v ${{ github.workspace }}/_site:/srv/jekyll/_site \
jekyll/builder:latest /bin/bash -c "chmod -R 777 /srv/jekyll && jekyll build --future"
10 changes: 5 additions & 5 deletions mysql/oci-heatwave-monitoring/a-introduction/introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,15 @@

## About this Workshop

This workshop consists of three lab exercises organized to familiarize you with key capabilities of Oracle Cloud services, including Database Management, Ops Insights and Logging Analytics. We have simulated HeatWave MySQL DB systems, so you don't need to set up or use one from your cloud account.
This workshop consists of three lab exercises organized to familiarize you with key capabilities of Oracle Cloud services, including Database Management, Ops Insights and Log Analytics. We have simulated HeatWave MySQL DB systems, so you don't need to set up or use one from your cloud account.

Estimated Time: 60 minutes

### Objectives

* Use Oracle Cloud Infrastructure (OCI) Database Management to monitor the HeatWave MySQL DB systems
* Use Ops Insights for Capacity Planning and Database Insights
* Use Logging Analytics to collect and analyze database logs, such as the General Query log, Audit log, and others
* Use Log Analytics to collect and analyze database logs, such as the General Query log, Audit log, and others

## Task 1: Heatwave MySQL Database

Expand All @@ -32,11 +32,11 @@ Oracle Cloud **Observability and Management Platform** provides full-stack visib

*For more information on Ops Insights for HeatWave MySQL please refer to Ops Insights > **[Use Ops Insights for HeatWave MySQL](https://docs.oracle.com/en-us/iaas/operations-insights/home.htm)***

* Logging Analytics
* Log Analytics

Oracle Cloud Infrastructure (OCI) Logging Analytics is a cloud solution that lets you index, enrich, aggregate, explore, search, analyze, correlate, visualize and monitor log data from applications and system infrastructure-both in the cloud and on-premises. It can extract database instance records based on SQL queries provided in the log source configuration. In this lab, you'll learn how to use the Oracle Cloud Logging Analytics to enrich log data collected from the world's most popular open source database-MySQL.
Oracle Cloud Infrastructure (OCI) Log Analytics is a cloud solution that lets you index, enrich, aggregate, explore, search, analyze, correlate, visualize and monitor log data from applications and system infrastructure-both in the cloud and on-premises. It can extract database instance records based on SQL queries provided in the log source configuration. In this lab, you'll learn how to use the Oracle Cloud Log Analytics to enrich log data collected from the world's most popular open source database-MySQL.

*For more information on Logging Analytics and log Explorer please refer to Logging Analytics > **[Use Logging Analytics for HeatWave MySQL](https://docs.oracle.com/en-us/iaas/logging-analytics/doc/oracle-defined-sources.html)***
*For more information on Log Analytics and log Explorer please refer to Log Analytics > **[Use Log Analytics for HeatWave MySQL](https://docs.oracle.com/en-us/iaas/logging-analytics/doc/oracle-defined-sources.html)***

## Acknowledgements

Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
@@ -1,23 +1,23 @@
# Logging Analytics
# Log Analytics

## Introduction

In this lab, you will learn how to use the Oracle Cloud Logging Analytics service to enrich the log data collected based on the SQL query provided in the log configuration from the world's most popular open source database-MySQL.
In this lab, you will learn how to use the Oracle Cloud Log Analytics service to enrich the log data collected based on the SQL query provided in the log configuration from the world's most popular open source database-MySQL.

Estimated Lab Time: 20 minutes

### Objectives

* Learn OCI Logging Analytics fundamentals in the context of log collection from an Application architecture hosted on top of MySQL DB system
* Learn to analyse, monitor, troubleshoot, and derive knowledge from the collected log data using Logging Analytics' Machine Learning features such as Cluster and Link
* Learn OCI Log Analytics fundamentals in the context of log collection from an Application architecture hosted on top of MySQL DB system
* Learn to analyse, monitor, troubleshoot, and derive knowledge from the collected log data using Log Analytics' Machine Learning features such as Cluster and Link
* Real-Time Monitoring and Alerting for Database Events
* Learn to create and use monitoring dashboards

## Task 1: Getting Familiar with Log Explorer

1. To access Logging Analytics, click on the Oracle Cloud Console **Navigation menu** (aka hamburger menu) located in the upper left corner. Under **Observability & Management**, navigate to **Logging Analytics**.
1. To access Log Analytics, click on the Oracle Cloud Console **Navigation menu** (aka hamburger menu) located in the upper left corner. Under **Observability & Management**, navigate to **Log Analytics**.

![Selecting Logging Analytics](./images/navigation.png " ")
![Selecting Log Analytics](./images/navigation.png " ")

2. Click on **Administration** from the tab on the top beside Home.

Expand Down Expand Up @@ -79,7 +79,7 @@ Estimated Lab Time: 20 minutes

![Cluster](./images/cluster-analysis.png " ")

2. You can drill down into different Clusters, Potential Issues, Outliers and Trends. Logging Analytics uses unsupervised ML to find related clusters in data. This reduces the approximately 500,000 log records to 500 cluster patterns, in real time.
2. You can drill down into different Clusters, Potential Issues, Outliers and Trends. Log Analytics uses unsupervised ML to find related clusters in data. This reduces the approximately 500,000 log records to 500 cluster patterns, in real time.

*Note: The numbers you see might be slightly different than the ones shown in the workshop. You can use the START time **Feb 7, 2025 04:54 PM UTC(-08:00)** and END time **Feb 14, 2025 04:54 PM UTC(-08:00)** in the time picker to replicate these in your lab environment.*

Expand Down Expand Up @@ -145,7 +145,7 @@ Estimated Lab Time: 20 minutes

![Histogram Visualization](./images/visualizations-histogram.png " ")

2. OCI Logging Analytics allows setting up **alarms** for critical database events, enabling real-time monitoring and alerting for potential security risks.
2. OCI Log Analytics allows setting up **alarms** for critical database events, enabling real-time monitoring and alerting for potential security risks.

![Alarm Setup](./images/alarm-setup.png " ")

Expand Down
4 changes: 2 additions & 2 deletions mysql/oci-heatwave-monitoring/workshops/sandbox/manifest.json
Original file line number Diff line number Diff line change
Expand Up @@ -18,8 +18,8 @@
"filename": "../../c-lab-two-opsi/opsi.md"
},
{
"title": "Logging Analytics",
"description": "Logging Analytics",
"title": "Log Analytics",
"description": "Log Analytics",
"filename": "../../d-lab-three-logging-analytics/logginganalytics.md"
},
{
Expand Down
10 changes: 5 additions & 5 deletions mysql/oci-mysqlee-monitoring/a-introduction/introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,15 @@

## About this Workshop

This workshop consists of four lab exercises organized to familiarize you with key capabilities of Oracle Cloud services, including Database Management, Ops Insights, Logging Analytics and Application Performance Management. We have simulated an External MySQL DB system, so you don't need to set up or use one from your cloud account.
This workshop consists of four lab exercises organized to familiarize you with key capabilities of Oracle Cloud services, including Database Management, Ops Insights, Log Analytics and Application Performance Management. We have simulated an External MySQL DB system, so you don't need to set up or use one from your cloud account.

Estimated Time: 1 hour 20 minutes

### Objectives

* Use Oracle Cloud Infrastructure (OCI) Database Management to monitor the External MySQL DB systems
* Use Ops Insights for capacity planning and Database Insights
* Use Logging Analytics to collect and analyze database logs, such as the General Query log, Audit log, and others
* Use Log Analytics to collect and analyze database logs, such as the General Query log, Audit log, and others
* Use APM Trace Explorer to view traces, spans, and span dimensions

## Task 1: Observability and Management Services
Expand All @@ -29,11 +29,11 @@ Oracle Cloud **Observability and Management Platform** provides full-stack visib

*For more information on Ops Insights for External MySQL please refer to Ops Insights > **[Use Ops Insights for External MySQL ](https://docs.oracle.com/en-us/iaas/operations-insights/home.htm)***

* Logging Analytics
* Log Analytics

Oracle Cloud Infrastructure (OCI) Logging Analytics is a cloud solution that lets you index, enrich, aggregate, explore, search, analyze, correlate, visualize and monitor log data from applications and system infrastructure-both in the cloud and on-premises. It can extract database instance records based on SQL queries provided in the log source configuration. In this lab, you'll learn how to use the Oracle Cloud Logging Analytics to enrich log data collected from the world's most popular open source database-MySQL.
Oracle Cloud Infrastructure (OCI) Log Analytics is a cloud solution that lets you index, enrich, aggregate, explore, search, analyze, correlate, visualize and monitor log data from applications and system infrastructure-both in the cloud and on-premises. It can extract database instance records based on SQL queries provided in the log source configuration. In this lab, you'll learn how to use the Oracle Cloud Log Analytics to enrich log data collected from the world's most popular open source database-MySQL.

*For more information on Logging Analytics and log Explorer please refer to Logging Analytics > **[Use Logging Analytics for External MySQL](https://docs.oracle.com/en-us/iaas/logging-analytics/doc/oracle-defined-sources.html)***
*For more information on Log Analytics and log Explorer please refer to Log Analytics > **[Use Log Analytics for External MySQL](https://docs.oracle.com/en-us/iaas/logging-analytics/doc/oracle-defined-sources.html)***

* Application Performance Management

Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
@@ -1,23 +1,23 @@
# Logging Analytics
# Log Analytics

## Introduction

In this lab, you will learn how to use the Oracle Cloud Logging Analytics service to collect and analyze log data directly from the MySQL log files such as the General Query log and Error log to gain deeper insights into database activity.
In this lab, you will learn how to use the Oracle Cloud Log Analytics service to collect and analyze log data directly from the MySQL log files such as the General Query log and Error log to gain deeper insights into database activity.

Estimated Lab Time: 20 minutes

### Objectives

* Learn OCI Logging Analytics fundamentals in the context of log collection from an Application architecture hosted on top of MySQL Database
* Learn to analyse, monitor, troubleshoot, and derive knowledge from the collected log data using Logging Analytics' Machine Learning features such as Cluster and Link
* Learn OCI Log Analytics fundamentals in the context of log collection from an Application architecture hosted on top of MySQL Database
* Learn to analyse, monitor, troubleshoot, and derive knowledge from the collected log data using Log Analytics' Machine Learning features such as Cluster and Link
* Real-Time Monitoring and Alerting for Database Events
* Learn to create and use monitoring dashboards

## Task 1: Getting Familiar with Log Explorer

1. To access Logging Analytics, click on the Oracle Cloud Console **Navigation menu** (aka hamburger menu) located in the upper left corner. Under **Observability & Management**, navigate to **Logging Analytics**.
1. To access Log Analytics, click on the Oracle Cloud Console **Navigation menu** (aka hamburger menu) located in the upper left corner. Under **Observability & Management**, navigate to **Log Analytics**.

![Selecting Logging Analytics](./images/navigation.png " ")
![Selecting Log Analytics](./images/navigation.png " ")

2. Click on **Administration** from the tab on the top beside Home.

Expand Down Expand Up @@ -79,7 +79,7 @@ Estimated Lab Time: 20 minutes

![Line](./images/cluster-analysis.png " ")

2. You can drill down into different Clusters, Potential Issues, Outliers and Trends. Logging Analytics uses unsupervised ML to find related clusters in data. This reduces the approximately 500,000 log records to 500 cluster patterns, in real time.
2. You can drill down into different Clusters, Potential Issues, Outliers and Trends. Log Analytics uses unsupervised ML to find related clusters in data. This reduces the approximately 500,000 log records to 500 cluster patterns, in real time.

*Note: The numbers you see might be slightly different than the ones shown in the workshop. You can use the START time **March 4, 2025 06:17 PM UTC(-07:00)** and END time **March 18, 2025 06:17 PM UTC(-07:00)** in the time picker to replicate these in your lab environment.*

Expand Down Expand Up @@ -137,9 +137,9 @@ Estimated Lab Time: 20 minutes

## Task 5: Real-Time Monitoring and Alerting for Database Events

1. Logging analytics can seamlessly integrate with **log files** from External MySQL DB systems, enabling the capture and analysis of logs such as **error** and **general logs**.
1. Log analytics can seamlessly integrate with **log files** from External MySQL DB systems, enabling the capture and analysis of logs such as **error** and **general logs**.

2. The **error logs** are used to track critical events such as primary key violations and server errors, while the **general logs** capture all SQL queries like INSERT, UPDATE, and DELETE executed on the server. These log files are forwarded to OCI Logging Analytics, enabling monitoring and analysis of logs for any issues or suspicious activities, with the ability to create alarms based on specific patterns.
2. The **error logs** are used to track critical events such as primary key violations and server errors, while the **general logs** capture all SQL queries like INSERT, UPDATE, and DELETE executed on the server. These log files are forwarded to OCI Log Analytics, enabling monitoring and analysis of logs for any issues or suspicious activities, with the ability to create alarms based on specific patterns.

3. We've gone through all the steps for working with the **error logs**. Now, you can follow the same steps for the **general logs** to analyze query patterns, spot any issues, and setup alerts for anything unusual that might affect performance.

Expand All @@ -163,7 +163,7 @@ Estimated Lab Time: 20 minutes

![General Log HeatMap](./images/general-logs-heatmap.png " ")

8. OCI Logging Analytics allows setting up **alarms** for critical database events, enabling real-time monitoring and alerting for potential security risks.
8. OCI Log Analytics allows setting up **alarms** for critical database events, enabling real-time monitoring and alerting for potential security risks.

![Alarms Setup](./images/alarm-setup.png " ")

Expand Down
4 changes: 2 additions & 2 deletions mysql/oci-mysqlee-monitoring/workshops/sandbox/manifest.json
Original file line number Diff line number Diff line change
Expand Up @@ -18,8 +18,8 @@
"filename": "../../c-lab-two-opsi/opsi.md"
},
{
"title": "Logging Analytics",
"description": "Logging Analytics",
"title": "Log Analytics",
"description": "Log Analytics",
"filename": "../../d-lab-three-logging-analytics/logginganalytics.md"
},
{
Expand Down
Loading