MariaDB

MariaDB 整合功能會收集與 InnoDB、緩衝區集區和其他各種作業相關的效能指標。此外，這項工具也會收集一般、錯誤和慢速查詢記錄，並剖析為 JSON 酬載。系統會剖析錯誤記錄檔，找出錯誤代碼和子系統。系統會將慢速查詢記錄剖析為鍵值組，說明查詢的效能，包括查詢時間和檢查的資料列。

如要進一步瞭解 MariaDB，請參閱 MariaDB 說明文件。

必要條件

如要收集 MariaDB 遙測資料，請安裝 Ops Agent：

• 如要使用指標，請安裝 2.37.0 以上版本。
• 如要查看記錄，請安裝 2.37.0 以上版本。

這項整合功能支援 MariaDB 10.1.X 到 10.7.X 版。

設定 MariaDB 執行個體

MariaDB 是由社群開發，並提供商業支援的 MySQL 關聯式資料庫管理系統 (RDBMS) 分支版本。如要收集 MariaDB 的記錄和指標，請使用 mysql 接收器。

根據預設，mysql 指標接收器會使用 Unix 通訊端和 Unix 驗證，以 root 使用者身分連線至本機 MariaDB 伺服器。

mysql_error 記錄接收器會從下表顯示的預設檔案路徑收集記錄。在某些平台上，MariaDB 預設會將記錄檔寫入 journald，而不是檔案。如要改為將記錄檔寫入檔案，請在 MariaDB 設定中設定 log_error 選項。如要進一步瞭解 log_error 設定，請參閱「將錯誤記錄寫入檔案」。

設定 MariaDB 適用的 Ops Agent

按照「設定作業套件代理程式」指南操作，新增必要元素，從 MariaDB 執行個體收集遙測資料，然後重新啟動代理程式。

範例設定

下列指令會建立設定，收集及擷取 MariaDB 的遙測資料：

# Configures Ops Agent to collect telemetry from the app. You must restart the agent for the configuration to take effect.

set -e

# Check if the file exists
if [ ! -f /etc/google-cloud-ops-agent/config.yaml ]; then
  # Create the file if it doesn't exist.
  sudo mkdir -p /etc/google-cloud-ops-agent
  sudo touch /etc/google-cloud-ops-agent/config.yaml
fi

# Create a back up of the existing file so existing configurations are not lost.
sudo cp /etc/google-cloud-ops-agent/config.yaml /etc/google-cloud-ops-agent/config.yaml.bak

# Configure the Ops Agent.
sudo tee /etc/google-cloud-ops-agent/config.yaml > /dev/null << EOF
metrics:
  receivers:
    mysql:
      type: mysql
  service:
    pipelines:
      mysql:
        receivers:
        - mysql
logging:
  receivers:
    mysql_error:
      type: mysql_error
    mysql_general:
      type: mysql_general
    mysql_slow:
      type: mysql_slow
  service:
    pipelines:
      mysql:
        receivers:
          - mysql_error
          - mysql_general
          - mysql_slow
EOF

如要讓這些變更生效，請重新啟動 Ops Agent：

設定記錄檔收集作業

如要從 MariaDB 擷取記錄，您必須為 MariaDB 產生的記錄建立接收器，然後為新的接收器建立管道。

如要設定 mysql_error 記錄的接收器，請指定下列欄位：

如要設定 mysql_general 記錄的接收器，請指定下列欄位：

如要設定 mysql_slow 記錄的接收器，請指定下列欄位：

記錄內容

logName 是從設定中指定的接收器 ID 衍生而來。LogEntry 內的詳細欄位如下。

mysql_error 記錄的 LogEntry 包含下列欄位：

mysql_general 記錄的 LogEntry 包含下列欄位：

mysql_slow 記錄的 LogEntry 包含下列欄位：

^† 只有在 log_slow_verbosity 系統變數包含 'query_plan' 時，才會提供這些欄位。

設定指標收集

如要從 MariaDB 擷取指標，您必須為 MariaDB 產生的指標建立接收器，然後為新的接收器建立管道。

這個接收器不支援在設定中使用多個執行個體，例如監控多個端點。所有這類執行個體都會寫入相同的時間序列，Cloud Monitoring 無法區分這些執行個體。

如要為 mysql 指標設定接收器，請指定下列欄位：

監控的內容

下表列出 Ops Agent 從 MariaDB 執行個體收集的指標。

驗證設定

本節說明如何確認您已正確設定 MariaDB 接收器。Ops Agent 可能需要一到兩分鐘，才會開始收集遙測資料。

如要確認 MariaDB 記錄是否已傳送至 Cloud Logging，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的 segment「Logs Explorer」頁面：

   前往「Logs Explorer」(記錄檔探索工具)

   如果您是使用搜尋列尋找這個頁面，請選取子標題為「Logging」的結果。

2. 在編輯器中輸入下列查詢，然後按一下「執行查詢」：
   

   resource.type="gce_instance"
   (log_id("mysql_error") OR log_id("mysql_general") OR log_id("mysql_slow"))
   

如要確認 MariaDB 指標是否已傳送至 Cloud Monitoring，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的 leaderboard「指標探索器」頁面：

   前往 Metrics Explorer

   如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。

2. 在查詢建立工具窗格的工具列中，選取名稱為 code「PromQL」PromQL的按鈕。
3. 在編輯器中輸入下列查詢，然後按一下「執行查詢」：
   

   {"workload.googleapis.com/mysql.threads", monitored_resource="gce_instance"}
   

查看資訊主頁

如要查看 MariaDB 指標，您必須設定圖表或資訊主頁。 MariaDB 使用與 MySQL 相同的資訊主頁。 設定整合作業後，系統就會自動安裝所有資訊主頁，而 Ops Agent 也會開始收集指標資料。

您也可以查看資訊主頁的靜態預覽畫面，不必安裝整合功能。

如要查看已安裝的資訊主頁，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，前往「Dashboards」(資訊主頁)dashboard 頁面：

   前往「Dashboards」(資訊主頁)

   如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。

2. 選取「資訊主頁清單」分頁，然後選擇「整合」類別。
3. 按一下要查看的資訊主頁名稱。 MariaDB 使用與 MySQL 相同的資訊主頁。

如果您已設定整合功能，但尚未安裝資訊主頁，請檢查 Ops Agent 是否正在執行。如果資訊主頁中的圖表沒有指標資料，資訊主頁安裝作業就會失敗。Ops Agent 開始收集指標後，系統就會為您安裝資訊主頁。

如要查看資訊主頁的靜態預覽畫面，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，前往 「Integrations」(整合) 頁面：

   前往「整合」

   如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。

2. 按一下「Compute Engine」部署平台篩選器。
3. 找出 MySQL 的項目，然後按一下「查看詳細資料」。 MariaDB 使用與 MySQL 相同的資訊主頁。
4. 選取「資訊主頁」分頁標籤，即可查看靜態預覽畫面。如果已安裝資訊主頁，請點選「查看資訊主頁」前往。

如要進一步瞭解 Cloud Monitoring 中的資訊主頁，請參閱「資訊主頁和圖表」。

如要進一步瞭解如何使用「整合」頁面，請參閱「管理整合」一文。

安裝快訊政策

警告政策會指示 Cloud Monitoring 在發生指定情況時通知您。MariaDB 使用與 MySQL 相同的快訊政策。 您可以在 Monitoring 的「整合」頁面中查看及安裝這些快訊政策。

如要查看可用快訊政策的說明並安裝，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，前往 「Integrations」(整合) 頁面：

   前往「整合」

   如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。

2. 找出 MySQL 的項目，然後按一下「查看詳細資料」。 MariaDB 使用與 MySQL 相同的快訊政策。
3. 選取「快訊」分頁標籤。這個分頁會說明可用的快訊政策，並提供安裝介面。
4. 安裝快訊政策。快訊政策需要知道在警報觸發時要將通知傳送至何處，因此需要您提供安裝資訊。如要安裝快訊政策，請按照下列步驟操作：
   1. 從可用的警報政策清單中，選取要安裝的政策。

   2. 在「設定通知」部分，選取一或多個通知管道。您可以選擇停用通知管道，但這麼做的話，快訊政策觸發時不會傳送訊息。您可以在「監控」中查看狀態，但不會收到任何通知。

      如要進一步瞭解通知管道，請參閱「管理通知管道」。

   3. 按一下「建立政策」。

如要進一步瞭解 Cloud Monitoring 中的快訊政策，請參閱「快訊簡介」。

如要進一步瞭解如何使用「整合」頁面，請參閱「管理整合」一文。

後續步驟

如要逐步瞭解如何使用 Ansible 安裝 Ops Agent、設定第三方應用程式，以及安裝範例資訊主頁，請觀看「 安裝 Ops Agent 以排解第三方應用程式的問題」影片。