Help Center/ Log Tank Service/ Developer Guide/ Interconnecting with the Grafana Plug-in (Pipe Character)/ Interconnecting with the Grafana Plug-in (Windows)
Updated on 2025-04-10 GMT+08:00
View PDF
Share

Interconnecting with the Grafana Plug-in (Windows)

Grafana is a cross-platform open-source measurement analysis and visualization tool. It can query collected data, display the data in a visualized manner, and notify users in a timely manner.

LTS-Grafana is a plug-in of Grafana. It can analyze and display LTS data in a visualized manner.

Prerequisites

  • You have installed Grafana.
    • The Grafana version must be 9.0.0 or later.
    • In Windows, you are advised to install Grafana on a non-system disk. Otherwise, you may not have the permission to open the Grafana configuration file.
    • After Grafana is installed, enter localhost:3000 in the address box of the browser. The initial account and password are both admin.
  • Download the LTS-Grafana plug-in package of the pipe character version.
  • LTS-Grafana can be used only after the pipe character function has been enabled on the LTS console.

    Currently, this function is applicable only to regions LA-Mexico City2, CN East-Shanghai1, AP-Singapore, CN North-Beijing4, CN South-Guangzhou, CN East-Qingdao, CN East2, CN-Hong Kong, and CN North-Ulanqab1.

Installing the LTS-Grafana Plug-in

  1. Install the LTS-Grafana plug-in.

    1. Go to the Grafana installation directory, for example, GrafanaLabs\grafana\data\plugins.
    2. Decompress the downloaded LTS-Grafana plug-in package to the current location. In this way, the file lts-grafana-plugin can be extracted.
    3. Copy the file lts-grafana-plugin to the GrafanaLabs\grafana\plugins-bundled\internal\input-datasource directory.
    4. Restart the Grafana service.

      In Task Manager, choose Services, right-click Grafana, and choose Restart from the shortcut menu to restart the Grafana service.

  2. Modify the Grafana configuration file.

    1. Open the configuration file.

      Installation directory/GrafanaLabs\grafana\conf\defaults.ini

    2. Configure allow_loading_unsigned_plugins. 
      allow_loading_unsigned_plugins = hw-hws-lts-grafana-datasource-plugin
    3. Restart the Grafana service.

Adding a Data Source

  1. Enter localhost:3000 in the address box of the browser to log in to the Grafana service. The initial account and password are both admin.
  2. In the navigation pane on the left, click and choose Data sources. On the Data sources page that is displayed, click Add data source.

  3. Configure the data source.

    Table 1 Data source configuration

    Parameter

    Description

    Example Value

    Name

    Plug-in name, which can be customized.

    hws-lts-grafana-datasource-plugin

    Endpoint

    Select an endpoint based on your region. For details, see Regions and Endpoints.

    -

    AccesskeyId/SecretAccessKey

    User access credential. Log in to the LTS console, move the cursor to the account name and choose My Credentials > Access Keys. On the Access Keys page, copy the access key ID.

    -

    Specify Project ID
    • If there are multiple project IDs and you want to use a custom project, enable Specify Project ID to specify the required project ID.
    • If there is one project ID and Specify Project ID is disabled, the default project ID is used.

    -

    projectId

    If Specify Project ID is enabled, you need to enter the project ID of the account.

    Log in to the LTS console, move the cursor to the account name and choose My Credentials > API Credentials. On the API Credentials page, copy the project ID of the region.

    -

  4. Set a proxy. If a proxy is required, enable the proxy settings. If no proxy is required, skip this step.

    Table 2 Proxy settings

    Parameter

    Description

    Example Value

    Scheme

    Protocol

    HTTP, HTTPS, etc.

    Host

    Domain name/IP address

    -

    port

    Port

    80

    userName

    Username

    If the proxy has a username, you need to enter its username.

    If the proxy has no username set, leave this parameter blank.

    -

    password

    Password

    If the proxy has a password, you need to enter its password.

    If the proxy has no password set, leave this parameter blank.

    -

  5. Click Save & Test.

Adding a Dashboard

  1. In the navigation pane on the left, click and choose Dashboards. On the New dashboard page, click add an empty panel.
  2. On the New dashboards page, select hws-lts-grafana-datasource-plugin and enter the corresponding SQL statement.
  3. Select the corresponding time in the upper right corner and click to refresh and display the latest data.

    Follow the following rules when configuring parameters of the LTS-Grafana plug-in:

    • For table data, set the x-column parameter to table.
    • For single-value data, set the x-column parameter to single.
    • For charts that contain dimension columns, set the x-column parameter to the time column field and y-column to col1:col2. col1 indicates the aggregation column, and col2 indicates the data column.
    • For bar charts, set the x-column parameter to bar and y-column to col1,col2. col1 indicates the category column, and col2 indicates the data column.
    • For pie charts, set the x-column parameter to pie and y-column to col1,col2. col1 indicates the category column, and col2 indicates the data column.