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

Nota

O serviço Time Series Insights será desativado em 7 de julho de 2024. Considere migrar ambientes existentes para soluções alternativas o mais rápido possível. Para obter mais informações sobre a substituição e a migração, visite nossa documentação .

Este artigo resume vários problemas comuns que você pode encontrar ao trabalhar com seu ambiente do Azure Time Series Insights Gen2. O artigo também descreve possíveis causas e soluções para cada problema.

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

Esse problema poderá ocorrer se você não tiver permissões para acessar o ambiente do Time Series Insights. Os usuários precisam de uma função de acesso de leitor para ver seu ambiente do Time Series Insights. Para verificar os níveis de acesso atuais e conceder acesso adicional, vá para a seção políticas de acesso a dados no recurso de Time Series Insights no portal do Azure.

Problema: nenhum dado é visto no Gen2 Explorer

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

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

  Verifique se a origem do evento, que é um hub de eventos ou um hub IoT, está recebendo dados de suas tags ou instâncias. Para verificar, vá para a página de visão geral do recurso no portal do Azure.

  Revisar visão geral das métricas do painel

• Os dados da fonte do evento não estão no formato JSON.

  O Time Series Insights dá suporte apenas a dados JSON. Para exemplos JSON, leia estruturas JSON suportadas.

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

  • Para um hub IoT, você precisa fornecer a chave que tem permissão de conexão de serviço .

    

    • As políticas iothubowner e serviço funcionam porque têm permissão de conexão de serviço.

  • Para um hub de eventos, você precisa fornecer a chave que tem permissão Escutar.

    

    • As políticas de Leitura e de Gerenciamento funcionam porque têm a permissão de Escutar .

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

  Durante o registro de um hub IoT ou hub de eventos, você especifica o grupo de consumidores usado para ler os dados. Esse grupo de consumidores deve ser exclusivo por ambiente. Se o grupo de consumidores for compartilhado, o hub de eventos subjacente desconectará automaticamente um dos leitores aleatoriamente. Forneça um grupo de consumidores exclusivo para o Time Series Insights possa ler.

• Sua ID da Série Temporal especificada no momento do provisionamento está errada, ausente ou nula.

  Esse problema poderá ocorrer se a propriedade de ID da Série Temporal estiver configurada incorretamente no momento do provisionamento do ambiente. Para obter mais informações, leia Práticas recomendadas para escolher um Identificador de Série Temporal. Neste momento, você não pode atualizar um ambiente existente do Time Series Insights para usar uma ID de Série Temporal diferente.

Problema: alguns dados são mostrados, mas alguns estão ausentes

Você pode estar enviando dados sem a ID da Série Temporal.

• Esse problema pode ocorrer quando você envia eventos sem o campo ID da Série Temporal na carga útil. Para obter mais informações, leia Formas JSON compatíveis.

• Esse problema pode ocorrer porque seu ambiente está sendo limitado.

  Nota

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

Problema: os dados estavam sendo exibidos, mas agora a ingestão foi interrompida

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

Esse problema ocorre quando a chave fornecida ao criar a origem do evento não é mais válida. Você veria a telemetria em seu hub, mas não veria as mensagens de entrada recebidas no Time Series Insights. Se você não tiver certeza se a chave foi regenerada ou não, pesquise no log de atividades dos Hubs de Eventos "Criar ou atualizar regras de autorização de namespace" ou pesquise "Criar ou atualizar o Recurso 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 até o recurso TSI e clique em Fontes de Eventos.

Selecione as fontes de evento das quais a ingestão foi interrompida, cole a nova chave e clique em Salvar.

Problema: o nome da propriedade Timestamp da fonte do evento não funciona

Verifique se o nome e o valor estão em conformidade com as seguintes regras:

• O nome da propriedade Timestamp diferencia maiúsculas de minúsculas.
• O valor da propriedade Timestamp proveniente da origem do evento como uma cadeia de caracteres JSON tem o formato yyyy-MM-ddTHH:mm:ss.FFFFFFFK. Um exemplo dessa cadeia de caracteres é "2008-04-12T12:53Z".

A maneira mais fácil de garantir que o nome da propriedade Timestamp seja capturado e funcione corretamente é usar o Explorador do Time Series Insights Gen2. No Gerenciador do Time Series Insights Gen2, use o gráfico para selecionar um período de tempo depois de fornecer o nome da propriedade Timestamp. Clique com o botão direito do mouse na seleção, e selecione a opção explorar eventos. O primeiro cabeçalho de coluna é o nome da sua propriedade Timestamp. Ele deve ter ($ts) ao lado da palavra Timestamp, em vez de:

• (abc), que indica que o Time Series Insights lê os valores de dados como cadeias de caracteres.
• O calendário ícone, 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 inteiro.

Se a propriedade Timestamp não for especificada explicitamente, o Hub IoT de um evento ou a Hora Enfileirada do hub de eventos serão usados como o carimbo de data/hora padrão.

Problema: não consigo exibir dados do meu repositório quente no Explorer

• Você pode ter provisionado seu repositório quente recentemente, e os dados ainda estão chegando.
• Você pode ter excluído seu repositório quente, caso seja assim, você teria perdido dados.

Problema: não consigo exibir nem editar meu Modelo de Série Temporal

• Você pode estar acessando um ambiente do Time Series Insights S1 ou S2.

  Os Modelos de Séries Temporais têm suporte apenas em ambientes de pagamento por uso. Para obter mais informações sobre como acessar seu ambiente S1 ou S2 no Time Series Insights Gen2 Explorer, leia Visualizar dados no Explorer.

  

• Talvez você não tenha permissões para exibir e editar o modelo.

  Os usuários precisam de acesso no nível do colaborador para editar e exibir seu Modelo de Série Temporal. Para verificar os níveis de acesso atuais e conceder acesso adicional, acesse a seção Políticas de Acesso a Dados em seu recurso do Time Series Insights no portal do Azure.

Problema: todas as minhas instâncias no Gerenciador gen2 não têm um pai

Esse problema poderá ocorrer se o 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.

Próximas etapas

• Leia sobre como trabalhar com modelos de série temporal.

• Saiba mais sobre formas JSON com suporte.

• Revise o planejamento e os limites no Azure Time Series Insights Gen2.