​

Práticas recomendadas e perguntas frequentes

​

Práticas recomendadas

• Cada nível de desempenho vem com uma determinada quantidade de cache. É uma boa ideia calcular o volume diário de dados e decidir quantos dias de dados você deseja manter em cache. Uma pequena margem ou um volume de dados bem conhecido permite que qualquer pessoa que execute consultas saiba quando esperar o desempenho ideal. Também é recomendável executar visualizações com base nesse desempenho esperado para obter resultados rápidos.
  • Por exemplo, um estúdio tem um volume de dados de 5 GB/dia. Selecionar um tamanho de cache de 450+ permite manter 90 dias de dados em cache. Executar todas as visualizações em uma janela móvel de 90 dias será eficiente. Joins, unions e consultas avançadas também serão eficientes. Outra opção seria concentrar as visualizações ao vivo principalmente em janelas de 30 dias e definir o tamanho do cache para até 90 dias durante o horário de trabalho e 30 dias fora do horário de trabalho. Isso gera grande economia de custos. Lembre-se também de que os dados são compactados no cache.
• Plataformas de visualização de dados, como o Power BI, geralmente executam várias consultas para uma única visualização. É recomendável que as visualizações sejam atualizadas em série. Se estiver sob carga pesada ou sendo usado por muitos usuários, pode fazer sentido aumentar o nível de desempenho para um nível que permita mais consultas simultâneas, liberando consultas simultâneas para ferramentas externas e analistas.
• O caso de uso mais comum para o dimensionamento agendado é aumentar a escala durante o horário de trabalho padrão e reduzi-la fora do expediente e nos fins de semana. Ao fazer grandes alterações no nível de desempenho (por exemplo, do nível 3 para o 8), é recomendável que você pretenda permanecer no nível de desempenho mais alto por várias horas. Carregar e descarregar terabytes de dados do cache rapidamente é um uso ineficiente de recursos. Todos os outros limites são aumentados instantaneamente, então você pode optar por fazer as alterações de escala, se necessário.
• O dimensionamento agendado não é mutuamente exclusivo com o dimensionamento manual. Se você perceber que precisa de mais recursos no meio do dia, poderá fazer uma alteração manual, e o dimensionamento agendado continuará conforme o esperado.
• Reduzir o armazenamento de dados pode resultar em perda de dados. Você será avisado com a mensagem “Selected retention setting is lower than current setting. Doing so may result in a loss of data.” ao tentar reduzir o armazenamento. Devido ao baixo custo do armazenamento, a retenção de longo prazo é recomendada.
• Os comandos de gerenciamento do Insights permitem criar e atualizar tabelas personalizadas. Para relatórios principais e tabelas usadas com frequência, é útil criar tabelas de agregação personalizadas. As tabelas de agregação geralmente ocupam menos espaço do que os dados de origem. Isso aumenta o desempenho das consultas e reduz a necessidade de um nível de desempenho mais alto.
  • Para automatizar a agregação de dados, recomendamos usar o Azure Data Factory, uma opção de automação escalonável e de baixo custo. Para obter mais informações sobre como usar o Azure Data Factory, consulte a seção conectividade.
• Limitar consultas usando o carimbo de data/hora é uma boa prática de gerenciamento de dados. Assim, você não extrai todos os dados dos últimos dias de uma só vez.

​

Perguntas frequentes

​

Como posso consultar dados?

1. A maneira mais simples é usar nosso explorador de dados integrado.
2. A seção conectividade tem detalhes sobre outras maneiras de acessar dados.

​

Enviei um link de autenticação da Microsoft (usando o Azure Active Directory) e ele não funcionou. O que aconteceu?

• Se você já tiver uma conta do PlayFab, precisará sair antes de aceitar um convite com um método de autenticação diferente.

​

Por que estou recebendo um erro ao tentar alterar meu nível de desempenho ou a retenção de dados?

1. Se você não se inscreveu em uma conta paga, a alteração de níveis de desempenho, retenção, exportações e alguns comandos de gerenciamento ficarão indisponíveis.
2. Se o seu cluster do Insights estiver alterando os níveis de desempenho no momento, você precisará aguardar até que a alteração seja concluída.

​

Posso alternar entre níveis de desempenho gratuitos e pagos?

• Claro! Você pode voltar para o nível gratuito se não precisar de nenhum dos recursos pagos no momento.

​

Como coloco dados no meu cluster do Insights?

1. A maioria dos serviços do PlayFab gera dados automaticamente para você.
2. Você também pode implementar sua própria telemetria por meio do PlayStream ou do nosso sistema de Telemetry.
3. Você pode usar Comandos de gerenciamento para ingerir conjuntos de dados personalizados.

​

Qual é o esquema de dados padrão para eventos do PlayFab?

• No PlayFab Insights, carregamos todos os dados de todos os eventos em uma única tabela. Essa tabela se chama [‘events.all’]. Dentro dessa tabela, você verá uma coluna chamada “EventData” que contém o payload de informações JSON de cada evento. Para obter informações completas sobre a tabela events.all, consulte Sobre a tabela events.all.

​

Por que não posso escrever SQL?

• No momento, só oferecemos suporte a consultas KQL (Kusto Query Language) na maioria dos cenários. Estamos explorando ativamente a adição de suporte a SQL. Embora o KQL exija um tempo para se acostumar, achamos que você vai gostar quando se acostumar. Para obter informações sobre como converter SQL em consultas Kusto, consulte Tradução de consultas SQL para Kusto.

​

Qual é a diferença entre Eventos por segundo no meu nível de desempenho do Insights e os custos de envio de eventos do PlayStream?

• Os eventos por segundo no seu nível de desempenho do Insights representam a ingestão de dados no seu cluster por qualquer meio. Os eventos de gravação do PlayStream e os eventos de gravação de telemetria são cobrados de forma independente e representam o custo de gravação na nuvem.

​

Posso ter um nível de desempenho mais alto do que o que vejo na minha página de gerenciamento?

• Abra um tíquete de suporte conosco e entraremos em contato para combinar algo que atenda às suas necessidades.

​

Qual é a tecnologia subjacente do PlayFab Insights?

• O PlayFab Insights usa uma variante especializada do Azure Data Explorer (Kusto).

​

Por que meu esquema de dados é diferente ao exportar usando consultas personalizadas?

• A saída da consulta personalizada inclui detalhes do processo de ETL (Extract Transform Load). Algumas colunas extras são incluídas. Essas colunas ficam ocultas no ambiente de consulta, pois não têm utilidade.

​

O que acontece se eu reduzir minha configuração de retenção para uma quantidade de dias menor do que o número total de dias para os quais tenho dados?

• Você será avisado de que, se reduzir a retenção, poderá excluir dados. Por exemplo, se você opera há um ano e reduz a retenção para seis meses, apenas os seis meses de dados mais recentes serão salvos, e o restante será descartado.

​

Como aumento o tempo limite das minhas consultas?

• Os limites de tempo das consultas são relativos ao poder de computação definido no seu nível de desempenho. Consulte a tabela de poder de computação em Desempenho e retenção, na seção de poder de computação.

​

Existe um limite para a quantidade de telemetria que posso enviar?

• Os seguintes limites existem para a chamada de API WriteTelemetryEvents:

  Nome do limite	Valor do limite	Observações
  Eventos por solicitação	200 eventos por solicitação	Exceder esse limite resulta em um erro BadRequest.
  Eventos por entidade	8.000 por segundo	Exceder esse limite resulta em um erro PerEntityEventRateLimitExceeded. Uma entidade geralmente representa um jogador individual, mas também pode ser um grupo de jogadores ou um título.
  Tamanho máximo do payload	10.240 bytes (10 KB)
  Se você atingir algum desses limites, entre em contato com a equipe de suporte do PlayFab para obter ajuda. No canto superior direito do Game Manager, selecione o ícone de ponto de interrogação e, em seguida, selecione Contact Us.

​

Recebo o erro “Query execution has exceeded the allowed limits” ao tentar executar uma consulta

• Esse erro ocorre quando o tamanho do conjunto de resultados ou o número de linhas no conjunto de resultados excede o limite permitido. Tente limitar a quantidade de dados retornados restringindo a consulta aos dados relevantes com os operadores where, limit ou summarize
• Para exportar todos os seus dados, navegue até a Event Export Tab em Data na página Title Overview no Game Manager do PlayFab.
• Se você quiser extrair apenas segmentos de dados ou se ainda estiver atingindo o limite de consulta, poderá particionar os dados por tempo ou ID exclusiva (por exemplo, Player ID, Title ID) e executar várias consultas menores. Veja a seguir um exemplo de como particionar com base no tempo:

let start = datetime(2020-08-03);
let end = datetime(2020-08-07);
['events.all'] | where Timestamp between(start .. end)

['events.all'] | limit 1000

['events.all'] | summarize count() by FullName_Name, bin(Timestamp, 1d)

• Consulte a documentação do Kusto para obter mais informações.

​

Defini as variáveis truncationmaxsize e truncationmaxrecords com um valor maior, mas ainda estou recebendo um erro

• No momento, o PlayFab Insights não oferece suporte à definição dessas variáveis. Veja acima as dicas de formulação de consultas.

​

Consultar dados do Insights impedirá a ingestão de eventos?

• Não. Os eventos do PlayFab fluirão para o banco de dados do seu título sem nenhuma
• penalidade de desempenho.

​

Minhas consultas retornam o erro “Partial query failure: Low memory condition”

• Isso significa que a consulta é complexa demais e não cabe nos limites de memória do seu nível de desempenho. Tente simplificar a consulta. Por exemplo, uma chamada summarize pode ter grupos demais, ou você pode estar tentando operar em muitas linhas de uma só vez. Você também pode atualizar seu nível de desempenho para permitir que mais memória seja alocada para cada consulta.
• Consulte a documentação do Kusto para obter mais informações.

​

Perderei dados se meu volume de eventos for maior do que o permitido pelo meu nível de desempenho?

• Não, mas você será cobrado pelos excedentes. Os excedentes são medidos no número de Insights Credits consumidos. Os preços dos Insights Credits podem ser encontrados em PlayFab.com/Pricing.

​

Como escolho o nível de desempenho?

• O nível de desempenho certo para você é mais bem determinado pelo uso do seu título. Ao aumentar o nível de desempenho, você terá acesso a mais dados em cache e a outros recursos de consulta, resultando em consultas mais rápidas. Para obter mais informações sobre níveis de desempenho, consulte Níveis de desempenho e retenção.

​

Como concedo a um usuário permissões para a página Data > Explorer de um título específico?

• Siga o guia Funções de usuário do PlayFab para acessar, criar e conceder permissões de usuário.
• Um usuário precisa das 3 permissões a seguir para acessar o Data Explorer:
  • Explorer data & tab (permissões de leitura e gravação)
  • Analytics data read access (permissões de leitura)
  • Analytics data write access (permissões de gravação)