Files
Olares/docs/developer/develop/mw-view-mysql-data.md
Meow33 839133fc27 docs: add middleware data access and integration guides (#2444)
* docs: add guides to view middleware data

* docs: add guide for grafana

* docs: add guide for otel and integration guides for other middleware

* docs: add guide for elasticsearch

* docs: update based on suggestions

* Update zh.ts

* docs: update content

* docs: resolve conflict
2026-02-05 23:34:59 +08:00

3.1 KiB

outline, description
outline description
2
3
Learn how to view and manage MySQL data in Olares using CLI or Bytebase.

View MySQL data

To use MySQL in Olares, install it from Market first. This guide walks you through the installation steps and shows how to access it from Olares.

Install MySQL service

Before connecting, install the MySQL service from Market.

  1. Open Market from the Launchpad and search for "MySQL".
  2. Click Get, then Install, and wait for the installation to complete.

Once installed, the service and its connection details will appear in the Middleware list in Control Hub.

Get connection information

Before connecting, obtain MySQL connection details from the Control Hub.

  1. Open Control Hub from Launchpad.

  2. In the left navigation pane, go to Middleware and select Mysql.

  3. On the Details panel, record the following information:

    • Host: Used for Bytebase connection.
    • User: Used for Bytebase connection.
    • Password: Used for both CLI and Bytebase.

    MySQL details{width=60% style="margin-left:0"}

Access via CLI

You can use the Olares terminal to access the MySQL container.

  1. In Control Hub, open the Olares terminal at the bottom of the left navigation pane.

  2. Enter the MySQL container. The container name is fixed.

    kubectl exec -it -n mysql-middleware mysql-mysql-0 -- sh
    
  3. Connect to MySQL:

    mysql -u root -p
    
  4. When prompted, enter the password you retrieved from Control Hub.

Manage via Bytebase

Bytebase provides a graphical interface for database management and schema changes.

Prerequisites

:::info MongoDB app required Bytebase uses MongoDB to store its metadata. Install MongoDB before installing Bytebase. :::

  1. Open Market and search for "MongoDB".
  2. Click Get, then Install, and wait until the service is running.
  3. After MongoDB is installed, search for "Bytebase" in Market.
  4. Click Get, then Install.

First-time setup

When launching Bytebase for the first time, you must configure an administrator account.

:::tip Remember these credentials. Only the admin account can create new database instances. :::

  1. Open Bytebase from Launchpad.
  2. Follow the on-screen prompts to set up your admin account with email and password.

Create a MySQL instance

  1. Log in to Bytebase with your admin account.
  2. In the left navigation pane, select Instances, then click + Add Instance.
  3. Choose MySQL as the database type.
  4. Fill in the connection fields using values from Control Hub:
    • Host or Socket: Enter the Host address and do not include the port.
    • Port: Keep the default, usually 3306.
    • Username: Enter the User value from Control Hub.
    • Password: Enter the Password value from Control Hub.
  5. Click Test Connection to verify connectivity, then click Create.

Creating an instance in Bytebase does not create a new database. Once the instance is created, you can use the corresponding client tools to inspect and manage data.