Expresión app() de la consulta de Azure Monitorapp() expression in Azure Monitor query

La expresión app se usa en una consulta de Azure Monitor para recuperar datos de una aplicación de Application Insights específica en el mismo grupo de recursos, en otro grupo de recursos o en otra suscripción.The app expression is used in an Azure Monitor query to retrieve data from a specific Application Insights app in the same resource group, another resource group, or another subscription. Resulta útil para incluir datos de aplicación en una consulta de registros de Azure Monitor y para consultar datos a través de varias aplicaciones en una consulta de Application Insights.This is useful to include application data in an Azure Monitor log query and to query data across multiple applications in an Application Insights query.

Importante

La expresión app() no se usa si se usa un recurso de Application Insights basado en el área de trabajo, ya que los datos de registro se almacenan en un área de trabajo de Log Analytics.The app() expression is not used if you're using a workspace-based Application Insights resource since log data is stored in a Log Analytics workspace. Use la expresión log() para escribir una consulta que incluya la aplicación en varias áreas de trabajo.Use the log() expression to write a query that includes application in multiple workspaces. Si tiene varias aplicaciones en la misma área de trabajo, no se necesita realizar una consulta entre áreas de trabajo.For multiple applications in the same workspace, you don't need a cross workspace query.

SintaxisSyntax

app(Identificador)app(Identifier)

ArgumentosArguments

  • Identificador: Identifica la aplicación con uno de los formatos de la tabla siguiente.Identifier: Identifies the app using one of the formats in the table below.
IdentificadorIdentifier DescripciónDescription EjemploExample
Nombre de recursoResource Name Nombre legible de la aplicación (también conocido como "nombre del componente")Human readable name of the app (Also known as "component name") app("fabrikamapp")app("fabrikamapp")
Nombre completoQualified Name Nombre completo de la aplicación en el formato siguiente: "subscriptionName/resourceGroup/componentName"Full name of the app in the form: "subscriptionName/resourceGroup/componentName" app('AI-Prototype/Fabrikam/fabrikamapp')app('AI-Prototype/Fabrikam/fabrikamapp')
idID GUID de la aplicaciónGUID of the app app("988ba129-363e-4415-8fe7-8cbab5447518")app("988ba129-363e-4415-8fe7-8cbab5447518")
Id. de recurso de AzureAzure Resource ID Identificador del recurso de AzureIdentifier for the Azure resource app("/subscriptions/7293b69-db12-44fc-9a66-9c2005c3051d/resourcegroups/Fabrikam/providers/microsoft.insights/components/fabrikamapp")app("/subscriptions/7293b69-db12-44fc-9a66-9c2005c3051d/resourcegroups/Fabrikam/providers/microsoft.insights/components/fabrikamapp")

NotasNotes

  • Debe tener acceso de lectura a la aplicación.You must have read access to the application.
  • En la identificación de una aplicación por su nombre, se da por supuesto que este es único en todas las suscripciones accesibles.Identifying an application by its name assumes that it is unique across all accessible subscriptions. Si tiene varias aplicaciones con el nombre especificado, la consulta producirá un error debido a la ambigüedad.If you have multiple applications with the specified name, the query will fail because of the ambiguity. En este caso debe usar uno de los otros identificadores.In this case you must use one of the other identifiers.
  • Utilice la expresión relacionada área de trabajo para hacer consultas entre áreas de trabajo de Log Analytics.Use the related expression workspace to query across Log Analytics workspaces.
  • Actualmente, la expresión app() actualmente no se admite en la consulta de búsqueda cuando se usa Azure Portal para crear un regla de alerta de búsqueda de registros personalizada, salvo que se use una aplicación de Application Insights se usa como recurso para la regla de alertas.The app() expression is currently not supported in the search query when using the Azure portal to create a custom log search alert rule, unless an Application Insights application is used as the resource for the alert rule.

EjemplosExamples

app("fabrikamapp").requests | count
app("AI-Prototype/Fabrikam/fabrikamapp").requests | count
app("b438b4f6-912a-46d5-9cb1-b44069212ab4").requests | count
app("/subscriptions/7293b69-db12-44fc-9a66-9c2005c3051d/resourcegroups/Fabrikam/providers/microsoft.insights/components/fabrikamapp").requests | count
union 
(workspace("myworkspace").Heartbeat | where Computer contains "Con"),
(app("myapplication").requests | where cloud_RoleInstance contains "Con")
| count  
union 
(workspace("myworkspace").Heartbeat), (app("myapplication").requests)
| where TimeGenerated between(todatetime("2018-02-08 15:00:00") .. todatetime("2018-12-08 15:05:00"))

Pasos siguientesNext steps