az grafana

  • Referencia

Nota:

Esta referencia forma parte de la extensión amg para la CLI de Azure (versión 2.38.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 instancias de Azure Grafana.

Para la experiencia optimizada, no todas las API del plano de datos, documentadas en https://grafana.com/docs/grafana/latest/http_api/, se exponen. En la brecha de cobertura, póngase en contacto con ad4g@microsoft.com.

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 una instancia de Azure Managed Grafana.

 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. Tenga en cuenta que los paneles con 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 una instancia de Grafana administrada de Azure.

 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

Enumeración de instancias de Grafana administradas de Azure.

 Extensión GA
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

Mostrar detalles de una instancia de Grafana administrada de Azure.

 Extensión GA
az grafana update

Actualice una instancia de Grafana administrada de Azure.

 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 backup

Vista previa

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

--name -n

Nombre de Azure Managed Grafana.

Parámetros opcionales

--components -c

Tipos de artefactos de Grafana para realizar copias de seguridad.

valores aceptados: annotations, dashboards, datasources, folders, snapshots
--directory -d

Directorio para realizar copias de seguridad de artefactos de Grafana.

--folders-to-exclude -e

Carpetas que se excluirán en la copia de seguridad o sincronización.

--folders-to-include -i

Carpetas que se van a incluir en la copia de seguridad o sincronización.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az grafana create

cree una instancia de Azure Managed Grafana.

az grafana create --name
                  --resource-group
                  [--deterministic-outbound-ip {Disabled, Enabled}]
                  [--location]
                  [--principal-ids]
                  [--principal-types {Group, ServicePrincipal, User}]
                  [--skip-role-assignments {false, true}]
                  [--skip-system-assigned-identity {false, true}]
                  [--tags]
                  [--zone-redundancy {Disabled, Enabled}]

Parámetros requeridos

--name -n

Nombre de Azure Managed Grafana.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--deterministic-outbound-ip -i

Si está habilitado, el área de trabajo de Grafana tendrá direcciones IP de salida fijas que puede usar en el firewall de los orígenes de datos. Valor predeterminado: Deshabilitado.

valores aceptados: Disabled, Enabled
--location -l

Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--principal-ids

Identificadores de objeto de Azure AD separados por espacios para usuarios, grupos, etc., que se van a crear como Grafana Administración s. Una vez proporcionado, la CLI no hará que el usuario que ha iniciado sesión actual sea Grafana Administración.

--principal-types

Tipos de entidad de seguridad de Azure AD separados por espacios para emparejar con --principal-ids.

valores aceptados: Group, ServicePrincipal, User
--skip-role-assignments

No cree asignaciones de roles para la identidad administrada y el usuario de inicio de sesión actual.

valores aceptados: false, true
valor predeterminado: False
--skip-system-assigned-identity -s

No habilite la identidad asignada por el sistema.

valores aceptados: false, true
valor predeterminado: False
--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--zone-redundancy

Indica si se debe habilitar la redundancia de zona o no. Valor predeterminado: Deshabilitado.

valores aceptados: Disabled, Enabled
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az grafana delete

Elimine una instancia de Grafana administrada de Azure.

az grafana delete --name
                  [--resource-group]
                  [--yes]

Parámetros requeridos

--name -n

Nombre de Azure Managed Grafana.

Parámetros opcionales

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--yes -y

No solicita confirmación.

valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az grafana list

Enumeración de instancias de Grafana administradas de Azure.

az grafana list [--resource-group]

Parámetros opcionales

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az grafana restore

Vista previa

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

--archive-file -a

Archivar para restaurar artefactos de Grafana desde.

--name -n

Nombre de Azure Managed Grafana.

Parámetros opcionales

--components -c

Tipos de artefactos de Grafana para realizar copias de seguridad.

valores aceptados: annotations, dashboards, datasources, folders, snapshots
--remap-data-sources -r

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.

valores aceptados: false, true
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az grafana show

Mostrar detalles de una instancia de Grafana administrada de Azure.

az grafana show --name
                [--resource-group]

Parámetros requeridos

--name -n

Nombre de Azure Managed Grafana.

Parámetros opcionales

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az grafana update

Actualice una instancia de Grafana administrada de Azure.

az grafana update --name
                  [--api-key {Disabled, Enabled}]
                  [--deterministic-outbound-ip {Disabled, Enabled}]
                  [--from-address]
                  [--from-name]
                  [--host]
                  [--major-version]
                  [--password]
                  [--public-network-access {Disabled, Enabled}]
                  [--resource-group]
                  [--skip-verify {false, true}]
                  [--smtp {Disabled, Enabled}]
                  [--start-tls-policy {MandatoryStartTLS, NoStartTLS, OpportunisticStartTLS}]
                  [--tags]
                  [--user]

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 requeridos

--name -n

Nombre de Azure Managed Grafana.

Parámetros opcionales

--api-key --service-account

Si está habilitado, podrá configurar las claves de API de Grafana y las cuentas de servicio.

valores aceptados: Disabled, Enabled
--deterministic-outbound-ip -i

Si está habilitado, el área de trabajo de Grafana tendrá direcciones IP de salida fijas que puede usar en el firewall de los orígenes de datos.

valores aceptados: Disabled, Enabled
--from-address

Dirección que se usa al enviar correos electrónicos.

--from-name

Nombre que se usará al enviar correos electrónicos.

--host

Dirección URL del servidor SMTP (puerto incluido).

--major-version

Número de versión principal de Grafana.

--password

Contraseña de usuario del servidor SMTP.

--public-network-access -p

Permitir el acceso a la red pública.

valores aceptados: Disabled, Enabled
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--skip-verify

Omita la comprobación de SSL para el servidor SMTP.

valores aceptados: false, true
--smtp

Permitir que Grafana envíe correo electrónico.

valores aceptados: Disabled, Enabled
--start-tls-policy

Directiva TLS.

valores aceptados: MandatoryStartTLS, NoStartTLS, OpportunisticStartTLS
--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--user

Nombre de usuario del servidor SMTP.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.