Realización de consultas de registro en Azure Monitor que abarcan entre áreas de trabajo y aplicaciones

Los registros de Azure Monitor admiten consultas en varias áreas de trabajo de Log Analytics y la aplicación Application Insights en el mismo grupo de recursos, otro grupo de recursos u otra suscripción. Gracias a esto se consigue una vista total del sistema de datos.

Si administra suscripciones en otros inquilinos de Azure Active Directory (Azure AD) mediante Azure Lighthouse, puede incluir las áreas de trabajo de Log Analytics creadas en esos inquilinos de cliente en las consultas.

Hay dos métodos para consultar datos almacenados en varias áreas de trabajo y aplicaciones:

1. Explícitamente especificando los detalles del área de trabajo y la aplicación. Esta técnica se detalla en este artículo.
2. Usar implícitamente consultas de contexto de recursos. Al consultar en el contexto de un recurso específico, un grupo de recursos o una suscripción, los datos pertinentes se capturarán de todas las áreas de trabajo que contengan datos de estos recursos. Los datos de Application Insights que se almacenan en aplicaciones no se capturarán.

Límites de la consulta entre recursos

• El número de recursos de Application Insights y de áreas de trabajo de Log Analytics que se pueden incluir en una sola consulta se limita a 100.
• No se admite la consulta entre recursos en el Diseñador de vistas. Puede crear una consulta en Log Analytics y anclarla al panel de Azure para visualizar una consulta de registro o incluirla en los libros.
• Las consulta entre recursos en las alertas de registro solo se admiten en la API scheduledQueryRules actual. Si usa la API de alertas de Log Analytics heredada, deberá cambiar a la API actual.

Consultas a través de áreas de trabajo de Log Analytics y desde Application Insights

Para hacer referencia a otra área de trabajo en la consulta, use el identificador del área de trabajo, y, para una aplicación de Application Insights, use el identificador de la aplicación.

Identificación de los recursos del área de trabajo

En los ejemplos siguientes se muestran consultas en las áreas de trabajo de Log Analytics que devuelven recuentos de registros resumidos desde la tabla Update en un área de trabajo denominada contosoretail-it.

La identificación de un área de trabajo se puede lograr de varias maneras:

• Nombre del recurso:- es un nombre legible del área de trabajo; a veces se denomina nombre del componente.

  Importante

  Dado que los nombres de aplicación y de área de trabajo no son únicos, este identificador podría ser ambiguo. Se recomienda que la referencia sea por nombre completo, identificador de área de trabajo o identificador de recurso de Azure.

  workspace("contosoretail-it").Update | count

• Nombre completo: es el “nombre entero” del área de trabajo, compuesto por el nombre de la suscripción, el grupo de recursos y el nombre del componente con este formato: nombreSuscripción/grupoDeRecursos/nombreDeComponente.

  workspace('contoso/contosoretail/contosoretail-it').Update | count

  Nota

  Dado que los nombres de suscripción de Azure no son únicos, este identificador podría ser ambiguo.

• Identificador del área de trabajo: es el identificador único e inmutable asignado a cada área de trabajo que se representa como identificador único global (GUID).

  workspace("b459b4u5-912x-46d5-9cb1-p43069212nb4").Update | count

• Identificador de recurso de Azure: identidad única definida por Azure del área de trabajo. Se usa cuando el nombre del recurso es ambiguo. Para las áreas de trabajo, el formato es: /subscriptions/subscriptionId/resourcegroups/resourceGroup/providers/microsoft.OperationalInsights/workspaces/componentName.

  Por ejemplo:

  workspace("/subscriptions/e427519-5645-8x4e-1v67-3b84b59a1985/resourcegroups/ContosoAzureHQ/providers/Microsoft.OperationalInsights/workspaces/contosoretail-it").Update | count
  

Identificación de una aplicación

Los ejemplos siguientes devuelven un recuento resumido de las solicitudes realizadas en una aplicación denominada fabrikamapp de Application Insights.

Una aplicación de Application Insights se puede identificar con la expresión app(Identifier) . El argumento Identifier especifica la aplicación que usa uno de los siguientes:

• Nombre del recurso: es el nombre legible de la aplicación; a veces se denomina nombre del componente.

  app("fabrikamapp")

  Nota

  En la identificación de una aplicación por nombre se da por supuesto que es único en todas las suscripciones accesibles. Si tiene varias aplicaciones con el nombre especificado, la consulta produce un error debido a la ambigüedad. En este caso debe usar uno de los otros identificadores.

• Nombre completo: es el nombre completo de la aplicación, compuesto por el nombre de la suscripción, el grupo de recursos y el nombre del componente con este formato: nombreSuscripción/grupoDeRecursos/nombreDeComponente.

  app("AI-Prototype/Fabrikam/fabrikamapp").requests | count

  Nota

  Dado que los nombres de suscripción de Azure no son únicos, este identificador podría ser ambiguo.

• ID: el identificador único global de la aplicación.

  app("b459b4f6-912x-46d5-9cb1-b43069212ab4").requests | count

• Identificador de recurso de Azure: identidad única definida por Azure de la aplicación. Se usa cuando el nombre del recurso es ambiguo. El formato es: /subscriptions/IdSuscripción/resourcegroups/grupoDeRecursos/providers/microsoft.OperationalInsights/components/nombreDeComponente.

  Por ejemplo:

  app("/subscriptions/b459b4f6-912x-46d5-9cb1-b43069212ab4/resourcegroups/Fabrikam/providers/microsoft.insights/components/fabrikamapp").requests | count
  

Realizar una consulta en varios recursos

Puede consultar varios recursos desde cualquiera de las instancias de recursos; estas pueden ser áreas de trabajo y aplicaciones combinadas.

Ejemplo de consulta en dos áreas de trabajo:

union Update, workspace("contosoretail-it").Update, workspace("b459b4u5-912x-46d5-9cb1-p43069212nb4").Update
| where TimeGenerated >= ago(1h)
| where UpdateState == "Needed"
| summarize dcount(Computer) by Classification

Uso de una consulta entre recursos para varios recursos

Al usar las consultas entre recursos para correlacionar datos procedentes de varios recursos del área de trabajo de Log Analytics y de Application Insights, la consulta puede ser compleja y difícil de mantener. Debe aprovechar las funciones de las consultas de registro de Azure Monitor para separar la lógica de consulta del ámbito de los recursos de la consulta, lo que simplifica la estructura de la consulta. En el ejemplo siguiente se muestra cómo puede supervisar varios recursos de Application Insights y visualizar el número de solicitudes erróneas por nombre de la aplicación.

Cree una consulta similar a la siguiente que haga referencia al ámbito de recursos de Application Insights. El comando withsource= SourceApp agrega una columna que designa el nombre de la aplicación que envió el registro. Guarde la consulta como función con el alias applicationsScoping.

// crossResource function that scopes my Application Insights resources
union withsource= SourceApp
app('Contoso-app1').requests, 
app('Contoso-app2').requests,
app('Contoso-app3').requests,
app('Contoso-app4').requests,
app('Contoso-app5').requests

Ahora puede usar esta función en una consulta entre recursos similar a la siguiente. El alias de la función applicationsScoping devuelve la unión de la tabla de solicitudes de todas las aplicaciones definidas. A continuación, la consulta filtra las solicitudes erróneas y visualiza las tendencias por aplicación. El operador parse es opcional en este ejemplo. Extrae el nombre de la aplicación de la propiedad SourceApp.

applicationsScoping 
| where timestamp > ago(12h)
| where success == 'False'
| parse SourceApp with * '(' applicationName ')' * 
| summarize count() by applicationName, bin(timestamp, 1h) 
| render timechart

Pasos siguientes

• Consulte Análisis de los datos de Log Analytics en Azure Monitor para obtener información general de las consultas de registros y cómo se estructuran los datos del registro de Azure Monitor.