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 registros.

Mensagens de erro

Nesta seção, descrevemos as mensagens de erro que podem ser exibidas e como resolver as condições de erro correspondentes.

`No completion signal within allotted timeframe` mensagem de erro

Você insere uma consulta SQL e seleciona Executar consulta. A consulta não é concluída e você vê a seguinte mensagem de erro:

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:

Reduza o intervalo em que os registros são consultados e tente fazer a consulta novamente. 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 não é possível resolver a tabela especificada na instrução FROM em uma visualização de registro específica.

Para resolver esse erro, verifique se o nome da sua tabela tem a sintaxe adequada:

Verifique se o nome da tabela segue a sintaxe exigida pelo esquema de nomenclatura da Análise de Registros. O BigQuery e a Análise de Registros têm requisitos diferentes para o nome da tabela. É possível encontrar a sintaxe necessária para o nome da tabela visualizando 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 contiverem caracteres de ponto ((.)), verifique se cada um desses campos está entre aspas simples, (`).

Por exemplo, se um ID do projeto do Google Cloud for example.com:bluebird, use a seguinte sintaxe para especificar a tabela para consultar a visualização _AllLogs do bucket de registros _Default:
```
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

Você insere e executa uma consulta SQL e, em seguida, seleciona Salvar. A caixa de diálogo Save é mostrada; no entanto, não é possível preencher a caixa de diálogo e não salvar a consulta.

Para resolver esse erro, 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ê copiou a consulta para a área de transferência, cole-a no painel Consulta, execute a consulta e, em seguida, execute a operação de salvamento.

Acesso negado à página Análise de registros

Você abre a página Análise 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 registros, executar consultas e visualizar registros, peça ao administrador para conceder a você os seguintes papéis do IAM no seu projeto:

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

Talvez você também consiga receber as permissões necessárias usando papéis personalizados ou papéis predefinidos do Logging.

As permissões necessárias para visualizar as entradas de registro e executar consultas na página Análise de registros são as mesmas necessárias para visualizar os registros na página Explorador de registros. Para informações sobre outros papéis que você precisa 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 Registros

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

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 organizacional que restringe as regiões que podem ser usadas. Os buckets de registros qualificados para upgrade para usar a Análise de registros precisam usar a região global. Se você conseguir remover a política organizacional que restringe o uso da região global, faça upgrade do bucket de registros. Caso contrário, não será possível fazer upgrade dos buckets de registros.

Falha na criação de um conjunto de dados vinculado do BigQuery

Edite um bucket de registros para criar um conjunto de dados vinculado do BigQuery ou crie um novo bucket de registros e selecione a opção para criar um conjunto de dados vinculado. No entanto, o conjunto de dados vinculado não será 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 exclusão dele está desativada.