Os logs de monitoramento ajudam você a identificar erros, solucionar problemas e resolver questões relacionadas à sua organização. Use o ArcGIS Portal Administrator Directory para visualizar, consultar, configurar e excluir os logs da sua organização. O Portal Administrator Directory agrega as mensagens de log em uma tabela que você pode ler e manipular.
Os eventos registrados em cada componente da sua organização podem ser acessados no Portal Administrator Directory. Ainda pode ser necessário usar o ArcGIS Server Manager para especificar configurações de log do servidor, excluir logs e usar todas as opções de filtro.
As seções neste tópico descrevem os logs e como trabalhar com eles para resolver problemas.
- Capturar, consultar e visualizar eventos
- 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 na organização, o evento é capturado e registrado nos logs. Para visualizar mensagens associadas com o evento, consulte os logs. Para consultar e visualizar as mensagens atuais, siga estas etapas:
- Abra o Portal Administrator Directory e entre como administrador. A URL está normalmente disponível em https://webadaptorhost.example.com/webadaptorname/portaladmin.
- Clique em Logs > Consultar.
- 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 estava tentando efetuar o login, mas estava digitando 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. Isso também pode indicar que um usuário mal-intencionado está tentando acessar a organização.
Todos os eventos registram as informações acima, como o tipo de nível de log, a hora em que o evento ocorreu, o componente de origem que o registrou, a máquina na qual o evento ocorreu, o usuário associado ao evento, o código de log, o ID do processo e o ID da solicitação. Todas essas informações podem ajudar você a solucionar problemas da sua organização de forma mais eficaz. Consulte Entender logs para uma explicação detalhada dessas informações.
Quando você suspeitar que algo está errado
Se você suspeitar que há um problema com a organização, ou 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, em seguida, 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:
- 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.
- 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.
- Se o problema puder ser reproduzido, consulte os logs e revise as mensagens para informações sobre o problema:
Dica:
Se você suspeitar que o problema abrange vários componentes, é recomendável selecionar seus servidores federados ao consultar os logs. Os logs ArcGIS Data Store e logs do servidor podem fornecer informações adicionais para ajudá-lo a solucionar problemas.
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
- A organização está definida como somente leitura
O usuário não pode adicionar um anexo para um serviço da feição
Neste exemplo, um usuário relata que não consegue adicionar um anexo a um serviço de feição. O usuário tentou muitas vezes e o arquivo não irá ser transferido. Para capturar esse tipo de evento, o nível de log do portal deve primeiro ser definido como INFO.
Após o portal receber as mensagens de log no nível INFO, complete as seguintes etapas:
- Peça ao usuário para reproduzir o problema e registrar as etapas e o tempo que levou para reproduzi-lo.
- Abra o Portal Administrator Directory e entre como administrador. A URL está normalmente disponível em https://webadaptorhost.example.com/webadaptorname/portaladmin.
- Clique em Logs > Consultar.
- 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.
- Especifique a consulta para retornar as mensagens no nível de log INFO.
- No campo Usuários, especifique o nome de usuário do membro. Por exemplo, jcho para John Cho.
- Clique em Consultar.
- Revise o campo Mensagem para quaisquer mensagens relacionadas ao problema.
Você revela uma mensagem informando o seguinte:
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
Para capturar esse tipo de evento, o nível de log do portal deve primeiro ser definido como AVISO ou inferior.
Após o portal receber as mensagens de log no nível de AVISO, complete as seguintes etapas:
- Abra o Diretório do Administrador do Portal e entre como administrador. A URL está normalmente disponível em https://webadaptorhost.example.com/webadaptorname/portaladmin.
- Clique em Logs > Consultar.
- Verifique se o nível de log está definido como o nível de log AVISO. Ignore todos os outros campos, pois isso retorna mensagens de nível de aviso para todos os usuários.
- Revise o campo Mensagem para quaisquer mensagens relacionadas ao problema.
Você revela uma mensagem informando o seguinte:
Sign in error: Invalid username or password specified for 'asmith'.
Esta mensagem informa que o usuário asmith (Ashley Smith) especificou um nome de usuário ou senha inválidos ao tentar entrar na organização. Monitore estes eventos para prevenir as tentativas de acesso sem autorizações.
O item é movido de uma pasta para outra
Para capturar esse tipo de evento, o nível de log do portal deve primeiro ser definido como INFO.
Após o portal registrar as mensagens no nível INFO, complete as seguintes etapas:
- Abra o Diretório do Administrador do Portal e entre como administrador. A URL está normalmente disponível em https://webadaptorhost.example.com/webadaptorname/portaladmin.
- Clique em Logs > Consultar.
- Verifique se o nível de log está definido como 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.
- Clique em Consultar.
- Revise o campo Mensagem para quaisquer mensagens relacionadas ao problema.
Você revela uma mensagem informando o seguinte:
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 ) da sua pasta b7557bd2691b4e74bc4ce3e373402cc6) (Home) para um subdiretório dentro desta pasta nomeada Utilities.
A organização está definida como somente leitura
Para capturar o que acontece em todos os componentes quando você define sua organização para o modo de somente leitura, o nível de log dos componentes deve primeiro ser definido como INFO ou inferior. Consulte Especificar configurações de log do portal e Especificar configurações de log do servidor para obter mais informações.
Após seus componentes receberem as mensagens de log no nível INFO ou inferior e sua organização for definida para o modo de somente leitura, complete as seguintes etapas:
- Abra o Diretório do Administrador do Portal e entre como administrador. A URL está normalmente disponível em https://webadaptorhost.example.com/webadaptorname/portaladmin.
- Clique em Logs > Consultar.
- Verifique se o nível de log está definido como INFO e clique em Consultar.
- Localize a mensagem de log indicando que a organização foi definida como somente leitura e anote o ID da solicitação dessa mensagem.
Successfully set the organization to read-only mode
- Clique em Consultar para retornar às mensagens de log de consulta.
- Insira o ID de solicitação anotado na etapa 4 no campo RequestIDs.
- Selecione Todos no campo Servidores Federados.
- Clique em Consultar e revise logs em todos os componentes relacionados à colocação da organização no modo de somente leitura.
Usando filtros de eventos em uma consulta para restringir os resultados da pesquisa
Para ajudar a restringir eventos e exibir mensagens mais relevantes, você pode consultar com base no nível de log, componente de origem, hora, um código de log específico ou intervalo de códigos, um usuário específico ou lista de usuários e ID da solicitação. Você pode combinar qualquer número destes filtros como parte da sua consulta.
Para consultar todas as mensagens de log da sua organização, você pode selecionar seus servidores federados. O tempo e o ID da solicitação podem ser usados para filtrar mensagens de log entre componentes, enquanto o restante filtrará apenas os logs do portal. Se você quiser mais opções para filtrar logs do servidor, você pode usar o ArcGIS Server Manager.
Para acessar esses filtros, efetue o login no Portal Administrator Directory e clique em Página Inicial > Logs > Consulta.
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 Tipo de log.
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 (a opção Todos a partir da lista suspensa). Para filtrar eventos do portal baseados em uma origem específica, selecione a origem desejada a partir da lista suspensa Origem.
Tempo
Para filtrar eventos para um período de tempo específico, especifique os valores de tempo desejados utilizando os campos Tempo Inicial e Tempo Final (o formato é 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 15 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.
Se selecionado, os eventos registrados em servidores federados também serão filtrados.
Códigos de log
Cada mensagem é associada com um código de log. Os códigos são organizados em várias categorias. Você pode filtrar logs do portal com base em um código específico ou em 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 do portal 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.
Solicitações de IDs
A sequência de ID única anexada a cada solicitação feita, que é carregada durante todo o ciclo de vida da solicitação no sistema. Selecione um ou todos os servidores federados se estiver filtrando por ID de solicitação para uma operação que abrange vários componentes.
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.
Servidores federados
Para solucionar problemas ou obter informações sobre operações que abrangem vários componentes do ArcGIS Enterprise, inclua logs do servidor em sua consulta selecionando um ou todos os servidores federados. Ao consultar os logs do servidor de hospedagem, os logs do ArcGIS Data Store também serão incluídos.
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.
Para excluir logs do servidor, use o ArcGIS Server Manager.