Monitorando registros SiteWise do gateway Edge - AWS IoT SiteWise

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Monitorando registros SiteWise do gateway Edge

Você pode configurar seu gateway AWS IoT SiteWise Edge para registrar informações no Amazon CloudWatch Logs ou no sistema de arquivos local.

Usando o Amazon CloudWatch Logs

Você pode configurar seu gateway SiteWise Edge para enviar registros para o CloudWatch Logs. Para obter mais informações, consulte Habilitar o registro para CloudWatch registros no Guia do AWS IoT Greengrass Version 2 desenvolvedor.

Para configurar e acessar CloudWatch registros (console)
  1. Navegue até o console do CloudWatch.

  2. No painel de navegação, escolha Grupos de logs.

  3. Você pode encontrar os registros de AWS IoT SiteWise componentes nos seguintes grupos de registros:

    • /aws/greengrass/UserComponent/region/aws.iot.SiteWiseEdgeCollectorOpcua— Os registros do componente do gateway SiteWise Edge que coleta dados das fontes OPC-UA do gateway SiteWise Edge.

    • /aws/greengrass/UserComponent/region/aws.iot.SiteWiseEdgePublisher— Os registros do componente do gateway SiteWise Edge que publica fluxos de dados OPC-UA no. AWS IoT SiteWise

    Escolha o grupo de logs para a função a ser depurada.

  4. Escolha um fluxo de log que tenha um nome que termine com o nome do seu AWS IoT Greengrass grupo. Por padrão, CloudWatch exibe primeiro o fluxo de registros mais recente.

    
              CloudWatch Registra a captura de tela da página “Grupos de registros”.
  5. Para mostrar logs dos últimos 5 minutos, faça o seguinte:

    1. Escolha personalizado no canto superior direito.

    2. Escolha Relativo.

    3. Escolha 5 minutos.

    4. Escolha Aplicar.

    
              CloudWatch Captura de tela da página “Registros”.
  6. (Opcional) Para ver menos logs, é possível escolher 1m no canto superior direito.

  7. Role até a parte inferior das entradas de log para exibir os logs mais recentes.

Usando registros de serviço

SiteWise Os dispositivos Edge Gateway incluem arquivos de registro de serviço para ajudar a depurar problemas. As seções a seguir ajudarão você a encontrar e utilizar os arquivos de log de serviço dos componentes AWS IoT SiteWise OPC-UA Collector e AWS IoT SiteWise Publisher.

AWS IoT SiteWise Arquivo de registro do serviço OPC-UA Collector

O componente AWS IoT SiteWise OPC-UA Collector usa o seguinte arquivo de log.

Linux
/greengrass/v2/logs/aws.iot.SiteWiseEdgeCollectorOpcua.log
Windows
C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeCollectorOpcua.log
Para ver os registros desse componente
  • Execute o comando a seguir no dispositivo principal para visualizar o arquivo de log desse componente em tempo real. Substitua /greengrass/v2ou C:\greengrass\v2 pelo caminho para a pasta AWS IoT Greengrass raiz.

    Linux
    sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgeCollectorOpcua.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeCollectorOpcua.log -Tail 10 -Wait

AWS IoT SiteWise Arquivo de log do serviço do editor

O componente AWS IoT SiteWise Publisher usa o seguinte arquivo de log.

Linux
/greengrass/v2/logs/aws.iot.SiteWiseEdgePublisher.log
Windows
C:\greengrass\v2\logs\aws.iot.SiteWiseEdgePublisher.log
Para ver os registros desse componente
  • Execute o comando a seguir no dispositivo principal para visualizar o arquivo de log desse componente em tempo real. Substitua /greengrass/v2ou C:\greengrass\v2 pelo caminho para a pasta AWS IoT Greengrass raiz.

    Linux
    sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgePublisher.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgePublisher.log -Tail 10 -Wait

Usando registros de eventos

SiteWise Os dispositivos Edge Gateway incluem arquivos de registro de eventos para ajudar a depurar problemas. As seções a seguir ajudarão você a encontrar e utilizar os arquivos de registro de eventos dos componentes AWS IoT SiteWise OPC-UA Collector e AWS IoT SiteWise Publisher.

AWS IoT SiteWise Registros de eventos do OPC-UA Collector

O componente AWS IoT SiteWise OPC-UA Collector inclui um registro de eventos para ajudar os clientes a identificar e corrigir problemas. O arquivo de log é separado do arquivo de log local e é encontrado no seguinte local. Substitua /greengrass/v2ou C:\greengrass\v2 pelo caminho para a pasta AWS IoT Greengrass raiz.

Linux
/greengrass/v2/work/aws.iot.SiteWiseEdgeCollectorOpcua/logs/IotSiteWiseOpcUaCollectorEvents.log
Windows
C:\greengrass\v2\work\aws.iot.SiteWiseEdgeCollectorOpcua\logs\IotSiteWiseOpcUaCollectorEvents.log

Esse registro inclui informações detalhadas e instruções de solução de problemas. As informações de solução de problemas são fornecidas junto com o diagnóstico, com uma descrição de como solucionar o problema e, às vezes, com links para mais informações. As informações de diagnóstico incluem o seguinte:

  • Nível de gravidade

  • Timestamp

  • Informações adicionais específicas do evento

exemplo Log de exemplo
dataSourceConnectionSuccess: Summary: Successfully connected to OpcUa server Level: INFO Timestamp: '2023-06-15T21:04:16.303Z' Description: Successfully connected to the data source. AssociatedMetrics: - Name: FetchedDataStreams Description: The number of fetched data streams for this data source Value: 1.0 Namespace: IoTSiteWise Dimensions: - Name: SourceName Value: SourceName{value=OPC-UA Server} - Name: ThingName Value: test-core AssociatedData: - Name: DataSourceTrace Description: Name of the data source Data: - OPC-UA Server - Name: EndpointUri Description: The endpoint to which the connection was attempted. Data: - '"opc.tcp://10.0.0.1:1234"'

AWS IoT SiteWise Registros de eventos do editor

O componente AWS IoT SiteWise Publisher inclui um registro de eventos para ajudar os clientes a identificar e corrigir problemas. O arquivo de log é separado do arquivo de log local e é encontrado no seguinte local. Substitua /greengrass/v2ou C:\greengrass\v2 pelo caminho para a pasta AWS IoT Greengrass raiz.

Linux
/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/logs/IotSiteWisePublisherEvents.log
Windows
C:\greengrass\v2\work\aws.iot.SiteWiseEdgePublisher\logs\IotSiteWisePublisherEvents.log

Esse registro inclui informações detalhadas e instruções de solução de problemas. As informações de solução de problemas são fornecidas junto com o diagnóstico, com uma descrição de como solucionar o problema e, às vezes, com links para mais informações. As informações de diagnóstico incluem o seguinte:

  • Nível de gravidade

  • Timestamp

  • Informações adicionais específicas do evento

exemplo Log de exemplo
accountBeingThrottled: Summary: Data upload speed slowed due to quota limits Level: WARN Timestamp: '2023-06-09T21:30:24.654Z' Description: The IoT SiteWise Publisher is limited to the "Rate of data points ingested" quota for a customers account. See the associated documentation and associated metric for the number of requests that were limited for more information. Note that this may be temporary and not require any change, although if the issue continues you may need to request an increase for the mentioned quota. FurtherInformation: - https://docs.aws.amazon.com/iot-sitewise/latest/userguide/quotas.html - https://docs.aws.amazon.com/iot-sitewise/latest/userguide/troubleshooting-gateway.html#gateway-issue-data-streams AssociatedMetrics: - Name: TotalErrorCount Description: The total number of errors of this type that occurred. Value: 327724.0 AssociatedData: - Name: AggregatePropertyAliases Description: The aggregated property aliases of the throttled data. FileLocation: /greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/./logs/data/AggregatePropertyAliases_1686346224654.log