Esta página foi traduzida pela API Cloud Translation.

Resolver problemas de configuração da Análise de dados de registros

Neste documento, mostramos como resolver erros que podem ocorrer ao usar a página Análise de dados de registros do console do Google Cloud.

Mensagens de erro

Esta seção descreve as mensagens de erro que você pode ver e como resolver as condições de erro correspondentes.

`No completion signal within allotted timeframe` mensagem de erro

Digite uma consulta SQL e selecione Executar consulta. A consulta não é concluída, e a seguinte mensagem de erro é exibida:

The query failed to execute and return results due to error: No completion signal within allotted timeframe.

Para resolver esse erro, siga um destes procedimentos:

Diminua o intervalo em que os registros são consultados e tente refazer a consulta. Por exemplo, se um intervalo de consulta for de 14 dias, reduza para 7 dias e execute a consulta.
Crie um conjunto de dados vinculado do BigQuery e execute a consulta na interface do BigQuery. A interface do BigQuery é compatível com consultas que exigem um tempo de execução maior do que a interface do Cloud Logging. Para mais informações, acesse Registros de consulta usando o BigQuery.

`FROM clause must contain exactly one view` mensagem de erro

Você insere uma consulta SQL no painel de consultas da página Análise de registros no console do Google Cloud, mas o analisador SQL exibe o seguinte erro:

FROM clause must contain exactly one log view

O erro anterior é informado quando a tabela especificada na instrução FROM não pode ser resolvida em uma visualização de registros específica.

Para resolver esse erro, certifique-se de que o nome da tabela tenha a sintaxe correta:

Verifique se o nome da tabela segue a sintaxe exigida pelo esquema de nomenclatura da Análise de dados de registros. O BigQuery e a Análise de dados de registros têm requisitos diferentes para o nome da tabela. Para encontrar a sintaxe necessária para o nome da tabela, visualize a consulta padrão.
Se o ID do projeto, a região, o ID do bucket ou o ID da visualização do Google Cloud de um bucket de registros contiver caracteres de ponto ((.)), verifique se cada um desses campos está agrupado por aspas simples, (`).

Por exemplo, se um ID do projeto do Google Cloud for example.com:bluebird, para consultar a visualização _AllLogs do bucket de registros _Default, use a seguinte sintaxe para especificar a tabela:
```
SELECT *
FROM `example.com:bluebird`.`global`.`_Default`.`_AllLogs`
```
A consulta anterior pressupõe que o bucket _Default está na região global.

Não foi possível salvar uma consulta

Se você inserir e executar uma consulta SQL e a opção Salvar estiver desativada, as configurações de recursos padrão da sua organização ou pasta definirão um local não permitido pela política da organização. Para resolver isso, peça ao administrador da organização para definir um local nas configurações de recursos padrão que corresponda a um local permitido pela política da organização. Para mais informações, consulte Definir configurações padrão para organizações e pastas.

Se o botão Salvar estiver ativado, mas não for possível preencher a caixa de diálogo e salvar a consulta, faça o seguinte:

Verifique se a consulta não contém erros de sintaxe. Só é possível salvar consultas válidas.
Opcional: copie a consulta para a área de transferência.
Atualize a página.
Se você tiver copiado a consulta para a área de transferência, cole-a no painel Consulta, execute-a e salve a consulta.

Acesso negado à página Análise de dados de registros

Você abre a página Análise de dados de registros no console do Google Cloud e uma mensagem de erro de permissão negada é exibida.

Para receber as permissões necessárias para carregar a página Análise de dados de registros, executar consultas e visualizar registros, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

Veja os registros: Visualizador de registros (roles/logging.viewer)
Veja os registros em buckets personalizados: Acesso de visualização de registros (roles/logging.viewAccessor)

Também é possível receber as permissões necessárias por meio de papéis personalizados ou papéis predefinidos do Logging.

As permissões necessárias para visualizar entradas de registro e executar consultas na página Análise de registros são as mesmas que para visualizar os registros na página Análise de registros. Para informações sobre outros papéis necessários para consultar visualizações em buckets definidos pelo usuário ou para consultar a visualização _AllLogs do bucket de registros _Default, consulte Papéis do Cloud Logging.

Falha no upgrade do bucket de registros para usar a Análise de dados de registros

Você cria um bucket de registros e seleciona a opção para usar a Análise de dados de registros ou faz upgrade de um bucket de registros atual para usá-la. O upgrade falha com uma condição de erro semelhante a esta:

Failed precondition (HTTP 400): Constraint "my-constraint" violated for PROJECT_ID  with location global.

A mensagem de erro anterior indica que sua organização configurou uma política que restringe as regiões que podem ser usadas. Os buckets de registros qualificados para upgrade para usar a Análise de dados de registros precisam usar a região global. Se você remover a política organizacional que restringe o uso da região global, será possível fazer upgrade do bucket de registros. Caso contrário, não será possível fazer upgrade dos buckets de registros.

Falha ao criar um conjunto de dados vinculado do BigQuery

Você edita um bucket de registros para criar um conjunto de dados vinculado do BigQuery ou cria um novo bucket de registros e seleciona a opção para criar um conjunto de dados vinculado. No entanto, o conjunto de dados vinculado não é criado.

Para resolver esse erro, peça ao administrador do sistema do projeto do Google Cloud para conceder a você um papel do IAM que inclua a seguinte permissão:

logging.links.create

A permissão anterior está incluída nos papéis Administrador do Logging (roles/logging.admin) e Gravador de configuração de registros (roles/logging.configWriter).

Para informações sobre papéis e permissões, consulte Controle de acesso com o IAM.

Falha ao excluir um conjunto de dados vinculado do BigQuery

Você não quer mais o conjunto de dados vinculado, mas a opção de excluí-lo será desativada.