az grafana
Nota:
Esta referencia forma parte de la extensión amg para la CLI de Azure (versión 2.61.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az grafana . Obtenga más información sobre las extensiones.
Comandos para administrar recursos de Grafana administrados de Azure.
Comandos
Nombre | Description | Tipo | Estado |
---|---|---|---|
az grafana api-key |
Comandos para administrar claves de API. |
Extensión | GA |
az grafana api-key create |
Cree una nueva clave de API. |
Extensión | GA |
az grafana api-key delete |
Elimine una clave de API. |
Extensión | GA |
az grafana api-key list |
Enumerar las claves de API existentes. |
Extensión | GA |
az grafana backup |
Realice una copia de seguridad del contenido de una instancia de Grafana administrada de Azure en un archivo. |
Extensión | Vista previa |
az grafana create |
Cree un área de trabajo para el recurso de Grafana. Esta API es idempotente, por lo que el usuario puede crear una nueva grafana o actualizar una grafana existente. |
Extensión | GA |
az grafana dashboard |
Comandos para administrar paneles de una instancia. |
Extensión | GA |
az grafana dashboard create |
Cree un nuevo panel. |
Extensión | GA |
az grafana dashboard delete |
Eliminar un panel. |
Extensión | GA |
az grafana dashboard import |
Importe un panel. |
Extensión | GA |
az grafana dashboard list |
Enumere todos los paneles de una instancia. |
Extensión | GA |
az grafana dashboard show |
Obtenga los detalles de un panel. |
Extensión | GA |
az grafana dashboard sync |
Sincronice los paneles de Azure Managed Grafana de una instancia a otra. Los paneles de biblioteca de los paneles se incluirán automáticamente en la sincronización. Tenga en cuenta que los paneles con el estado "Aprovisionado" se omitirán debido a que son de solo lectura. |
Extensión | Vista previa |
az grafana dashboard update |
Actualizar un panel. |
Extensión | GA |
az grafana data-source |
Comandos para administrar orígenes de datos de una instancia. |
Extensión | GA |
az grafana data-source create |
Crear un origen de datos. |
Extensión | GA |
az grafana data-source delete |
Elimina un origen de datos. |
Extensión | GA |
az grafana data-source list |
Enumera todos los orígenes de datos de una instancia. |
Extensión | GA |
az grafana data-source query |
Consulte un origen de datos que tenga la implementación de back-end. |
Extensión | GA |
az grafana data-source show |
Obtenga los detalles de un origen de datos. |
Extensión | GA |
az grafana data-source update |
Actualizar un origen de datos. |
Extensión | GA |
az grafana delete |
Elimine un área de trabajo para el recurso de Grafana. |
Extensión | GA |
az grafana folder |
Comandos para administrar carpetas de una instancia. |
Extensión | GA |
az grafana folder create |
Crear una carpeta nueva. |
Extensión | GA |
az grafana folder delete |
Elimine una carpeta. |
Extensión | GA |
az grafana folder list |
Enumera todas las carpetas de una instancia. |
Extensión | GA |
az grafana folder show |
Obtenga los detalles de una carpeta. |
Extensión | GA |
az grafana folder update |
Actualice una carpeta. |
Extensión | GA |
az grafana list |
Enumere todos los recursos de las áreas de trabajo de Grafana en la suscripción especificada. |
Extensión | GA |
az grafana list-available-plugin |
Enumera todos los complementos disponibles. |
Extensión | GA |
az grafana migrate |
Migre una instancia de Grafana existente a una instancia de Grafana administrada de Azure. |
Extensión | Vista previa |
az grafana notification-channel |
Comandos para administrar canales de notificación de una instancia. |
Extensión | GA |
az grafana notification-channel create |
Cree un canal de notificación. |
Extensión | GA |
az grafana notification-channel delete |
Eliminar un canal de notificación. |
Extensión | GA |
az grafana notification-channel list |
Enumera todos los canales de notificación de una instancia. |
Extensión | GA |
az grafana notification-channel show |
Obtenga los detalles de un canal de notificación. |
Extensión | GA |
az grafana notification-channel test |
Pruebe un canal de notificación. |
Extensión | GA |
az grafana notification-channel update |
Actualice un canal de notificación. |
Extensión | GA |
az grafana restore |
Restaure una instancia de Grafana administrada de Azure desde un archivo. |
Extensión | Vista previa |
az grafana service-account |
Comandos para administrar cuentas de servicio. |
Extensión | GA |
az grafana service-account create |
Cree una nueva cuenta de servicio. |
Extensión | GA |
az grafana service-account delete |
Eliminar una cuenta de servicio. |
Extensión | GA |
az grafana service-account list |
Enumerar las cuentas de servicio existentes. |
Extensión | GA |
az grafana service-account show |
Obtenga los detalles de una cuenta de servicio. |
Extensión | GA |
az grafana service-account token |
Comandos para administrar tokens de cuenta de servicio. |
Extensión | GA |
az grafana service-account token create |
Cree un nuevo token de cuenta de servicio. |
Extensión | GA |
az grafana service-account token delete |
Elimine un token de cuenta de servicio. |
Extensión | GA |
az grafana service-account token list |
Enumerar los tokens de cuenta de servicio existentes. |
Extensión | GA |
az grafana service-account update |
Actualice una cuenta de servicio. |
Extensión | GA |
az grafana show |
Obtenga las propiedades de un área de trabajo específica para el recurso de Grafana. |
Extensión | GA |
az grafana update |
Actualice un área de trabajo para el recurso de Grafana. |
Extensión | GA |
az grafana user |
Comandos para administrar usuarios de una instancia. |
Extensión | GA |
az grafana user actual-user |
Obtenga los detalles del usuario actual. |
Extensión | GA |
az grafana user list |
Enumerar usuarios. |
Extensión | GA |
az grafana user show |
Obtenga los detalles de un usuario. |
Extensión | GA |
az grafana wait |
Coloque la CLI en un estado de espera hasta que se cumpla una condición. |
Extensión | GA |
az grafana backup
Este comando está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus
Realice una copia de seguridad del contenido de una instancia de Grafana administrada de Azure en un archivo.
az grafana backup --name
[--components {annotations, dashboards, datasources, folders, snapshots}]
[--directory]
[--folders-to-exclude]
[--folders-to-include]
[--resource-group]
Ejemplos
paneles de copia de seguridad en dos carpetas (se incluyen orígenes de datos para habilitar la reasignación de nombres al restaurar paneles en otra área de trabajo)
az grafana backup -g MyResourceGroup -n MyGrafana -d c:\temp --folders-to-include "Prod" "Compute Gateway" --components datasources dashboards folders
paneles de copia de seguridad y omitir algunas carpetas
az grafana backup -g MyResourceGroup -n MyGrafana -d c:\temp --folders-to-exclude General "Azure Monitor" --components datasources dashboards folders
Parámetros requeridos
Nombre de Azure Managed Grafana.
Parámetros opcionales
Tipos de artefactos de Grafana para realizar copias de seguridad.
Directorio para realizar copias de seguridad de artefactos de Grafana.
Carpetas que se excluirán en la copia de seguridad o sincronización.
Carpetas que se van a incluir en la copia de seguridad o sincronización.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az grafana create
Cree un área de trabajo para el recurso de Grafana. Esta API es idempotente, por lo que el usuario puede crear una nueva grafana o actualizar una grafana existente.
az grafana create --name
--resource-group
[--api-key {Disabled, Enabled}]
[--deterministic-outbound-ip {Disabled, Enabled}]
[--grafana-major-version]
[--location]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--principal-ids]
[--public-network-access {Disabled, Enabled}]
[--skip-identity {0, 1, f, false, n, no, t, true, y, yes}]
[--skip-role-assignments {0, 1, f, false, n, no, t, true, y, yes}]
[--sku-tier]
[--tags]
[--zone-redundancy {Disabled, Enabled}]
Ejemplos
Creación de un recurso de Grafana administrado de Azure con SKU estándar y acceso a la red pública habilitado
az grafana create --resource-group myResourceGroup --workspace-name myWorkspace --sku-tier Standard --public-network-access Enabled
Parámetros requeridos
Nombre del área de trabajo de Azure Managed Grafana.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros opcionales
Configuración de la clave de API de la instancia de Grafana.
Si una instancia de Grafana usa direcciones IP de salida deterministas.
La versión principal del software de Grafana que se va a dirigir.
Ubicación geográfica donde reside el recurso grafana.
No espere hasta que finalice la operación de ejecución prolongada.
Identificadores de objeto de Azure AD separados por espacios para usuarios, grupos etcetera. para que se realicen como administradores de Grafana. Una vez proporcionado, la CLI no hará que el usuario que ha iniciado sesión actual sea Grafana Admin Support shorthand-syntax, json-file y yaml-file. Intenta "??" para mostrar más.
Indique el estado para habilitar o deshabilitar el tráfico a través de la interfaz pública.
No habilite la identidad asignada por el sistema. Use esta opción si desea administrar la identidad usted mismo.
Omita la creación de asignaciones de roles predeterminadas para la identidad administrada de la instancia de Grafana y la cuenta de la CLI actual. Use esta opción si desea administrar las asignaciones de roles usted mismo.
SKU del recurso grafana.
Etiquetas para el recurso de grafana. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.
Configuración de redundancia de zona de la instancia de Grafana.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az grafana delete
Elimine un área de trabajo para el recurso de Grafana.
az grafana delete [--ids]
[--name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
[--yes]
Parámetros opcionales
Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".
Nombre del área de trabajo de Azure Managed Grafana.
No espere hasta que finalice la operación de ejecución prolongada.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
No solicita confirmación.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az grafana list
Enumere todos los recursos de las áreas de trabajo de Grafana en la suscripción especificada.
az grafana list [--max-items]
[--next-token]
[--resource-group]
Parámetros opcionales
Número total de elementos que se van a devolver en la salida del comando. Si el número total de elementos disponibles es mayor que el valor especificado, se proporciona un token en la salida del comando. Para reanudar la paginación, proporcione el valor del token en --next-token
el argumento de un comando posterior.
Token para especificar dónde iniciar la paginación. Este es el valor del token de una respuesta truncada anteriormente.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az grafana list-available-plugin
Enumera todos los complementos disponibles.
az grafana list-available-plugin [--ids]
[--name]
[--resource-group]
[--subscription]
Parámetros opcionales
Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".
Nombre del área de trabajo de Azure Managed Grafana.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az grafana migrate
Este comando está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus
Migre una instancia de Grafana existente a una instancia de Grafana administrada de Azure.
az grafana migrate --name
--src-endpoint
--src-token-or-key
[--dry-run {false, true}]
[--folders-to-exclude]
[--folders-to-include]
[--overwrite {false, true}]
[--resource-group]
Ejemplos
Migre paneles y carpetas de una instancia local de Grafana a una instancia de Grafana administrada de Azure.
az grafana migrate -g MyResourceGroup -n MyGrafana -s http://localhost:3000 -t YourServiceTokenOrAPIKey
Parámetros requeridos
Nombre de Azure Managed Grafana.
Punto de conexión de instancia de Grafana desde el que se va a migrar.
Token de servicio de instancia de Grafana (o clave de API) para obtener acceso a la migración.
Parámetros opcionales
Vista previa de los cambios sin confirmar. Tiene prioridad sobre --overwrite.
Carpetas que se excluirán en la copia de seguridad o sincronización.
Carpetas que se van a incluir en la copia de seguridad o sincronización.
Sobrescriba paneles anteriores, paneles de biblioteca y carpetas con el mismo uid o título.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az grafana restore
Este comando está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus
Restaure una instancia de Grafana administrada de Azure desde un archivo.
az grafana restore --archive-file
--name
[--components {annotations, dashboards, datasources, folders, snapshots}]
[--remap-data-sources {false, true}]
[--resource-group]
Ejemplos
Restaurar paneles. Si están en carpetas, incluya "carpetas" en la lista de componentes; use "--remap-data-sources", por lo que la CLI actualizará los paneles para que apunten a los mismos orígenes de datos en el área de trabajo de destino.
az grafana restore -g MyResourceGroup -n MyGrafana --archive-file backup\dashboards\ServiceHealth-202307051036.tar.gz --components dashboards folders --remap-data-sources
Parámetros requeridos
Archivar para restaurar artefactos de Grafana desde.
Nombre de Azure Managed Grafana.
Parámetros opcionales
Tipos de artefactos de Grafana para realizar copias de seguridad.
Durante la restauración, actualice los paneles para hacer referencia a orígenes de datos definidos en el área de trabajo de destino mediante la coincidencia de nombres.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az grafana show
Obtenga las propiedades de un área de trabajo específica para el recurso de Grafana.
az grafana show [--ids]
[--name]
[--resource-group]
[--subscription]
Parámetros opcionales
Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".
Nombre del área de trabajo de Azure Managed Grafana.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az grafana update
Actualice un área de trabajo para el recurso de Grafana.
az grafana update [--api-key {Disabled, Enabled}]
[--deterministic-outbound-ip {Disabled, Enabled}]
[--from-address]
[--from-name]
[--grafana-major-version]
[--host]
[--ids]
[--name]
[--password]
[--public-network-access {Disabled, Enabled}]
[--resource-group]
[--skip-verify {0, 1, f, false, n, no, t, true, y, yes}]
[--sku-tier]
[--smtp {0, 1, f, false, n, no, t, true, y, yes}]
[--start-tls-policy {MandatoryStartTLS, NoStartTLS, OpportunisticStartTLS}]
[--subscription]
[--tags]
[--user]
[--zone-redundancy {Disabled, Enabled}]
Ejemplos
deshabilitar el acceso a la red pública
az grafana update -g MyResourceGroup -n MyGrafana --public-network-access disabled
habilitar la notificación de correo a través de la retransmisión SMTP sevice de mailgun
az grafana update -g MyResourceGroup -n MyGrafana --smtp enabled --from-address johndoe@outlook.com --from-name john --host "smtp.mailgun.org:587" --user "postmaster@sandbox12345.mailgun.org" --password "password" --start-tls-policy OpportunisticStartTLS --skip-verify true
Parámetros opcionales
Configuración de la clave de API de la instancia de Grafana.
Si una instancia de Grafana usa direcciones IP de salida deterministas.
Dirección que se usa al enviar correos electrónicos https://pkg.go.dev/net/mail#Address.
Nombre que se usará al enviar correos electrónicos. El valor predeterminado es "Notificación de Grafana administrada de Azure". https://pkg.go.dev/net/mail#Address
La versión principal del software de Grafana que se va a dirigir.
Nombre de host del servidor SMTP con puerto, por ejemplo, test.email.net:587.
Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".
Nombre del área de trabajo de Azure Managed Grafana.
Contraseña de la autenticación SMTP. Si la contraseña contiene # o ;, tiene que encapsularla con comillas triples.
Indique el estado para habilitar o deshabilitar el tráfico a través de la interfaz pública.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Compruebe SSL para el servidor SMTP. El valor predeterminado es false https://pkg.go.dev/crypto/tls#Config.
SKU del recurso grafana.
Habilite esta opción para permitir que Grafana envíe correo electrónico.
Valor StartTLSPolicy de la configuración https://pkg.go.dev/github.com/go-mail/mail#StartTLSPolicysmtp.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Etiquetas para el recurso de grafana. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.
Usuario de la autenticación SMTP.
Configuración de redundancia de zona de la instancia de Grafana.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az grafana wait
Coloque la CLI en un estado de espera hasta que se cumpla una condición.
az grafana wait [--created]
[--custom]
[--deleted]
[--exists]
[--ids]
[--interval]
[--name]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
Parámetros opcionales
Espere hasta que se cree con "provisioningState" en "Succeeded".
Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Espere hasta que se elimine.
Espere hasta que exista el recurso.
Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".
Intervalo de sondeo en segundos.
Nombre del área de trabajo de Azure Managed Grafana.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Espera máxima en segundos.
Espere hasta que se actualice con provisioningState en "Succeeded".
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.