Diagnosticar e resolver problemas em seu ambiente do Azure Time Series Insights Gen1
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 .
Cuidado
Este é um artigo do Gen1.
Este artigo descreve os problemas que você pode encontrar em seu ambiente do Azure Time Series Insights. O artigo oferece possíveis causas e soluções para resolução.
Vídeo
Saiba mais sobre os desafios e mitigações comuns do Azure Time Series Insights
Problema: nenhum dado é mostrado
Se nenhum dado estiver aparecendo no explorador do Azure Time Series Insights, considere essas causas comuns.
Causa A: Os dados da origem do evento não estão no formato JSON
O Azure Time Series Insights dá suporte apenas a dados JSON. Para obter exemplos JSON, consulte formas JSON com suporte.
Causa B: A chave de origem do evento não tem uma permissão necessária
Para um hub IoT no Hub IoT do Azure, você precisa fornecer a chave que tem permissões para conectar ao serviço. Selecione a política iothubowner ou de serviço. Ambos têm permissões de conexão de serviço.
permissões de conexão de serviço do Hub IoT
Para um hub de eventos nos Event Hubs do Azure, é necessário fornecer a chave que possui permissões para escuta. O de leitura e gerenciar políticas de funcionará porque ambos têm permissões de escuta.
Causa C: o grupo de consumidores fornecido não é exclusivo do Azure Time Series Insights
Quando você registra um hub IoT ou um hub de eventos, é importante definir o grupo de consumidores que você deseja usar para ler os dados. Esse grupo de consumidores não pode ser compartilhado. Se o grupo de consumidores for compartilhado, o hub IoT subjacente ou o hub de eventos desconectará automaticamente e aleatoriamente um dos leitores. Forneça um grupo de consumidores exclusivo para o Azure Time Series Insights realizar a leitura.
Causa D: O ambiente acabou de ser provisionado
Os dados serão exibidos no gerenciador do Azure Time Series Insights em poucos minutos depois que o ambiente e seus dados forem criados pela primeira vez.
Problema: alguns dados são mostrados, mas os dados estão ausentes
Quando os dados são exibidos apenas parcialmente e os dados parecem estar em atraso, considere esses possíveis problemas.
Causa A: Seu ambiente está sendo restrito
limitação é um problema comum quando os ambientes são provisionados depois que você cria uma fonte de eventos que tem dados. O Hub IoT do Azure e os Hubs de Eventos do Azure armazenam dados por até sete dias. O Azure Time Series Insights sempre começa com o evento mais antigo na fonte do evento (primeiro a entrar, primeiro a sair, ou FIFO).
Por exemplo, se você tiver 5 milhões de eventos em uma fonte de eventos ao se conectar a um ambiente S1, de unidade única, do Azure Time Series Insights, o Azure Time Series Insights processará aproximadamente 1 milhão de eventos por dia. Pode parecer que o Azure Time Series Insights está enfrentando cinco dias de latência. Mas o que está acontecendo é que o ambiente está sendo sufocado.
Se você tiver eventos antigos na origem do evento, poderá abordar a limitação de uma das duas maneiras:
- Altere os limites de retenção da fonte de eventos para ajudar a remover eventos antigos que você não deseja exibir no Azure Time Series Insights.
- Provisione um tamanho de ambiente maior (número de unidades funcionais) para aumentar o desempenho no processamento de eventos antigos. No exemplo anterior, se você aumentar o mesmo ambiente S1 para cinco unidades por um dia, o ambiente deverá ser atualizado dentro de um dia. Se a produção estável de eventos for de 1 milhão ou menos por dia, você poderá reduzir a capacidade do evento para uma unidade depois que o Azure Time Series Insights alcançar.
O limite de restrição imposto baseia-se no tipo de SKU e na capacidade do ambiente. Todas as fontes de eventos no ambiente compartilham essa capacidade. Se a origem do evento para o hub IoT ou o hub de eventos enviar dados além dos limites impostos, você experimentará limitação e um atraso.
A figura a seguir mostra um ambiente do Azure Time Series Insights que tem um SKU de S1 e uma capacidade de 3. Ele pode processar 3 milhões de eventos por dia.
Imagine um ambiente que ingere mensagens de um hub de eventos. Ele tem uma taxa de entrada diária de cerca de 67.000 mensagens. Essa taxa se traduz em aproximadamente 46 mensagens a cada minuto.
- Se cada mensagem do hub de eventos for convertida em um único evento do Azure Time Series Insights, não haverá limitação.
- Se cada mensagem do hub de eventos for nivelada para 100 eventos do Azure Time Series Insights, 4.600 eventos deverão ser ingeridos a cada minuto.
Um ambiente de SKU S1 que tem uma capacidade de 3 pode ingressar apenas 2.100 eventos a cada minuto (1 milhão de eventos por dia = 700 eventos por minuto em três unidades = 2.100 eventos por minuto).
Para obter uma compreensão de alto nível de como funciona a lógica de nivelamento, consulte formas JSON com suporte.
Resoluções recomendadas para controle excessivo
Para corrigir o atraso, aumente a capacidade de SKU do seu ambiente. Para obter mais informações, leia Dimensionar seu ambiente do Azure Time Series Insights.
Causa B: A ingestão inicial de dados históricos desacelera a entrada
Se você conectar uma fonte de evento existente, é provável que seu hub IoT ou hub de eventos já contenha dados. O ambiente começa a extrair dados a partir do início do período de retenção de mensagens da fonte do evento. Esse processamento padrão não pode ser substituído. Você pode ativar a limitação. A limitação pode demorar um pouco para ser atualizada, pois ela ingere dados históricos.
Resoluções recomendadas para grande volume de ingestão inicial
Para corrigir o atraso:
Aumente a capacidade de SKU para o valor máximo permitido (10, nesse caso). Depois que você aumenta a capacidade, o processo de entrada começa a se atualizar muito mais rapidamente. Você será cobrado pelo aumento de capacidade. Para visualizar a rapidez com que você está se atualizando, veja o gráfico de disponibilidade no Explorador do Azure Time Series Insights.
Quando o atraso for compensado, diminua a capacidade do SKU para sua taxa de entrada normal.
Problema: os dados estavam sendo exibidos anteriormente, mas não estão mais sendo exibidos
Se o Azure Time Series Insights não estiver mais ingerindo dados, mas os eventos ainda estiverem sendo transmitidos para o Hub Iot ou o Hub de Eventos, considere essa possível causa.
Causa A: A chave de acesso do hub foi regenerada e seu ambiente precisa ser atualizado
Esse problema ocorre quando a chave fornecida quando você criou a origem do evento não é mais válida. Você veria telemetria em seu hub, mas sem Mensagens Recebidas de Entrada no Azure Time Series Insights. Se você não tiver certeza se a chave foi regenerada, pesquise no log de atividades do hub de eventos "Criar ou atualizar regras de autorização de namespace". Para um hub IoT, pesquise "Criar ou atualizar o Recurso IotHub".
Para atualizar o ambiente do Azure Time Series Insights com a nova chave, abra o recurso do hub no portal do Azure e copie a nova chave. Acesse o recurso do Azure Time Series Insights e selecione Fontes de Eventos:
Selecione a origem do evento ou as fontes das quais a ingestão parou, cole a nova chave e selecione Salvar:
Problema: a configuração do nome da propriedade do carimbo de data/hora da origem do evento não funciona
Verifique se o valor da propriedade de carimbo de data/hora proveniente da origem do evento como uma cadeia de caracteres JSON está no formato yyyy-MM-ddTHH:mm:ss. FFFFFFFK. Veja um exemplo: 2008-04-12T12:53Z.
Tenha em mente que o nome da propriedade do carimbo de data/hora é sensível a maiúsculas e minúsculas.
A maneira mais fácil de garantir que o nome da propriedade do carimbo de data/hora seja registrado e esteja em operação corretamente é usar o Explorador do Azure Time Series Insights. No explorador do Azure Time Series Insights, usando o gráfico, selecione um período de tempo após inserir o nome da propriedade do timestamp. Clique com o botão direito do mouse na seleção e selecione Explorar eventos.
O cabeçalho da primeira coluna deve ser o nome da propriedade do timestamp. Ao lado da palavra de carimbo de data/hora , ($ts) será exibido.
Os seguintes valores não serão exibidos:
- (abc): indica que o Azure Time Series Insights está lendo os valores de dados como cadeias de caracteres.
- o ícone do calendário: indica que o Azure Time Series Insights está lendo os valores de dados como valores de data e hora.
- #: indica que o Azure Time Series Insights está lendo os valores de dados como inteiros.