Todos los productos
Search
Centro de documentos

Tablestore:Connect to Grafana

Última actualización: Sep 06, 2026

Una vez que conecte Tablestore a Grafana, utilice Grafana para visualizar los datos de Tablestore.

Requisitos previos

Contexto

Grafana es una plataforma de visualización y análisis de código abierto que admite consultas y visualización de datos desde varios orígenes de datos, como Prometheus, Graphite, OpenTSDB, InfluxDB, Elasticsearch, MySQL y PostgreSQL. Para obtener más información, consulte la documentación oficial de Grafana.

Después de conectar Tablestore a Grafana, puede generar paneles de control basados en los datos de las tablas de Tablestore y mostrarlos en tiempo real.

Notas de uso

Las regiones compatibles con la función de visualización de Grafana dependen del modelo de datos utilizado.

  • Modelo de tabla ancha: admite all regions.

  • Modelo de series temporales: admite China (Hangzhou), China (Shanghai), China (Beijing), China (Zhangjiakou), China (Ulanqab), China (Shenzhen), China (Chengdu), China (Hong Kong), Japan (Tokyo), Singapore, Malaysia (Kuala Lumpur), Indonesia (Jakarta), Germany (Frankfurt), UK (London), US (Silicon Valley), US (Virginia) y SAU (Riyadh - Partner Region).

Paso 1: Instalar el plugin de Tablestore

Windows

  1. Descargue el paquete del plugin de Grafana para Tablestore.

  2. Descomprima el paquete del plugin de Grafana para Tablestore y mueva su contenido al directorio data/plugins de su instalación de Grafana.

  3. Modifique el archivo de configuración de Grafana.

    1. Abra el archivo de configuración defaults.ini, ubicado en el directorio conf del plugin de Grafana, con un editor de texto.

    2. En la sección [plugins] del archivo de configuración, establezca el parámetro allow_loading_unsigned_plugins.

      allow_loading_unsigned_plugins = 'aliyun-tablestore-grafana-datasource-adapt-react'
  4. Reinicie el proceso grafana-server.exe en el Administrador de tareas.

Mac/Linux

  1. Ejecute el siguiente comando para descargar el paquete del plugin de Grafana para Tablestore.

    wget https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260203/qbqmxg/aliyun-tablestore-grafana-datasource-adapt-react.zip
  2. Descomprima el paquete del plugin de Grafana para Tablestore en el directorio de plugins de Grafana.

    Ejecute el comando correspondiente a su método de instalación de Grafana.

    • Si instaló Grafana desde un repositorio Yellowdog Updater, Modified (YUM) o un paquete RPM Package Manager (RPM) (solo Linux): unzip aliyun-tablestore-grafana-datasource-adapt-react.zip -d /var/lib/grafana/plugins

    • Si instaló Grafana desde un archivo .zip: unzip aliyun-tablestore-grafana-datasource-adapt-react.zip -d {PATH_TO}/grafana-{VERSION}/data/plugins

      Nota

      En el comando, {PATH_TO}/grafana-{VERSION} indica la ruta de instalación de Grafana y {VERSION} indica el número de versión de Grafana.

  3. Modifique el archivo de configuración de Grafana.

    1. Vaya al directorio y abra el archivo de configuración.

      • Si instaló Grafana desde un repositorio YUM o un paquete RPM (solo Linux): /etc/grafana/grafana.ini

      • Si instaló Grafana desde un archivo .zip: {PATH_TO}/grafana-{VERSION}/conf/defaults.ini

        Nota

        En la ruta, {PATH_TO}/grafana-{VERSION} es la ruta de instalación de Grafana y {VERSION} es el número de versión de Grafana.

    2. En la sección [plugins] del archivo de configuración, establezca el parámetro allow_loading_unsigned_plugins.

      allow_loading_unsigned_plugins = 'aliyun-tablestore-grafana-datasource-adapt-react'
  4. Reinicie Grafana.

    1. Ejecute el comando kill para finalizar el proceso de Grafana.

    2. Ejecute el comando correspondiente a su método de instalación para iniciar Grafana.

      • Si instaló Grafana desde un repositorio YUM o un paquete RPM (solo Linux): systemctl restart grafana-server

      • Si instaló Grafana desde un archivo .zip: ./bin/grafana-server web

Paso 2: Configurar un origen de datos

  1. Inicie sesión en Grafana.

    1. En un navegador, introduzca http://<x.x.x.x>:3000/ para abrir la página de inicio de sesión de Grafana.

      Nota

      <x.x.x.x> representa la dirección IP del servidor donde se instaló Grafana. Por ejemplo, si Grafana se instaló en Windows, la dirección de inicio de sesión es http://localhost:3000.

    2. Introduzca su Email or username y Password, y luego haga clic en Log in.

      Nota

      El nombre de usuario y la contraseña predeterminados son admin. Cuando inicie sesión por primera vez, el sistema le solicitará cambiar la contraseña.

  2. En el panel de navegación izquierdo de Grafana, seleccione Connections > Data sources.

  3. En la página Data sources, haga clic en + Add new data source.

  4. En la página Add data source, dentro de la sección Others, haga clic en aliyun-tablestore-grafana-datasource.

  5. En la pestaña Settings, configure los parámetros tal como se describe en la siguiente tabla.

    Parámetro

    Ejemplo

    Descripción

    Name

    aliyun-tablestore-grafana-datasource

    Nombre del origen de datos. Introduzca un nombre personalizado si lo requiere. El valor predeterminado es aliyun-tablestore-grafana-datasource.

    Default

    Establece el origen de datos de Tablestore como origen de datos predeterminado.

    Endpoint

    https://myinstance.cn-hangzhou.ots.aliyuncs.com

    Introduzca el endpoint de la instancia de Tablestore a la que desea acceder.

    Instance

    myinstance

    Nombre de la instancia de Tablestore.

    AccessId

    ****

    AccessKey ID de la cuenta de Alibaba Cloud o del usuario de RAM que tiene permisos para acceder a Tablestore.

    AccessKey

    **

    AccessKey secret de la cuenta de Alibaba Cloud o del usuario de RAM que tiene permisos para acceder a Tablestore.

  6. Haga clic en Save & test.

    Cuando la conexión se establece correctamente, la interfaz muestra el mensaje Data source is working.

Paso 3: Crear un panel de control

  1. En el panel de navegación izquierdo de Grafana, haga clic en Dashboards.

  2. En la página Dashboards, haga clic en New y luego seleccione New dashboard.

  3. En la página New dashboard, haga clic en + Add visualization.

  4. En el cuadro de diálogo Select data source, seleccione el origen de datos de Tablestore que configuró.

  5. En la página Edit panel, configure las condiciones de consulta en la pestaña Queries.

    A continuación se describen los parámetros.

    Parámetro

    Ejemplo

    Descripción

    Query

    SELECT * FROM your_table WHERE $__unixMicroTimeRangeFilter(_time)AND _m_name = "your_measurement" AND tag_value_at(_tags, "your_tag")="your_tag_value" LIMIT 1000

    Instrucción de consulta SQL. Para obtener más información, consulte Query data.

    Importante
    • En la cláusula WHERE, debe usar una macro predefinida para filtrar los datos por intervalo de tiempo, como $__unixMicroTimeRangeFilter en el ejemplo. Para ver más macros de tiempo, haga clic en "Show Help" en la página de configuración.

    • Si desea mostrar los datos en un gráfico de series temporales, la consulta debe devolver una columna de tiempo representada por una marca de tiempo numérica. Además, configure el nombre de dicha columna.

    Format As

    Timeseries

    Formato de los resultados. Valores válidos:

    • Timeseries (Default): gráfico estándar de series temporales.

    • FlowGraph: gráfico multidimensional.

    • Table: tabla estándar.

      Nota

      Si los datos de la tabla no incluyen una columna de tiempo cuando los consulta mediante SQL desde un modelo de tabla ancha, haga clic en Switch to table para mostrar los resultados de la consulta en formato de tabla. También puede hacer clic en Open visualization suggestions para consultar y seleccionar otras opciones de visualización recomendadas.

    Time Column

    _time

    Nombre de la columna de tiempo en los datos devueltos. Esta columna se utiliza como eje X del gráfico de series temporales. Este parámetro está disponible cuando establece Format As en Timeseries o FlowGraph.

    Aggregation Column

    _field_name#:#_double_value

    Convierte varias filas de datos de una sola columna en el mismo punto temporal en una única fila de datos con varias columnas. Se utiliza para transformar datos del modelo de valor único al modelo de valores múltiples. Los datos del modelo de valor único son los resultados que se obtienen al consultar una tabla de series temporales en Tablestore mediante SQL. Este parámetro está disponible cuando establece Format As en FlowGraph. El formato es <Data point name column>#:#<Value column>.

  6. Haga clic en Run SQL para ejecutar la instrucción SQL y consultar o depurar los resultados.

  7. Configure y guarde el panel de control.

    1. En el panel derecho, especifique el nombre, el tipo y el estilo de visualización del gráfico de monitoreo.

    2. En la esquina superior derecha, haga clic en Save dashboard. En el cuadro de diálogo Save dashboard, especifique Title, Description y Folder para el panel de control. Luego, haga clic en Save.

    3. En la esquina superior derecha, haga clic en Save dashboard. En el cuadro de diálogo Save dashboard, haga clic en Save.

Paso 4: Consultar los datos de monitoreo

En el panel de navegación izquierdo de Grafana, seleccione Dashboards. Haga clic en el panel de control de la carpeta de destino para consultar todos sus gráficos de monitoreo.