Trabalhar com logs do portal

O monitoramento de logs do portal ajuda você a identificar erros, solucionar problemas e abordar questões com seu portal. Utilize o ArcGIS Portal Directory para visualizar, consultar, configurar e excluir logs do portal. O ArcGIS Portal Directory agrega as mensagens de log em uma tabela que você pode ler e manipular.

As seções neste tópico de ajuda descrevem os logs do portal e como trabalhar com eles para abordar questões.

• Capturar, consultar e visualizar eventos
• Entendendo os logs
• Utilizando os filtros de evento em uma consulta para reduzir os resultados da pesquisa
• Excluir os logs

Capturar, consultar e visualizar eventos

Quando um evento ocorre no portal, o evento é capturado e registrado nos logs. Para visualizar mensagens associadas com o evento, consulte os logs. Para consultar e visualizar as mensagens atuais no seu portal, siga estas etapas:

1. Abra o ArcGIS Portal Directory e efetue o login como um Administrador. A URL está normalmente disponível em https://webadaptorhost.domain.com/webadaptorname/portaladmin.
2. Clique em Logs > Consultar.
3. Mantenha todas as configurações padrão e clique em Consultar.

Algumas mensagens são retornadas junto com informações adicionais. Por exemplo, você verá as seguintes mensagens se um usuário digitar a senha incorreta muitas vezes e tiver sua conta bloqueada:

No cenário acima, o usuário john_cho tentou entrar, mas inseriu a senha errada. Após cinco tentativas, a política de bloqueio de conta foi obrigatória e o usuário foi bloqueado da conta. Isto pode também indicar que um usuário malicioso está tentando acessar o portal.

Todos os eventos registram as informações acima, como o tipo de nível do log, a hora na qual ocorreu o evento, o componente de origem que realizou o registro, a máquina onde ocorreu o evento, o usuário associado com o evento, o código de log e ID do processo. Todas esta informações podem ajudá-lo a corrigir problemas no seu portal de forma mais eficaz. Consulte Entendendo os logs para uma explicação detalhada destas informações.

Comportamento do login de instalação e pós-instalação

Quando você instala ou atualiza o portal, o nível de log do portal é configurado para Verbose. Isto significa que mensagens muito detalhadas são anotadas durante o processo de instalação ou atualização.

Se você encontrar uma falha durante este processo e desejar revisar os logs para ajudar você a solucionar o problema, determine se você pode acessar o ArcGIS Portal Directory. Se você puder, consulte os logs e revise as mensagens. Se não, revise as mensagens de log no disco. Para acessar os logs no disco, navegue até o diretório de logs e abra o arquivo de log mais recente (por exemplo, C:\arcgisportal\logs\<machine name>\portal\portal-20150101.095803-8596-0.0.log). Se necessário, você poderá compartilhar estas informações no Esri Support.

Após o processo de instalação ou atualização completar, o nível de log do portal é configurado para Aviso por padrão. Isto significa somente restringir aoa problemas sérios que estão logados. Se um usuário do portal reportar um problema, você pode precisar alterar o nível de log para capturar mais mensagens boas deste problema específico. Para informações sobre modificar o nível de log, consulte Especificar as configurações de log do portal.

Quando você suspeitar que algo está errado

Se você suspeitar que há um problema com o portal ou se um usuário relatar um problema, reproduza o evento, capture o evento com os logs, consulte os logs para obter informações sobre o evento e use as informações no log para ajudar a resolver o problema causado pelo evento.

Se um problema for suspeito ou reportado, utilize a seguinte árvore de decisão para ajudá-lo a capturar o evento com os logs:

• Tente reproduzir o problema:
  • Se o problema puder ser reproduzido, consulte os logs e revise as mensagens para informações sobre o problema:
    1. Se nenhuma informação estiver presente, aumente o nível de criação do log. Reproduza o problema novamente, consulte os logs e revise as mensagens.
    2. Se as informações estiverem presentes nas mensagens de log, revise as informações para ajudá-lo a solucionar o problema.
  • Se o problema não puder ser reproduzido, anote o cenário que levou ao problema, caso ele volte a surgir.

Dica:

Se o problema for relacionado à publicação, é recomendado que você também revise os logs do ArcGIS Server. Os logs do ArcGIS Server podem fornecer informações adicionais para ajudá-lo a solucionar o problema de publicação.

Abaixo estão exemplos de como capturar eventos, consultar e identificá-los com os logs.

• O usuário não pode adicionar um anexo para um serviço da feição
• O usuário especifica um nome de usuário ou senha inválida
• O item é movido de uma pasta para outra

O usuário não pode adicionar um anexo para um serviço da feição

Por exemplo, um usuário reporta que ele não pode adicionar um anexo para um serviço da feição. O usuário tentou muitas vezes e o arquivo não irá ser transferido.

1. Abra o ArcGIS Portal Directory e efetue o login como um Administrador. A URL está normalmente disponível em https://webadaptorhost.domain.com/webadaptorname/portaladmin.
2. Clique em Logs > Configurações > Editar.
3. Configure o nível de log para INFO e clique em Atualizar. O portal está agora gerando log de mensagens no nível de Info.
4. Peça ao usuário para reproduzir o problema. Peça a eles para registrar os passos e o período de tempo gasto para reproduzir o problema.
5. No ArcGIS Portal Directory, clique em Logs > Consultar.
   1. Especifique os valores de tempos obtidos pelo usuário. O formato está em yyyy-mm-ddThh:mm:ss. Por exemplo, o tempo inicial é 2015-05-10T14:05:00 e o tempo final é 2015-05-10T14:03:00.
   2. Especifique a consulta para retornar as mensagens no nível de log INFO.
   3. No campo Usuários, especifique o nome de usuário do membro. Por exemplo, jcho para John Cho.
   4. Clique em Consultar.
6. Revise o campo Mensagem para quaisquer mensagens relacionadas ao problema.

Você revela uma mensagem declarando:

Failed to add attachment. File size limit of 20 MB exceeded for feature service '/gis/rest/services/Hosted/parks3k_19/FeatureServer/0/1/addAttachment'.

Você agora entende que o usuário estava tentando transferir um arquivo que excedeu o limite de tamanho do arquivo. Instrua o usuário para reduzir o tamanho do arquivo para menos que 20 MB.

O usuário especifica um nome de usuário ou senha inválida

Este tipo de evento é logado no nível padrão AVISO. Para capturar este tipo de evento, o nível de log precisa ser configurado para avisos ou mais baixo, por exemplo:

1. Abra o ArcGIS Portal Directory e efetue o login como um Administrador. A URL está normalmente disponível em https://webadaptorhost.domain.com/webadaptorname/portaladmin.
2. Clique em Logs > Configurações > Editar.
3. Verifique que o nível esteja configurado para AVISO ou mais baixo. Se não, configure o nível de log para AVISO (ou mais baixo) e clique em Atualizar.
4. Quando desejado, abra o ArcGIS Portal Directory e clique em Logs > Consultar.
5. Especifique a consulta para retornar as mensagens no nível de log AVISO. Ignore todos outros campos com o retorno das mensagens de nível de aviso para todos os usuários.
6. Revise o campo Mensagem para quaisquer mensagens relacionadas ao problema.

Você revela uma mensagem declarando:

Sign in error: Invalid username or password specified for 'asmith'.

Esta mensagem indica que o usuário asmith (Ashley Smith) especificou um nome de usuário ou senha inválida ao tentar entrar no portal. Monitore estes eventos para prevenir as tentativas de acesso sem autorizações.

O item é movido de uma pasta para outra

Para capturar este tipo de evento, aumente o nível de log para INFO, por exemplo:

1. Abra o ArcGIS Portal Directory e efetue o login como um Administrador. A URL está normalmente disponível em https://webadaptorhost.domain.com/webadaptorname/portaladmin.
2. Clique em Logs > Configurações > Editar.
3. Configure o nível de log para INFO e clique em Atualizar. O portal está agora logando mensagens no nível de Info e eventos de registros relacionados aos itens movidos de uma pasta para outra.
4. Quando desejado, abra o ArcGIS Portal Directory e clique em Logs > Consultar.
5. Especifique a consulta para retornar as mensagens no nível de log INFO. Ignore todos os outros campos, pois isto retorna as mensagens do nível de info para todos os usuários já que o nível foi configurado.
6. Revise o campo Mensagem para quaisquer mensagens relacionadas ao problema.

Você revela uma mensagem declarando:

Item moved from folder 'jcho/(Home)' to folder 'jcho/(Home)/Utilities'. Item ID is 'b7557bd2691b4e74bc4ce3e373402cc6'.

Esta mensagem indica que o usuário jcho (John Cho) moveu um item (com o ID b7557bd2691b4e74bc4ce3e373402cc6) da sua pasta (Home) para um subdiretório dentro desta pasta denominado Utilities.

Entendendo os logs

Todos os eventos registram informações específicas, como o tipo de nível do log, a hora na qual ocorreu o evento, o componente de origem que realizou o registro, a máquina onde ocorreu o evento, o usuário associado com o evento, o código de log e ID do processo. Todas esta informações podem ajudá-lo a corrigir problemas no seu portal de forma mais eficaz. As seções seguintes explicam estas informações em detalhes.

Tipo de log

Os eventos logados podem variar em seu nível de detalhes de Severo, que indica que um problema exige atenção imediata, para Verbose, o qual é um problema detalhado, mensagem informativa gerada por uso regular do portal.

O seguinte são os tipos de nível do log:

Nível	Descrição	Mensagem de amostra
Severo	Os problemas sérios que exigem atenção imediata. Este nível somente inclui mensagens severas.	The 'System/GPServer/PublishingTools' service is stopped or ArcGIS Server is not started. Verify these components are started and try again.
Aviso	Os problemas moderados que exigem atenção. Este nível também inclui mensagens severas.	Organization updated: HTTP access disabled. The portal can only be accessed through HTTPS.
Informação	Mensagens administrativas comuns do portal, inclusive mensagens sobre configurações da organização sendo atualizadas. Este nível também inclui mensagens de avisos e severas.	User 'asmith' signed in to the portal.
Ótimo	Mensagens comuns de uso do portal, como nomes de operações e pedidos recebidos. Este nível inclui severo, aviso e mensagens de informações.	Account settings updated.
Detalhado	Mensagens que fornecem mais detalhes sobre como o portal cumpre as operações e pedidos. Este nível inclui severo, aviso, informações mensagens boas.	Setting log level to VERBOSE before creating new site.
Depurar	Mensagens verbose altamente projetadas para desenvolvedores e técnicos de suporte que desejam obter uma compreensão melhor do estado do portal ao solucionar os problemas. Não utilize este nível em um ambiente de produção; ele pode causar uma diminuição no desempenho. Se você não estiver resolvendo um problema, ao contrário, utilize o nível Aviso.	Failed to update index for item '44b37137e1f64de2bec832ab82043b86'.
Desativar	O loging está desativado. Os eventos não são logados com o portal.	Não Aplicável

Mensagem

Esta é a mensagem associada com o evento logado. As mensagens variam em seu nível de detalhe baseadas no tipo de nível do log.

Hora

O tempo no qual ocorreu o evento logado. Os eventos são organizados cronologicamente, com os eventos recentes exibidos primeiro. O formato do tempo está em yyyy-mm-ddThh:mm:ss. Você pode especificar o quadro de tempo desejado para exibir ao consultar os logs.

Fonte

A origem dos eventos logados são geradas a partir dos componentes de compartilhamento, administrativo e do portal no software. Eventos relacionados à publicação e usuários são categorizados em Compartilhar. Eventos relacionados à segurança e indexação são categorizados em Admin Portal. Eventos relacionados à instalação do software são categorizados no Portal. Se desejado, você pode especificar a origem desejada para exibir ao consultar os logs.

Máquina

A máquina do portal na qual ocorreu o evento.

User

O nome de usuário que enviou o pedido resultante na mensagem de log. Esta propriedade é útil para ajudá-lo a localizar a atividade do usuário individual quando a segurança estiver habilitada.

Código

O código de log associado com a mensagem. Os códigos são organizados em diversas categorias com intervalos e conteúdo específicos. Você pode indicar um código específico ou intervalo de código para exibir ao consultar os logs.

Categoria	Intervalo	Conteúdo da mensagem
Publicação	200000–201999	Publicação e exclusão de serviços hospedados.
Gerenciamento de conteúdo	202000–203999	Adicionar, remover, atualizar e mover itens. Alterando propriedade do item. Compartilhar itens com todos, a organização e grupos.
Segurança	204000–205999	Login de usuário enterprise ou embutido Geração e configuração de token do portal. Desativando e ativando registro de conta. Desativando e ativando o ArcGIS Portal Directory. Importando ou exportando um certificado de segurança. Criar, excluir e desativar usuários. Alterar privilégios do papel de usuário. Criar e excluir papéis personalizados. Desativar e ativar HTTPS e acesso anônimo. Atualizando o armazenamento de identidade.
Gerenciamento de organização	206000–207999	Personalizando a organização da página home. Configuração da galeria, mapas base, unidades de visualização, serviços de utilitário e servidores federados. Criando e excluindo grupos. Adicionar usuários a um grupo e remover usuários de um grupo. Convidar usuários para um grupo ou aceitar um convite para um grupo. Configuração de licenças do ArcGIS Pro. Configuração do ArcGIS Web Adaptor. Modificar o local do diretório de conteúdo do portal. Configurar servidores de proxy reverso e endereçado. Exceder o número de usuários nomeados autorizados para o portal. Editar configuração e exclusão de logs.
Instalação e atualização	208000–209999	Instalação e atualização do software, criação do site da web do portal e autorização do software.
Índice de Pesquisa	210000–211999	Gerar o índice da pesquisa de item do portal.
Geral	212000–219999	Reiniciando o portal. Configurando um portal altamente disponível. Outras mensagens gerais geradas pelo uso regular do portal.

Processo

O ID de processo da máquina que logou no evento.

Utilizando os filtros de evento em uma consulta para reduzir os resultados da pesquisa

Para ajudá-lo a reduzir os eventos e a exibir mensagens mais relevantes, você pode consultar baseado no tempo, nível de log, um código de log específico ou intervalo de códigos, um usuário específico ou lista de usuários e o componente de origem do portal. Você pode combinar qualquer número destes filtros como parte da sua consulta.

Para acessar estes filtros, entre no ArcGIS Portal Directory e clique em Página Inicial > Logs > Consultar.

Nível de log

Os eventos podem variar em seu nível de detalhes de Severo, que indica que um problema exige atenção imediata, para Verbose, o qual é um problema detalhado, mensagem informativa gerada por uso regular do portal. Selecione o nível desejado a partir da lista suspensa Nível de log. Para um resumo detalhado de cada nível, consulte a seção Tipo de log acima.

Fonte

A origem de eventos logados é gerada a partir dos componentes de compartilhamento, administrativo e do portal no software. Por exemplo:

• Eventos relacionados à publicação e usuários são categorizados em Compartilhar.
• Eventos relacionados à segurança e indexação são categorizados em Admin Portal.
• Eventos relacionados à instalação do software são categorizados no Portal.

Por padrão, todas as origens são consultadas ( opção Todos a partir da lista suspensa). Para filtrar eventos baseados em uma origem específica, selecione a origem desejada a partir da lista suspensa Origem.

Hora

Para filtrar eventos para um período de tempo específico, especifique os valores de tempo desejados utilizando os campos Tempo Inicial and Tempo Final (o formato está em yyyy-mm-ddThh:mm:ss). O tempo inicial é o tempo mais recente e o tempo final é o mais antigo. Por exemplo:

• Para definir um intervalo de tempo de quinze minutos, o tempo inicial é 2015-05-01T13:15:00 e o tempo final é 2015-05-01T13:00:00.
• Para definir um intervalo de tempo de uma hora, o tempo inicial é 2015-05-01T14:00:00 e o tempo final é 2015-05-01T13:00:00.
• Para definir um dia, o tempo inicial é 2015-05-02T12:00:00 e o tempo final é 2015-05-01T12:00:00.
• Para consultar todos os logs, mantenha os campos de tempo em branco.

Se o tempo inicial for especificado e o tempo final não, todos os logs mais antigos até o tempo inicial especificado são retornados. Reciprocamente, se o tempo inicial não for especificado e o tempo final sim, todos os logs mais recentes até o tempo final especificado são retornados.

Códigos de log

Cada mensagem é associada com um código de log. Os códigos são organizados em diversas categorias, como descrito acima. Você pode filtrar baseado em um código específico ou um intervalo de códigos, por exemplo:

• Para filtrar de um único código, especifique o valor do código (por exemplo, 204028).
• Para filtrar códigos específicos, separe os códigos com uma vírgula (,) (por exemplo, 204028, 212015, 219114).
• Para filtrar baseado em um intervalo de códigos, tal como, todos os códigos na categoria de segurança, especifique código inicial e final separado por um traço (-) (por exemplo, 204000–205999).
• Para filtrar baseado em um intervalo de códigos e códigos individuais, especifique o código inicial e final (separado por um traço) e separe os códigos individuais com uma vírgula (por exemplo, 204000–205999, 212015, 219114).

Usuários

Para filtrar eventos para um usuário específico, especifique o nome de usuário desejado no campo Usuários, por exemplo:

• Para filtrar um usuário específico, especifique o nome de usuário (por exemplo, jcho para John Cho).
• Para filtrar muitos usuários, separe os nomes de usuários com uma vírgula (,) (por exemplo, jcho, asmith para John Cho e Ashley Smith).

Anotação:

O uso do caractere curinga (*) não é suportado.

Contagem de mensagem

O número de mensagens para visualizar ao executar uma consulta. As mensagens exibidas em uma única página da web. Se necessário, role para baixo na página para visualizar todas as mensagens.

Excluir os logs

Se desejar excluir os logs, clique em Home > Logs > Limpar > Limpar Logs. Este procedimento exclui todas as mensagens de log da máquina do portal. Ao depurar um cenário específico que causa problemas com seu portal, a exclusão dos logs pode ajudar a isolar o problema. Desta maneira, o log é apagado de quaisquer outros eventos, que permite a você focar na depuração do problema.