Console Gnip

​

Visão geral

O console Enterprise (em console.gnip.com) está disponível para clientes de dados Enterprise com acesso contratado à API Enterprise. Se você não é um cliente de dados Enterprise no momento, mas gostaria de mais informações, saiba mais sobre enterprise data aqui.

Esta é uma visão geral do painel do console Enterprise da X. As seções abordadas dizem respeito a cada área específica do console, incluindo detalhes de produto, uso e gerenciamento geral da conta. Se você tiver dúvidas sobre sua conta, entre em contato com seu gerente de conta designado ou consulte nossa documentação técnica para produtos Enterprise.

Como parte do processo de avaliação e onboarding Enterprise com seu gerente de conta, clientes Enterprise receberão credenciais de acesso para console.gnip.com, que é a interface do usuário onde o acesso aos produtos Enterprise pode ser revisado e configurado. O acesso inicial ao console para o administrador do cliente é configurado pela X como parte do onboarding Enterprise, e os administradores podem então adicionar outros usuários. O console Enterprise permite gerenciar e acessar mais detalhes relacionados aos seus produtos Enterprise. 

O vídeo a seguir apresenta uma visão geral das várias partes do painel do console.gnip.com. 

Aviso: observe que alguns recursos exibidos no vídeo, incluindo certos enriquecimentos de stream e produtos de fontes de dados que não são da X, podem não estar mais disponíveis.

​

Aba Products

Ao fazer login na sua conta em console.gnip.com, você acessará a aba Products do painel. Esta página apresenta uma visão geral dos produtos Enterprise atualmente disponíveis na sua conta.

Para produtos que usam entrega via stream, como PowerTrack ou Decahose, esta página lista o nome do produto, o rótulo do stream, o número de conexões ativas no momento, o número de regras atualmente ativas para cada um (quando aplicável) e a contagem bruta de atividades (por exemplo, Posts) entregues nas últimas 24 horas.

Para produtos com entrega via REST, como a Search API, esta página lista o nome do produto, os rótulos (também exibidos como “streams”), as atividades atuais (por exemplo, Posts) retornadas por meio desses endpoints e algumas contagens de solicitações por endpoint.

Observe que a Usage API fornece grande parte desses dados de forma programática.

Detalhes específicos por stream estão disponíveis ao clicar no nome ou no botão de configurações.

​

Visão geral

Ao clicar em um dos streams no painel principal, você será levado a uma página de visão geral desse stream.

Para produtos de entrega via streaming, esta página inclui:

1. Um gráfico de volume com o número de atividades entregues a você por cada conexão específica do stream

2. Detalhes (id da conexão e endereço IP) das conexões atualmente ativas no stream

3. Um log de eventos recentes de conexão, desconexão e atualização de regras do seu stream

Observe que a escala do gráfico pode ser ajustada pelos links no canto superior direito. A visibilidade de conexões e desconexões individuais pode ser alternada clicando na chave correspondente na legenda logo abaixo do gráfico.

​

Conexões

A página Conexões apresenta detalhes sobre eventos de conexão recentes no seu stream. Isso inclui os horários de início e término de cada conexão (em UTC de 24 horas), a duração de cada conexão, o IP do servidor que realizou a conexão, um ID de conexão exclusivo para referência e o status atual da conexão. O status corresponde ao evento mais recente da conexão especificada — por exemplo, Cliente conectado ou uma desconexão, com o tipo de desconexão indicado. Para mais detalhes sobre depuração de conexões, consulte o guia sobre desconexões.

​

Ajuda da API

A página Ajuda da API fornece as URLs dos endpoints da API para seu stream, bem como o endpoint da Rules API do stream, quando aplicável. Além disso, inclui exemplos de comandos curl e instruções sobre como se conectar ao endpoint do stream e como adicionar, DELETE e listar regras programaticamente a partir do endpoint da Rules API do seu stream.

​

Regras

A guia Regras está disponível para streams do PowerTrack e oferece uma maneira rápida de começar inserindo manualmente regras em texto simples por meio da interface do usuário. Observe que a interface permite adicionar no máximo 1.000 regras por esse método manual e deve ser usada apenas para testes iniciais. Recomendamos gerenciar suas regras programaticamente por meio da Rules API em qualquer ambiente de produção.

​

Configurações

A guia Configurações permite alterar o formato de saída dos dados no seu stream, no qual há suporte para várias opções de formato. Para mudar o formato, basta usar os botões de opção que indicam as diferentes alternativas. A alteração entrará em vigor ao reconectar ao stream. Observe que a atualização dessa configuração será aplicada imediatamente na próxima solicitação ou conexão e pode fazer com que seu parser quebre com o novo formato.

Observação: A configuração recomendada para obter a maior quantidade de dados é “Leave data in the original format”, que retornará os dados no formato nativo enriquecido aqui. O formato de activity streams é descrito aqui.

​

Aba Usage

A aba Usage fornece uma visão do uso dos seus streams em diferentes períodos. Para acesso programático às informações de uso, consulte a Usage API.

​

Mensal

A página Monthly Usage exibe o uso do seu stream detalhado por produto. Por exemplo, os produtos de cobertura (como PowerTrack, Historical PowerTrack e PowerTrack Replay) para uma determinada fonte de data serão agrupados para fornecer dados separados, bem como uma contagem agregada combinada. As contagens incluem o acumulado do mês até o momento, a estimativa para o final do mês (com base no uso deste mês até agora e no tempo restante no mês) e as contagens dos dois meses anteriores.

Importante: essas contagens são desduplicadas por produto e por stream. Se você recebeu o mesmo Post por meio de várias conexões ao mesmo stream do PowerTrack, esse Post será contado apenas uma vez para esses fins. As contagens são atualizadas a cada 24 horas, às 00:00 UTC.

​

Diário

A página Uso diário fornece contagens diárias deduplicadas para cada dia do mês atual, detalhadas por produto. As contagens são atualizadas a cada 24 horas, às 00:00 UTC.

​

Regras

Os limites de regras são baseados no pacote contratado de regras do PowerTrack e se aplicam a todos os streams de um determinado “type”. As contagens são atualizadas sempre que uma nova regra é adicionada ou excluída.

​

Aba Conta

​

Meu perfil

Veja aqui os detalhes do seu perfil de usuário e altere sua senha. Além disso, você pode configurar notificações de limite de uso específicas da sua conta. As notificações de status da API estão disponíveis na página de status em https://api.twitterstat.us.

​

Configurações da conta

Você pode adicionar, remover e editar usuários, além de configurar notificações por e-mail para usuários individuais e alertas de limite de uso.

Observe que há três tipos de usuários – Account Admin, User e Email Only.  

• Account Admins podem criar/excluir/editar outros usuários e podem usar autenticação básica com nome de usuário (e-mail) e senha para se conectar às APIs Enterprise

• Users não podem criar ou modificar outros usuários, mas podem usar autenticação básica com nome de usuário (e-mail) e senha para se conectar às APIs Enterprise

• Usuários Email Only não têm acesso ao painel, não estão autorizados a se conectar às APIs Enterprise e apenas recebem notificações, se estiverem configurados para recebê-las na seção Notifications.

​

Limites de uso

Defina limites de volume para seus produtos. Eles acionam alertas por e‑mail para os usuários que configuraram essas notificações em seus perfis, tanto para o limite de aviso quanto para o limite crítico de cada produto.

Observação: esses limites são avaliados uma vez por dia às 19h30 (UTC) e não são avaliados em tempo real.