Skip To Content

Trabalhar com logs do ArcGIS Notebook Server

O ArcGIS Notebook Server registra todos os eventos que acontecem no site, e quaisquer erros associados com estes eventos, utilizando logs. Estes logs estão disponíveis para administradores do site.

Os logs são uma ferramenta importante para monitoramento e correção de problemas com seu site do ArcGIS Notebook Server. As informações fornecidas por logs podem ajudá-lo a identificar erros e a fornecer contexto sobre como direcionar os problemas e resolver os erros. Os logs também servem como um sistema de registro para eventos que ocorrem em seu site.

Por exemplo, os seguintes tipos de eventos são registrados nos logs:

  • Eventos de instalação e atualização, como autorização de software e criação de site
  • A abertura e o fechamento do ArcGIS Notebooks
  • Tarefas de limpeza realizadas pelo site
  • Eventos de gerenciamento de sites executados por administradores, como adicionar ou remover tempos de execução do notebook, criar diretórios do servidor ou definir configurações de segurança.
  • Eventos de segurança, como login de usuários no site ou importação e exportação de certificados SSL

Alguns eventos não são registrados em logs do ArcGIS Notebook Server. Isto inclui federar o site com um portal. Eventos que acontecem no ArcGIS Notebooks—adicionar conteúdo, executar células e assim por diante—não são registrados. Eventos que acontecem em contêiners do Docker da sua máquina; para visualizar logs específicos do contêiner, consulte Visualizar logs de contêiner do Docker abaixo.

Níveis de logs disponíveis

Cada log carrega um nível de detalhes de registro, que pode ser um dos seguintes, em ordem do menos detalhado ao mais detalhado:

  • Severo—Problemas sérios que exigem atenção imediata.
  • Aviso—Problemas moderados que exigem atenção.
  • Info—Mensagens administrativas comuns de site do Notebook Server, incluindo mensagens sobre criação e inicialização de serviços.
  • Bom—Mensagens comuns de uso do servidor, como nomes de solicitações de operação recebidas.
  • Verboso—Mensagens que fornecem mais detalhes sobre como o servidor realiza uma operação.
  • Depuração—Mensagens de verboso altamente projetadas para desenvolvedores e técnicos de suporte que desejam obter uma compreensão melhor do estado do servidor ao solucionar os problemas. Não recomendado para uso em sistemas de produção devido à quantidade de logs criados.

No ArcGIS Notebook Server Administrator Directory, você pode especificar o nível de log mais detalhado a ser criado. Por exemplo, se você definir o nível de detalhes para Bom, seu site do servidor registrará mensagens nos níveis Severo, Aviso, Info e Bom .

Códigos de log

Os intervalos de códigos de log estão associados a determinados tipos de mensagens. A tabela a seguir descreve os intervalos de códigos de log e seu tipo de conteúdo.

Intervalo de código de registroConteúdo da mensagem

1000-4999

Estrutura de trabalho ArcGIS Notebook Server Core

5000-6999

Docker SDK e contêiner relacionado

7000-7200

Notebooks

7200-7299

Ferramentas da Web do Notebook

7300-7399

Imagem Instantânea de Notebook

7400-7499

Trechos de Código do Notebook

Logs de consulta no Manager

A partir da versão 10.8, o ArcGIS Notebook Server Manager inclui uma página Logs. Nesta página, você pode consultar todos os logs para o seu site do ArcGIS Notebook Server.

  1. Entre no seu portal do ArcGIS Enterprise como um administrador e abra o ArcGIS Notebook Server Manager.
  2. Abra a página Logs .
  3. Os parâmetros do filtro de consulta estão na parte superior da página. Utilize qualquer um dos parâmetros para limitar ou expandir sua pesquisa.

    • Nível de log—O nível de log mínimo a ser consultado (consulte a seção acima). Ele retorna somente registros com um nível de log igual ou mais grave que este nível. O nível padrão é WARNING.
    • Tempo do log—A duração do tempo para procurar logs. Você pode limitar uma consulta aos últimos 15 minutos, última hora, últimas seis ou 24 horas, semana passada ou últimos 30 dias ou mostrar todos os logs desde que o site foi criado.
      Dica:

      Utilize o Diretório Administrator para consultar logs se você deseja especificar um horário de término diferente do presente, como logs entre três e dois dias atrás.

    • Máquina—Limite a consulta aos logs de uma das suas máquinas do ArcGIS Notebook Server ou mostre logs de todas as máquinas.
    • IDs de Solicitação—Os IDs de solicitação separados por vírgula de uma ou mais solicitações de servidor cujos logs você deseja consultar. Algumas mensagens de log estão relacionadas à uma solicitação específica.
    • Usuários—O nome de usuário de um ou mais usuários (separados por vírgulas) cujos logs relacionados devem ser consultados. Algumas mensagens de log estão relacionadas à ação de um usuário específico.
    • Códigos do log—Um ou mais códigos de log atribuídos a uma mensagem de log. Se deixado em branco, todos os códigos de log serão mostrados.

  4. Clique em Pesquisar para executar a consulta. Todos os logs que correspondem aos seus parâmetros de consulta são mostrados na tabela resultante.

Alterar configurações de log no Manager

Você também pode utilizar o ArcGIS Notebook Server Manager para alterar as configurações de log do seu site.

  1. Entre no seu portal do ArcGIS Enterprise como um administrador e abra o ArcGIS Notebook Server Manager.
  2. Abra página Configurações e clique em Logs.
  3. Você pode alterar as seguintes configurações:

    • Diretório do log—O local em disco do seu diretório de logs. Se você tiver várias máquinas em seu site, verifique se este caminho é um compartilhamento UNC.
    • Nível de log—O nível de log mais detalhado que seu site gravará. Se configurar para FINE, por exemplo, seu site não manterá os logs nos níveis VERBOSE ou DEBUG.
    • Dias para manter logs—O número de dias após os quais as mensagens de log são excluídas. Considere a memória disponível na unidade do diretório de logs, como também, a configuração Nível de log que você escolheu e o nível de atividade em seu site. Por exemplo, se você alterar o nível de log para começar a gravar em um nível mais detalhado, poderá ser necessário diminuir o número de dias no qual os logs são mantidos.

  4. Clique em Salvar para confirmar suas alterações.

Consultar logs do servidor no Diretório do Administrador

Utilize o ArcGIS Notebook Server Administrator Directory para consultar, exibir, configurar e excluir logs do servidor.

Para acessar os logs, siga estas etapas:

  1. Entre no Diretório do Administrador. A URL está formatada como https://notebookserver.domain.com:11443/arcgis/admin ou https://notebookserver.domain.com/<webadaptorname>/admin.
  2. Clique em Logs > Consultar para consultar e revisar logs atuais. Utilize os controles de filtro na página para ajudá-lo a restringir eventos por categorias, como período de tempo ou nível de registro.
  3. Clique em Logs > Configurações para gerenciar as configurações de log, como o nível de log padrão (como explicado acima), a duração para a qual os logs são mantidos no disco e o local no qual os logs são gravados.
  4. Clique em Limpar Logs para apagar todos os seus arquivos de log do site ArcGIS Notebook Server.

Visualizar logs do contêiner Docker com ArcGIS Notebook Server Manager

Você pode visualizar logs específicos de contêiners Docker do seu site utilizando ArcGIS Notebook Server Manager.

  1. Entre no ArcGIS Notebook Server Manager do seu portal como um administrador. A URL está formatada como https://webadaptorhost.domain.com/webadaptorname/home/notebook/manager.html.
  2. Navegue até a guia Contêiners.
  3. Clique no botão Exibir logs para visualiar os logs do contêiner da máquina escolhida.

Visualizar logs do contêiner Docker com a linha de comando Docker

Você pode visualizar logs específicos de contêiners Docker do seu site utilizando a interface da linha de comando Docker conforme a seguir.

  1. Entre no Diretório do Administrador. A URL está formatada como https://notebookserver.domain.com:11443/arcgis/admin ou https://notebookserver.domain.com/<webadaptorname>/admin.
  2. Navegue até Sistema > Contêiners. Localize o contêiner cujos logs você deseja visualizar e clique em seu ID.
  3. Abra a visualização de JSON da página de informações do contêiner adicionando ?f=pjson na sua URL, para que o formato da URL seja https://notebookserver.arcgis.com/<webadaptorname>/admin/system/containers/<container>?f=pjson.
  4. Localize o containerId do contêiner e registre seu valor.
  5. Abra um terminal como um usuário com privilégios do Docker.
  6. Execute o comando docker logs <containerId> utilizando o valor que você registrou. Isto retornará os logs do Docker específicos para este contêiner.