O ArcGIS Enterprise registra eventos que acontecem, e quaisquer erros associados com estes eventos, utilizando logs. Os logs são uma ferramenta importante para monitoramento e correção de problemas com sua organização. As informações em logs ajudarão você a identificar erros e a fornecer contexto sobre como direcionar os problemas. Os logs também representam um histórico dos eventos que acontecem ao longo do tempo.
Por exemplo, os seguintes eventos são registrados em logs:
- Instalação e atualização de eventos, como autorização do software e criação do portal
- Publicação de serviços e itens, como serviços de hospedagem, mapas da web, e itens de dados
- Eventos de gerenciamento do conteúdo, como compartilhar itens, alterar propriedade do item, e adicionar, atualizar, mover e excluir itens
- Eventos de segurança, como usuários entrando na organização, criar, excluir e desativar usuários, criar e alterar papéis do usuário, atualizar configurações de HTTP e HTTPS, importar e exportar certificados de segurança, e atualizar o armazenamento de identidade do portal
- Eventos de gerenciamento da organização, como adicionar e configurar grupos, adicionar ou remover usuários de um grupo, configurar a galeria, mapas base, serviços do utilitário, e servidores federados, e definir configurações de log e excluir logs
- Eventos em geral, como atualizar o índice de pesquisa do portal e reiniciar o portal
Os seguintes eventos não são registrados em logs:
- Usuários saindo da organização
- Federar e desfederar um site do ArcGIS Server com seu portal
- Solicitações de REST para editar e consultar itens
Embora você possa consultar logs em todos os componentes do ArcGIS Enterprise, o Diretório de Administrador do Portal, todos os filtros de eventos não estão disponíveis para logs do servidor. Para mais opções de filtragem, consulte os logs do servidor no ArcGIS Server Manager.
Instalar e atualizar o comportamento de registro
Ao instalar ou atualizar ArcGIS Enterprise, o nível de log de cada componente é definido como Detalhado. Isto significa que mensagens muito detalhadas são anotadas durante o processo de instalação ou atualização.
Se você encontrar uma falha ao instalar ou atualizar o Portal for ArcGIS e deseja revisar os logs para ajudar a solucionar o problema, determine se você pode acessar o Diretório de Administrador do Portal. 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 de cada componente será definido para Aviso por padrão. Isto significa somente restringir aoa problemas sérios que estão logados. Se um usuário reportar um problema, talvez seja necessário alterar o nível de log para capturar mais mensagens boas deste problema específico. Para saber como modificar o nível de registro, consulte Especificar configurações de log do portal e Especificar configurações de log do servidor.
Entender 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 estas informações podem ajudá-lo a corrigir problemas 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 Detalhado, o qual é um problema detalhado, mensagem informativa gerada por uso regular da organização.
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, 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 da organização, como nomes de operações e solicitações recebidas. Este nível inclui severo, aviso e mensagens de informações. | Account settings updated. |
Detalhado | Mensagens fornecendo mais detalhes sobre como a organização atende às operações e solicitações. Este nível inclui severo, aviso, informações mensagens boas. | Setting log level to VERBOSE before creating new site. |
Depurar | Mensagens detalhadas altamente projetadas para desenvolvedores e técnicos de suporte que desejam obter uma compreensão melhor do estado da organização 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 registrados na organização. | 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.
Tempo
A hora na qual ocorreu o evento logado. Os eventos são organizados cronologicamente, com os eventos recentes exibidos primeiro. O formato de hora é yyyy-mm-ddThh:mm:ss.
Fonte
Os eventos registrados no portal são de uma das seguintes fontes:
- Compartilhamento—Eventos relacionados à publicação e aos usuários.
- Administrador do Portal—Eventos relacionados à segurança e indexação.
- Portal—Eventos relacionados à instalação do software.
A origem dos eventos registrados em um servidor pode ser um serviço ou o servidor. Eventos associados a serviços exibem o nome e o tipo de serviço como propriedade de origem. Os eventos associados ao servidor exibem o nome do componente da estrutura que registrou a mensagem como a propriedade de origem.
Os seguintes são exemplos:
- Um evento relacionado ao serviço de mapa SampleWorldCities aparece como SampleWorldCities.MapServer.
- Após criar com sucesso um agrupamento de servidores no seu site, o Admin é exibido como o componente que registrou a mensagem.
Máquina
A máquina na qual o evento ocorreu.
Usuário
O nome de usuário que enviou a solicitação que resultou 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.
A tabela a seguir contém códigos de log do portal. Para revisar os códigos de log do servidor, consulte Códigos de log.
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 específico da organização 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.
ID da solicitação
A string de ID único anexada a cada solicitação no envio, que é carregada durante todo o ciclo de vida da solicitação no sistema.