Diagnosticar e resolver problemas de um ambiente do Azure Time Series Insights Gen2

  • Artigo

Nota

O serviço Time Series Insights (TSI) deixará de ser suportado após março de 2025. Considere migrar ambientes TSI existentes para soluções alternativas o mais rapidamente possível. Para obter mais informações sobre a descontinuação e migração, visite a nossa documentação.

Este artigo resume vários problemas comuns que poderá encontrar quando trabalha com o seu ambiente do Azure Time Series Insights Gen2. O artigo também descreve potenciais causas e soluções para cada problema.

Problema: Não consigo encontrar o meu ambiente no Explorador do Gen2

Este problema poderá ocorrer se não tiver permissões para aceder ao ambiente do Time Series Insights. Os utilizadores precisam de uma função de acesso ao nível do leitor para ver o respetivo ambiente do Time Series Insights. Para verificar os níveis de acesso atuais e conceder acesso adicional, aceda à secção Políticas de Acesso a Dados no recurso do Time Series Insights no portal do Azure.

Verifique as políticas de acesso a dados.

Problema: não são vistos dados no Explorador do Gen2

Existem vários motivos comuns pelos quais os seus dados podem não aparecer no Explorador do Azure Time Series Insights Gen2.

  • A origem do evento pode não estar a receber dados.

    Verifique se a origem de eventos, que é um hub de eventos ou um hub IoT, está a receber dados das suas etiquetas ou instâncias. Para verificar, aceda à página de descrição geral do recurso no portal do Azure.

    Reveja a descrição geral das métricas do dashboard.

  • Os seus dados de origem de eventos não estão no formato JSON.

    O Time Series Insights suporta apenas dados JSON. Para exemplos JSON, leia Supported JSON shapes (Formas JSON suportadas).

  • A chave de origem do evento tem uma permissão necessária em falta.

    • Para um hub IoT, tem de fornecer a chave que tem a permissão de ligação do serviço .

      Verifique as permissões do hub IoT.

      • Tanto as políticas iothubowner como o serviço funcionam porque têm permissão de ligação de serviço .

    • Para um hub de eventos, tem de fornecer a chave que tem permissão de Escuta .

      Reveja as permissões do hub de eventos.

      • As políticas Ler e Gerir funcionam porque têm permissão de Escuta .

  • O seu grupo de consumidores fornecido não é exclusivo do Time Series Insights.

    Durante o registo de um hub IoT ou hub de eventos, especifique o grupo de consumidores utilizado para ler os dados. Este grupo de consumidores tem de ser exclusivo por ambiente. Se o grupo de consumidores for partilhado, o hub de eventos subjacente desliga automaticamente um dos leitores aleatoriamente. Forneça um grupo de consumidores exclusivo para o Time Series Insights ler.

  • A propriedade ID da Série Temporal especificada no momento do aprovisionamento está incorreta, em falta ou nula.

    Este problema poderá ocorrer se a propriedade ID da Série Temporal estiver configurada incorretamente no momento do aprovisionamento do ambiente. Para obter mais informações, leia Melhores práticas para escolher um ID de Série Temporal. Neste momento, não pode atualizar um ambiente existente do Time Series Insights para utilizar um ID de Série Temporal diferente.

Problema: alguns dados são apresentados, mas alguns estão em falta

Poderá estar a enviar dados sem o ID da Série Temporal.

  • Este problema pode ocorrer quando envia eventos sem o campo ID da Série Temporal no payload. Para obter mais informações, leia Supported JSON shapes (Formas JSON suportadas).

  • Este problema pode ocorrer porque o seu ambiente está a ser limitado.

    Nota

    Neste momento, o Time Series Insights suporta uma taxa máxima de ingestão de 1 Mbps.

Problema: os dados eram apresentados, mas agora a ingestão parou

  • A chave de origem do evento pode ter sido regenerada e o seu ambiente Gen2 precisa da nova chave de origem de eventos.

Este problema ocorre quando a chave fornecida ao criar a origem do evento já não é válida. Veria telemetria no seu hub, mas nenhuma Entrada Recebeu Mensagens no Time Series Insights. Se não tiver a certeza se a chave foi ou não regenerada, pode procurar no registo de Atividades dos Hubs de Eventos "Criar ou Atualizar Regras de Autorização do Espaço de Nomes" ou procurar "Criar ou atualizar o Recurso do IotHub" para o hub IoT.

Para atualizar o ambiente do Time Series Insights Gen2 com a nova chave, abra o recurso do hub no portal do Azure e copie a nova chave. Navegue para o recurso TSI e clique em Origens de Eventos.

Captura de ecrã a mostrar o recurso T S I com o item de menu Origens de Eventos destacado.

Selecione as origens de eventos a partir das quais a ingestão parou, cole a nova chave e clique em Guardar.

Captura de ecrã a mostrar o recurso T S I com a chave de política do hub I o T introduzida.

Problema: O nome da propriedade Carimbo de Data/Hora da minha origem de eventos não funciona

Certifique-se de que o nome e o valor estão em conformidade com as seguintes regras:

  • O nome da propriedade Carimbo de Data/Hora é sensível a maiúsculas e minúsculas.
  • O valor da propriedade Carimbo de Data/Hora proveniente da origem do evento como uma cadeia JSON tem o formato yyyy-MM-ddTHH:mm:ss.FFFFFFFK. Um exemplo de tal cadeia é "2008-04-12T12:53Z".

A forma mais fácil de garantir que o nome da propriedade Carimbo de Data/Hora é capturado e funciona corretamente é utilizar o Explorador do Time Series Insights Gen2. No Explorador do Time Series Insights Gen2, utilize o gráfico para selecionar um período de tempo depois de ter fornecido o nome da propriedade Carimbo de Data/Hora. Clique com o botão direito do rato na seleção e selecione a opção explorar eventos . O cabeçalho da primeira coluna é o nome da propriedade Carimbo de Data/Hora. Deve ter ($ts) junto à palavra Timestamp, em vez de:

  • (abc), que indica que o Time Series Insights lê os valores de dados como cadeias.
  • O ícone de calendário , que indica que o Time Series Insights lê o valor de dados como datetime.
  • #, que indica que o Time Series Insights lê os valores de dados como um número inteiro.

Se a propriedade Carimbo de Data/Hora não for especificada explicitamente, o hub IoT de um evento ou o Tempo Enqueued do hub de eventos é utilizado como o carimbo de data/hora predefinido.

Problema: Não consigo ver dados do meu arquivo quente no Explorador

  • Pode ter aprovisionado o seu arquivo quente recentemente e os dados continuam a fluir.
  • Poderá ter eliminado o seu arquivo quente, caso em que teria perdido dados.

Problema: Não consigo ver ou editar o meu Modelo de Série Temporal

  • Poderá estar a aceder a um ambiente S1 ou S2 do Time Series Insights.

    Os Modelos de Série Temporal são suportados apenas em ambientes pay as you go. Para obter mais informações sobre como aceder ao seu ambiente S1 ou S2 a partir do Explorador do Time Series Insights Gen2, leia Visualizar dados no Explorador.

    Não existem eventos no ambiente.

  • Poderá não ter permissões para ver e editar o modelo.

    Os utilizadores precisam de acesso ao nível do contribuidor para editar e ver o respetivo Modelo de Série Temporal. Para verificar os níveis de acesso atuais e conceder acesso adicional, aceda à secção Políticas de Acesso a Dados no recurso do Time Series Insights no portal do Azure.

Problema: todas as minhas instâncias no Explorador do Gen2 não têm um elemento principal

Este problema poderá ocorrer se o seu ambiente não tiver uma hierarquia de Modelo de Série Temporal definida. Para obter mais informações, leia sobre como trabalhar com Modelos de Série Temporal.

As instâncias não preparadas apresentarão um aviso.

Passos seguintes