Configuración de registros de Azure Monitor y recopilación de datos de diagnóstico para Azure Logic AppsSet up Azure Monitor logs and collect diagnostics data for Azure Logic Apps

Si necesita información de depuración más completa sobre las aplicaciones lógicas durante el tiempo de ejecución, puede configurar y usar registros de Azure Monitor para registrar y almacenar información sobre los eventos y datos en tiempo de ejecución, como eventos de desencadenador, eventos de ejecución y eventos de acción en un área de trabajo de Log Analytics.To get richer debugging information about your logic apps during runtime, you can set up and use Azure Monitor logs to record and store information about runtime data and events, such as trigger events, run events, and action events in a Log Analytics workspace. Azure Monitor le ayuda a supervisar los entornos locales y en la nube para que pueda mantener más fácilmente su disponibilidad y rendimiento.Azure Monitor helps you monitor your cloud and on-premises environments so that you can more easily maintain their availability and performance. Mediante los registros de Azure Monitor, puede crear consultas de registro que le ayuden a recopilar y revisar esta información.By using Azure Monitor logs, you can create log queries that help you collect and review this information. También puede usar estos datos de diagnóstico con otros servicios de Azure, como Azure Storage y Azure Event Hubs.You can also use this diagnostics data with other Azure services, such as Azure Storage and Azure Event Hubs.

Para configurar el registro de la aplicación lógica, puede habilitar Log Analytics al crear la aplicación lógica, o bien instalar la solución de administración de Logic Apps en el área de trabajo de Log Analytics para las aplicaciones lógicas existentes.To set up logging for your logic app, you can enable Log Analytics when you create your logic app, or you can install the Logic Apps Management solution in your Log Analytics workspace for existing logic apps. Esta solución proporciona información agregada para las ejecuciones de aplicaciones lógicas e incluye detalles específicos, como el estado, el tiempo de ejecución, el estado de reenvío y los identificadores de correlación.This solution provides aggregated information for your logic app runs and includes specific details such as status, execution time, resubmission status, and correlation IDs. Luego, para habilitar el registro y la creación de consultas con esta información, configure los registros de Azure Monitor.Then, to enable logging and creating queries for this information, set up Azure Monitor logs.

En este artículo se muestra cómo habilitar en aplicaciones lógicas nuevas y existentes, cómo instalar y configurar la solución de administración de Logic Apps y cómo configurar y crear consultas para los registros de Azure Monitor.This article shows how to enable Log Analytics on new logic apps and existing logic apps, how to install and set up the Logic Apps Management solution, and how to set up and create queries for Azure Monitor logs.

PrerrequisitosPrerequisites

Antes de empezar, necesita un área de trabajo de Log Analytics.Before you start, you need a Log Analytics workspace. Si no tiene una, aprenda a crear un área de trabajo de Log Analytics.If you don't have a workspace, learn how to create a Log Analytics workspace.

Habilitación de Log Analytics para nuevas aplicaciones lógicasEnable Log Analytics for new logic apps

Puede activar Log Analytics al crear la aplicación lógica.You can turn on Log Analytics when you create your logic app.

  1. En Azure Portal, en el panel donde se proporciona la información para crear la aplicación lógica, siga estos pasos:In the Azure portal, on the pane where you provide the information to create your logic app, follow these steps:

    1. En Log Analytics, seleccione Activado.Under Log Analytics, select On.

    2. En la lista Área de trabajo de Log Analytics, seleccione el área de trabajo donde quiera enviar los datos de las ejecuciones de aplicación lógica.From the Log Analytics workspace list, select the workspace where you want to send the data from your logic app runs.

      Especificación de información de la aplicación lógica

      Después de realizar este paso, Azure crea la aplicación lógica, que ahora está asociada al área de trabajo de Log Analytics.After you finish this step, Azure creates your logic app, which is now associated with your Log Analytics workspace. Además, este paso instala automáticamente la solución Logic Apps Management en el área de trabajo.Also, this step automatically installs the Logic Apps Management solution in your workspace.

  2. Seleccione Crear cuando haya terminado.When you're done, select Create.

  3. Después de ejecutar la aplicación lógica, siga estos pasos para ver las ejecuciones de la aplicación lógica.After you run your logic app, to view your logic app runs, continue with these steps.

Instalación de la solución Logic Apps ManagementInstall Logic Apps Management solution

Si ya activó Log Analytics cuando creó su aplicación lógica, omita este paso.If you turned on Log Analytics when you created your logic app, skip this step. Ya tiene la solución de administración de Logic Apps instalada en el área de trabajo de Log Analytics.You already have the Logic Apps Management solution installed in your Log Analytics workspace.

  1. En el cuadro de búsqueda de Azure Portal, escriba log analytics workspaces y, luego, seleccione Áreas de trabajo de Log Analytics.In the Azure portal's search box, enter log analytics workspaces, and then select Log Analytics workspaces.

    Selección de "Áreas de trabajo de Log Analytics"

  2. En Áreas de trabajo de Log Analytics, seleccione su área de trabajo.Under Log Analytics workspaces, select your workspace.

    Selección del área de trabajo de Log Analytics

  3. En el panel Información general, en Introducción a Log Analytics > Configurar soluciones de supervisión, elija Ver soluciones.On the Overview pane, under Get started with Log Analytics > Configure monitoring solutions, select View solutions.

    Selección de "Ver soluciones" en el panel de información general

  4. En Información general, seleccione Agregar.Under Overview, select Add.

    Incorporación de una solución nueva en el panel de información general

  5. Después de que se abre Marketplace, en el cuadro de búsqueda, escriba logic apps management y seleccione Logic Apps Management.After the Marketplace opens, in the search box, enter logic apps management, and select Logic Apps Management.

    Selección de "Logic Apps Management" en Marketplace

  6. En el panel de descripción de la solución, seleccione Crear.On the solution description pane, select Create.

    Selección de "Crear" para agregar la solución "Logic Apps Management"

  7. Revise y confirme el área de trabajo de Log Analytics donde quiere instalar la solución y vuelva a seleccionar Crear.Review and confirm the Log Analytics workspace where you want to install the solution, and select Create again.

    Selección de "Crear" para "Logic Apps Management"

    Una vez que Azure implemente la solución en el grupo de recursos de Azure que contiene el área de trabajo de Log Analytics, la solución aparecerá en el panel de resumen del área de trabajo.After Azure deploys the solution to the Azure resource group that contains your Log Analytics workspace, the solution appears on your workspace's summary pane.

    Panel de resumen del área de trabajo

Configuración de los registros de Azure MonitorSet up Azure Monitor logs

Al almacenar información sobre eventos y datos en tiempo de ejecución en los registros de Azure Monitor, puede crear consultas de registro que le ayuden a buscar y revisar esta información.When you store information about runtime events and data in Azure Monitor logs, you can create log queries that help you find and review this information.

Nota

Después de habilitar la configuración de diagnóstico, es posible que los datos de diagnóstico no fluyan durante un periodo de hasta 30 minutos en el destino especificado, como Log Analytics, el centro de eventos o la cuenta de almacenamiento.After you enable diagnostics settings, diagnostics data might not flow for up to 30 minutes to the logs at the specified destination, such as Log Analytics, event hub, or storage account. Este retraso significa que es posible que los datos de diagnóstico de este período de tiempo no estén disponibles para que los pueda revisar.This delay means that diagnostics data from this time period might not exist for you to review. Los eventos completados y las propiedades de las que se ha realizado un seguimiento podrían no aparecer en el área de trabajo de Log Analytics durante 10-15 minutos.Completed events and tracked properties might not appear in your Log Analytics workspace for 10-15 minutes.

  1. En Azure Portal, busque y seleccione la aplicación lógica.In the Azure portal, find and select your logic app.

  2. En el menú de la aplicación lógica, en Supervisión, seleccione Configuración de diagnóstico > Agregar configuración de diagnóstico.On your logic app menu, under Monitoring, select Diagnostic settings > Add diagnostic setting.

    En "Supervisión", seleccionar "Configuración de diagnóstico" > "Agregar configuración de diagnóstico"

  3. Para crear la configuración, siga estos pasos:To create the setting, follow these steps:

    1. Proporcione un nombre para la configuración.Provide a name for the setting.

    2. Seleccione Enviar a Log Analytics.Select Send to Log Analytics.

    3. En Suscripción, seleccione la suscripción de Azure que está asociada al área de trabajo de Log Analytics.For Subscription, select the Azure subscription that's associated with your Log Analytics workspace.

    4. En Área de trabajo de Log Analytics, seleccione el área de trabajo que quiere usar.For Log Analytics Workspace, select the workspace that you want to use.

    5. En log, seleccione la categoría WorkflowRuntime, que especifica la categoría de eventos que quiere registrar.Under log, select the WorkflowRuntime category, which specifies the event category that you want to record.

    6. Para seleccionar todas las métricas, en metric, seleccione AllMetrics.To select all metrics, under metric, select AllMetrics.

    7. Cuando finalice, seleccione Guardar.When you're done, select Save.

    Por ejemplo:For example:

    Selección del área de trabajo de Log Analytics y los datos para el registro

Visualización del estado de las ejecuciones de aplicación lógicaView logic app runs status

Una vez ejecutada la aplicación lógica, puede ver los datos sobre esas ejecuciones en el área de trabajo de Log Analytics.After your logic app runs, you can view the data about those runs in your Log Analytics workspace.

  1. En Azure Portal, busque y abra el área de trabajo de Log Analytics.In the Azure portal, find and open your Log Analytics workspace.

  2. En el menú del área de trabajo, seleccione Resumen del área de trabajo > Logic Apps Management.On your workspace's menu, select Workspace summary > Logic Apps Management.

    Estado y recuento de ejecuciones de aplicación lógica

    Nota

    Si el icono de Logic Apps Management no muestra los resultados inmediatamente después de una ejecución, pruebe a seleccionar Actualizar o espere un poco antes de volver a intentarlo.If the Logic Apps Management tile doesn't immediately show results after a run, try selecting Refresh or wait for a short time before trying again.

    En este caso, las ejecuciones de aplicación lógica se agrupan por nombre y estado de ejecución.Here, your logic app runs are grouped by name or by execution status. En esta página, también se muestran detalles sobre errores en acciones o desencadenadores de las ejecuciones de aplicación lógica.This page also shows details about failures in actions or triggers for the logic app runs.

    Resumen de estado de las ejecuciones de aplicación lógica

  3. Para ver todas las ejecuciones de una aplicación lógica o un estado específicos, seleccione la fila correspondiente a la aplicación lógica o el estado.To view all the runs for a specific logic app or status, select the row for that logic app or status.

    A continuación se muestra un ejemplo con todas las ejecuciones de una aplicación lógica específica:Here is an example that shows all the runs for a specific logic app:

    Vista de las ejecuciones y el estado de la aplicación lógica

    Nota

    La funcionalidad Reenviar de esta página no está disponible actualmente.The Resubmit capability on this page is currently unavailable.

    En el caso de las acciones en las que configura propiedades con seguimiento, también puede verlas seleccionando Ver en la columna Propiedades controladas.For actions where you set up tracked properties, you can also view those properties by selecting View in the Tracked Properties column. Para buscar las propiedades controladas, use el filtro de columna.To search the tracked properties, use the column filter.

    Ver propiedades controladas de una aplicación lógica

  4. Para filtrar los resultados, puede aplicar un filtro en el cliente y en el servidor.To filter your results, you can perform both client-side and server-side filtering.

    • Filtro del lado cliente: por cada columna, seleccione los filtros que prefiera, por ejemplo:Client-side filter: For each column, select the filters that you want, for example:

      Ejemplo de filtros de columna

    • Filtro del lado servidor: para seleccionar un intervalo de tiempo específico o limitar el número de ejecuciones que se muestran, use el control de ámbito de la parte superior de la página.Server-side filter: To select a specific time window or to limit the number of runs that appear, use the scope control at the top of the page. De forma predeterminada, solo aparecen 1000 registros a la vez.By default, only 1,000 records appear at a time.

      Cambio de la ventana de tiempo

  5. Para ver todas las acciones de una ejecución específica y sus detalles, seleccione la fila de una ejecución de aplicación lógica.To view all the actions and their details for a specific run, select the row for a logic app run.

    A continuación, se muestra un ejemplo de todas las acciones y desencadenadores de una ejecución de aplicación lógica específica:Here is an example that shows all the actions and triggers for a specific logic app run:

    Ver acciones de una ejecución de aplicación lógica

Envío de datos de diagnóstico a Azure Storage y Azure Event HubsSend diagnostic data to Azure Storage and Azure Event Hubs

Además de con registros de Azure Monitor, puede usar los datos de diagnóstico de la aplicación lógica con otros servicios de Azure, por ejemplo:Along with Azure Monitor logs, you can extend how you use your logic app's diagnostic data with other Azure services, for example:

Luego puede obtener supervisión en tiempo real mediante la telemetría y los análisis de otros servicios, como Azure Stream Analytics y Power BI.You can then get real-time monitoring by using telemetry and analytics from other services, like Azure Stream Analytics and Power BI. Por ejemplo:For example:

En función de las ubicaciones en las que quiera enviar datos de diagnóstico, asegúrese primero de crear una cuenta de almacenamiento de Azure o de crear un centro de eventos de Azure.Based on the locations where you want to send diagnostic data, make sure that you first create an Azure storage account or create an Azure event hub. Después, puede seleccionar los destinos a los que quiere enviar los datos.You can then select the destinations where you want to send that data. Solo se aplican períodos de retención cuando se usa una cuenta de almacenamiento.Retention periods apply only when you use a storage account.

Envío de los datos a una cuenta de Azure Storage o a un centro de eventos

Eventos de diagnóstico de Azure MonitorAzure Monitor diagnostics events

Cada evento de diagnóstico incluye detalles sobre la aplicación lógica y ese evento, por ejemplo, el estado, la hora de inicio, la hora de finalización, etc.Each diagnostic event has details about your logic app and that event, for example, the status, start time, end time, and so on. Para configurar mediante programación la supervisión, el seguimiento y el registro, puede usar esta información con la API REST para Azure Logic Apps y la API REST para Azure Monitor.To programmatically set up monitoring, tracking, and logging, you can use this information with the REST API for Azure Logic Apps and the REST API for Azure Monitor. También puede usar las propiedades clientTrackingId y trackedProperties, que aparecen enYou can also use the clientTrackingId and trackedProperties properties, which appear in

  • clientTrackingId: si no se ha proporcionado, Azure genera de forma automática este identificador y correlaciona eventos en una ejecución de aplicación lógica, incluidos los flujos de trabajo anidados que se llamen desde la aplicación lógica.clientTrackingId: If not provided, Azure automatically generates this ID and correlates events across a logic app run, including any nested workflows that are called from the logic app. Puede especificar manualmente este identificador desde un desencadenador si pasa un encabezado x-ms-client-tracking-id con el valor de identificador personalizado en la solicitud de desencadenador.You can manually specify this ID in a trigger by passing a x-ms-client-tracking-id header with your custom ID value in the trigger request. Puede usar un desencadenador de solicitud, un desencadenador HTTP o un desencadenador de webhook.You can use a request trigger, HTTP trigger, or webhook trigger.

  • trackedProperties: Para realizar un seguimiento de las entradas o salidas de los datos de diagnóstico, puede agregar una sección trackedProperties a una acción mediante el Diseñador de aplicación lógica o directamente en la definición JSON de la aplicación lógica.trackedProperties: To track inputs or outputs in diagnostics data, you can add a trackedProperties section to an action either by using the Logic App Designer or directly in your logic app's JSON definition. Las propiedades controladas solo pueden realizar el seguimiento de entradas y salidas de acciones individuales, aunque puede usar las propiedades correlation de los eventos para crear correlaciones entre las acciones de una ejecución.Tracked properties can track only a single action's inputs and outputs, but you can use the correlation properties of events to correlate across actions in a run. Para realizar el seguimiento de más de una propiedad, agregue la sección trackedProperties y las propiedades que quiera a la definición de la acción.To track more than one property, one or more properties, add the trackedProperties section and the properties that you want to the action definition.

    Este es un ejemplo en el que se muestra el modo en que la definición de acción de la variable de inicialización incluye propiedades controladas de la entrada de la acción donde la entrada es una matriz, no un registro.Here's an example that shows how the Initialize variable action definition includes tracked properties from the action's input where the input is an array, not a record.

    {
       "Initialize_variable": {
          "type": "InitializeVariable",
          "inputs": {
             "variables": [
                {
                   "name": "ConnectorName", 
                   "type": "String", 
                   "value": "SFTP-SSH" 
                }
             ]
          },
          "runAfter": {},
          "trackedProperties": { 
             "myTrackedPropertyName": "@action().inputs.variables[0].value"
          }
       }
    }
    

    En este ejemplo se muestran varias propiedades controladas:This example show multiple tracked properties:

    "HTTP": {
       "type": "Http",
       "inputs": {
          "body": "@triggerBody()",
          "headers": {
             "Content-Type": "application/json"
          },
          "method": "POST",
          "uri": "http://store.fabrikam.com",
       },
       "runAfter": {},
       "trackedProperties": {
          "myActionHTTPStatusCode": "@action()['outputs']['statusCode']",
          "myActionHTTPValue": "@action()['outputs']['body']['<content>']",
          "transactionId": "@action()['inputs']['body']['<content>']"
       }
    }
    

En este ejemplo se muestra cómo el evento ActionCompleted incluye los atributos clientTrackingId y trackedProperties:This example shows how the ActionCompleted event includes the clientTrackingId and trackedProperties attributes:

{
   "time": "2016-07-09T17:09:54.4773148Z",
   "workflowId": "/subscriptions/XXXXXXXXXXXXXXX/resourceGroups/MyResourceGroup/providers/Microsoft.Logic/workflows/MyLogicApp",
   "resourceId": "/subscriptions/<subscription-ID>/resourceGroups/MyResourceGroup/providers/Microsoft.Logic/workflows/MyLogicApp/runs/<run-ID>/actions/Http",
   "category": "WorkflowRuntime",
   "level": "Information",
   "operationName": "Microsoft.Logic/workflows/workflowActionCompleted",
   "properties": {
      "$schema": "2016-06-01",
      "startTime": "2016-07-09T17:09:53.4336305Z",
      "endTime": "2016-07-09T17:09:53.5430281Z",
      "status": "Succeeded",
      "code": "OK",
      "resource": {
         "subscriptionId": "<subscription-ID>",
         "resourceGroupName": "MyResourceGroup",
         "workflowId": "<logic-app-workflow-ID>",
         "workflowName": "MyLogicApp",
         "runId": "08587361146922712057",
         "location": "westus",
         "actionName": "Http"
      },
      "correlation": {
         "actionTrackingId": "e1931543-906d-4d1d-baed-dee72ddf1047",
         "clientTrackingId": "<my-custom-tracking-ID>"
      },
      "trackedProperties": {
         "myTrackedPropertyName": "<value>"
      }
   }
}

Pasos siguientesNext steps