

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Ampliación de su espacio de trabajo con complementos
<a name="grafana-plugins"></a>

Los *complementos de Grafana* agregan la posibilidad de conectarse a nuevos orígenes de datos o agregar visualización u otra funcionalidad al espacio de trabajo. En términos generales, los complementos tienen tres tipos:
+ **Complementos de paneles**: los complementos de panel agregan nuevos tipos de visualización que están disponibles para su uso en sus paneles. Estos definen la renderización de los datos en el frontend.
+ **Complementos de orígenes de datos**: los complementos de orígenes de datos se comunican con orígenes de datos externos y devuelven los datos en un formato que Grafana puede usar.
+ **Complementos de aplicaciones**: aplicaciones, también conocidas como complementos de aplicaciones. Estos incluyen paquetes de orígenes de datos y paneles, y pueden proporcionar una experiencia coherente dentro de su espacio de trabajo de Grafana.

**nota**  
Cuando Amazon determina que un complemento suele fallar o no se ha mantenido, podría eliminarlo de la lista de complementos disponibles en la consola.

Para los espacios de trabajo de Amazon Managed Grafana que sean compatibles con la versión 9 o posterior, puede habilitar la administración de complementos. Esto permite a los administradores del espacio de trabajo instalar o desinstalar complementos del *catálogo de complementos*.

## Búsqueda de complementos con el catálogo de complementos
<a name="plugin-catalog"></a>

Su espacio de trabajo de Amazon Managed Grafana incluye una página en la que se muestran todos los complementos instalados y una lista de todos los complementos que están disponibles para su instalación en su espacio de trabajo. Esta página es el *catálogo de complementos*. Además de los complementos que vienen instalados de forma predeterminada, puede instalar hasta 50 complementos más.

Los complementos disponibles se dividen generalmente en las siguientes categorías:
+ **AWS Fuentes de datos**: este es un complemento de aplicación, proporcionado por Amazon Managed Grafana, para descubrir fácilmente AWS los recursos de su cuenta. Se instala de forma predeterminada. Para obtener más información, consulte [Usa el complemento Fuentes de AWS datos para buscar AWS datos](aws-datasources-plugin.md).
+ **Complementos principales**: estos complementos se proporcionan de forma predeterminada en Grafana. Incluyen orígenes de datos populares y visualizaciones de paneles. Están etiquetados como **Principales** en el catálogo de complementos. Se instalan de forma predeterminada y no se pueden eliminar.
+ **Complementos empresariales**: estos complementos están disponibles para los espacios de trabajo de Grafana que tienen una licencia empresarial. Estos no se instalan de forma predeterminada. Están etiquetados como **Empresariales** en el catálogo de complementos. Solo se pueden instalar si tiene una licencia empresarial válida. Para obtener más información sobre cómo actualizar un espacio de trabajo a una licencia empresarial, consulte [Administración de su acceso a los complementos de Amazon Managed Grafana Enterprise](AMG-workspace-manage-enterprise.md).
+ **Complementos comunitarios**: estos complementos se proporcionan para los espacios de trabajo de Grafana desde varias fuentes, incluidos Grafana Labs y otros. AWS En los espacios de trabajo de Grafana que admiten la versión 9 o posterior, no se instalan de forma predeterminada (algunos de los espacios de trabajo anteriores tenían algunos de ellos instalados automáticamente). Por lo general, se trata de complementos de código abierto. Puede instalar o eliminar estos complementos.
**nota**  
El uso de complementos comunitarios queda a su entera discreción. Como parte del [Modelo de responsabilidad compartida](security.md) entre usted y AWS, se espera que comprenda qué es lo que está instalando en su espacio de trabajo para estos complementos de terceros. También es responsable de que los complementos satisfagan sus necesidades de seguridad.

**Soporte de complementos**

Los complementos provienen de una amplia variedad de orígenes y el soporte varía según cada uno de ellos.
+ **AWS Complemento de fuentes de datos**: este complemento es proporcionado y respaldado por. AWS
+ **Plugins empresariales: los complementos** empresariales son compatibles tanto AWS con Grafana Labs como con Grafana Labs. Puede enviar los problemas a través de cualquiera de los equipos de soporte.
+ **Plugins principales**: los complementos principales y otros complementos proporcionados por AWS Grafana Labs son compatibles con Amazon Managed Grafana by. AWS Puedes enviar un problema GitHub para corregir errores o mejorarlo, o crear un ticket con AWS Grafana Labs.
+ **Plugins comunitarios: los** complementos comunitarios no creados por Grafana Labs AWS o Grafana Labs suelen ser compatibles a través de publicaciones GitHub u otros foros. La información de soporte en esos casos se incluye en los detalles del complemento en el catálogo de complementos.

[También puedes enviar problemas relacionados con los complementos a través de los GitHub foros de Grafana o [Grafana gestionados por Amazon](https://github.com/aws/amazon-managed-grafana-roadmap/issues).](https://github.com/grafana/grafana/issues)

**Versiones del complemento**

La mayoría de los complementos se actualizan con regularidad. En el catálogo de complementos de un espacio de trabajo de Amazon Managed Grafana se muestran las versiones más recientes de un complemento; usted elige qué versión quiere instalar. Cuando un complemento tiene una versión obsoleta con un problema de seguridad conocido, la versión obsoleta se elimina de la disponibilidad.

También puede [actualizar](#update-plugin) los complementos que ya están instalados.

**nota**  
A veces, hay disponible una nueva versión de un complemento que corrige un problema de seguridad en un complemento instalado. En el caso de problemas graves, Amazon Managed Grafana podría actualizar automáticamente el complemento de sus espacios de trabajo a la versión corregida.

## Administración de complementos con el catálogo de complementos
<a name="manage-plugins"></a>

Administre los complementos de su espacio de trabajo de Amazon Managed Grafana desde el catálogo de complementos. Solo puede instalar los complementos que figuran en el catálogo de complementos de su espacio de trabajo.

A continuación se describen los requisitos previos para usar el catálogo de complementos y cómo encontrarlo.

**Requisitos previos**
+ Debe tener un [espacio de trabajo de Amazon Managed Grafana](AMG-create-workspace.md) que sea compatible con la versión 9 y tener una cuenta que pueda iniciar sesión en ese espacio de trabajo.
+ El espacio de trabajo debe tener [habilitada la administración de complementos](AMG-configure-workspace.md).
+ Su cuenta de usuario debe ser la de [administrador de su espacio de trabajo de Amazon Managed Grafana](Grafana-user-roles.md).
+ Para instalar y usar los complementos empresariales, primero debe [actualizarse y adquirir una licencia empresarial](AMG-workspace-manage-enterprise.md).

**Visualización del catálogo de complementos**

1. Inicie sesión en su espacio de trabajo de Amazon Managed Grafana.

1. En el menú de la izquierda, seleccione **Administración** y, a continuación, **Complementos**. Esto abre el catálogo de complementos.

1. De forma predeterminada, en el catálogo de complementos se muestran los complementos instalados. Para ver todos los complementos disponibles, seleccione la opción **Todos** en el filtro **Estado** situado en la parte superior del catálogo. Los complementos instalados incluyen una etiqueta que indica **Instalado**.

## Instalación o eliminación de un complemento
<a name="install-plugin"></a>

**nota**  
Debe cumplir los requisitos previos de la sección anterior o no tendrá permiso para modificar los complementos.

**Instalación o eliminación de un complemento de Grafana**

1. Vaya al catálogo de complementos.

1. De forma predeterminada, en el catálogo de complementos se muestran únicamente los complementos instalados. Para ver todos los complementos disponibles, seleccione la opción **Todos** en el filtro **Estado** situado en la parte superior del catálogo. Los complementos instalados incluyen una etiqueta que indica **Instalado**.

1. Seleccione el complemento que se va a instalar o desinstalar. Por ejemplo, si desea eliminar el origen de datos de *Datadog*, seleccione el complemento **Datadog**.

1. En la página de detalles del complemento, elija la opción de desinstalar o instalar.

1. Una vez instalado un complemento, pueden pasar unos minutos antes de que el cambio se sincronice en todas las partes del espacio de trabajo. Es bueno esperar unos minutos antes de usar el complemento nuevo.

**nota**  
Puede tener 50 complementos instalados en un espacio de trabajo (además de los complementos principales predeterminados).

## Actualización de un complemento
<a name="update-plugin"></a>

**Actualización de un complemento de Grafana existente**

1. Inicie sesión en su espacio de trabajo de Amazon Managed Grafana.

1. En el menú de la izquierda, seleccione **Administración** y, a continuación, **Complementos**. Esto abre el catálogo de complementos, en el que se muestran solo los complementos instalados.

1. Seleccione el complemento que va a actualizar.

1. En la página de detalles del complemento, compruebe si hay alguna actualización disponible. Si es así, elija la opción de actualizar el complemento y elija la versión a la que desea actualizarlo.
**nota**  
Si ve una nota en la que se indica que no tiene permiso para modificar el complemento, confirme que la [administración de complementos esté habilitada](AMG-configure-workspace.md) en su espacio de trabajo. Debe tener un rol de [administrador](Grafana-user-roles.md) de su espacio de trabajo de Amazon Managed Grafana.

# Usa el complemento Fuentes de AWS datos para buscar AWS datos
<a name="aws-datasources-plugin"></a>

AWS proporciona un complemento de aplicación para facilitar el descubrimiento y el uso de AWS recursos como fuentes de datos en su espacio de trabajo de Grafana gestionado por Amazon. El complemento *AWS Data Sources* se instala de forma predeterminada en un espacio de trabajo nuevo.

El complemento AWS Data Sources requiere permisos para acceder a tus recursos con fines de descubrimiento. Para obtener más información, consulte [Permisos necesarios](#aws-ds-plugin-permissions).

## Abre el complemento AWS Data Sources
<a name="aws-ds-plugin-open"></a>

**Para abrir el complemento AWS Data Sources**

1. Inicie sesión en el espacio de trabajo de Amazon Managed Grafana.

1. En el **menú** de la parte superior izquierda, seleccione **Aplicaciones** y, a continuación, **AWS Data Sources**.

Aparece la interfaz del complemento AWS Data Sources con una lista de AWS los servicios en los que puede buscar recursos.

## Descubrimiento de recursos
<a name="aws-ds-plugin-use"></a>

**Para descubrir los recursos de su Cuenta de AWS**

1. Abre el complemento AWS Data Sources.

1. En la lista de AWS servicios, seleccione aquel en el que desee buscar recursos para usarlo como fuente de datos. Por ejemplo, seleccione **Amazon Managed Service para Prometheus**. Se le redirigirá a la pestaña **Orígenes de datos**, con el **servicio** seleccionado para usted.

1. Elija la AWS región en la que desee encontrar los recursos. Por ejemplo, seleccione `US East (N. Virginia)`.
**nota**  
Para buscar recursos, el complemento debe tener los [permisos](#aws-ds-plugin-permissions) adecuados para acceder a ese servicio en esa región.

1. Algunos servicios pueden tener varios recursos en una región. Si hay varios recursos en la región, el complemento Fuentes de AWS datos proporciona una lista entre la que elegir.

   En la lista de recursos (en este caso, Amazon Managed Service para Prometheus), seleccione el recurso que desee utilizar como origen de datos. Por ejemplo, al seleccionar un espacio de trabajo de Amazon Managed Service para Prometheus, se configurará ese recurso como origen de datos. El origen de datos está listo para usarse en sus paneles o en la supervisión con Amazon Managed Grafana.

1. Los recursos de ese servicio y región que ha aprovisionado aparecen en la parte inferior de la página.

   (Opcional) Puede elegir **Ir a la configuración** para ver y editar la configuración de ese origen de datos.

**nota**  
El complemento AWS de fuentes de datos depende de los complementos de fuentes de datos individuales que estén instalados en su espacio de trabajo. Por ejemplo, si desea utilizar la funcionalidad de AWS X-Ray , debe tener instalado el complemento del origen de datos de X-Ray del [catálogo de complementos](grafana-plugins.md#manage-plugins).

## Versiones y actualizaciones del complemento
<a name="aws-ds-plugin-versions"></a>

El complemento AWS Data Sources se actualiza periódicamente. La versión que se instala con un nuevo espacio de trabajo no suele ser la versión más reciente. Las versiones más recientes pueden tener más funcionalidades que la instalada en el espacio de trabajo. Por ejemplo, una versión más reciente podría admitir AWS servicios adicionales como fuentes de datos.

Para ver los cambios en cada versión del complemento AWS Data Sources, puedes consultar el [registro de cambios](https://grafana.com/grafana/plugins/aws-datasource-provisioner-app/?tab=changelog).

Para actualizar el complemento a una versión más reciente, siga las instrucciones estándar de [Actualización de un complemento](grafana-plugins.md#update-plugin).

**nota**  
Si actualizas el plugin AWS Data Sources a una versión más reciente, tendrás que proporcionar [permisos](#aws-ds-plugin-permissions) adicionales para las nuevas fuentes de datos que no estén gestionadas por Amazon Managed Grafana.

## Permisos necesarios
<a name="aws-ds-plugin-permissions"></a>

El complemento AWS Data Sources requiere permiso para acceder a tus AWS recursos. La forma más sencilla de hacerlo es permitir que Amazon Managed Grafana administre los permisos por usted. Para obtener información acerca de cómo configurar los permisos administrados por servicios para los orígenes de datos, consulte [Administración de los permisos de los orígenes de datos y los canales de notificación](AMG-datasource-and-notification.md). Amazon Managed Grafana puede gestionar los permisos de los AWS recursos que se incluyen en el complemento AWS Data Sources de forma predeterminada.

Si actualizas el plugin AWS Data Sources a una versión más reciente de la que viene incluida de forma predeterminada en tu espacio de trabajo, podría añadir soporte para AWS los recursos cuyos permisos no son gestionados automáticamente por Amazon Managed Grafana. En estos casos, debe agregar los permisos usted mismo. Por ejemplo, AWS IoT TwinMaker se agregó a una versión reciente del complemento (versión 1.9.0) y Grafana, gestionado por Amazon, no gestiona sus permisos.

Para obtener más información sobre los permisos de un origen de datos específico, consulte los detalles de ese origen de datos que se proporcionan en la sección [Conexión con orígenes de datos](AMG-data-sources.md). Por ejemplo, la [Conectarse a una fuente AWS IoT TwinMaker de datos](AMG-iot-twinmaker.md) sección incluye detalles sobre cómo conceder permisos de acceso a Grafana gestionada por Amazon. AWS IoT TwinMaker