Ferramenta Sosreport

Esta é a documentação do Apigee Edge.
Acesse Documentação da Apigee X. informações

O Sosreport é uma ferramenta de diagnóstico e coleta de dados em nível de sistema baseada SoS de software. Você pode usar a ferramenta Sosreport para coletar informações e depurar problemas em nós onde uma instância está em execução. A ferramenta coleta e armazena informações localmente no sistema de arquivos do nó.

A ferramenta Sosreport coleta detalhes de configuração, informações do sistema e Informações de diagnóstico do seu sistema e armazena os dados em um arquivo. Para componentes da Apigee, o Sosreport coleta o seguinte:

  • A versão do kernel em execução
  • Módulos carregados
  • Arquivos de configuração do sistema e do serviço

O Sosreport também executa programas externos para coletar informações, incluindo:

  • Registros da Apigee de todos os componentes.
  • Diagnóstico do ambiente de execução
  • Diagnósticos do Cassandra coletados usando comandos do nodetool.

A ferramenta Sosreport contém dois comandos principais:

  • sosreport: o comando principal para coletar dados e criar relatórios.
  • apigee-sosreport: uma ferramenta auxiliar usada na instalação. sosreport e gerencie plug-ins sosreport específicos para componentes da Apigee.

Instalação

Esta seção explica como instalar o sosreport.

Se a versão SoS de sosreport já estiver instalada

Se o arquivo original Versão SoS de sosreport já está instalado no seu sistema, não configure a versão da Apigee, porque os caminhos de instalação podem entrar em conflito. Em vez disso, copie os plug-ins específicos da Apigee do diretório. /opt/apigee/apigee-sosreport/source/plugin para o Python apropriado. site-packages usando um comando como os mostrados abaixo. Por exemplo, para copiar agigee-mgmt.py:

  • Se estiver usando o Python 2, digite: 
    sudo cp apigee-mgmt.py /usr/lib/python2.7/site-packages/sos/plugins/
  • Se estiver usando o Python 3, digite: 
    sudo cp apigee-mgmt.py /usr/local/lib/python3.6/site-packages/sos/plugins/

Para verificar se os plug-ins foram instalados, digite

sudo sosreport --list-plugins

Se tiver dúvidas, entre em contato com o suporte da Apigee.

Instalando a versão de sosreport da Apigee

Se a versão de SoS de sosreport não estiver já instalada no seu sistema, é possível instalar a versão da Apigee inserindo os seguintes comandos em todos os nós em que o Edge for Private Cloud está instalado: 

/opt/apigee/apigee-service/bin/apigee-service apigee-sosreport install
/opt/apigee/apigee-service/bin/apigee-service apigee-sosreport setup

Para testar se o sosreport está instalado, confirme se os plug-ins relacionados à A Apigee está localizada no seguinte diretório:

/usr/lib/pythonx.x/site-packages/sos/plugins

em que pythonx.x é a versão instalada do Python.

Como alternativa, é possível executar um dos seguintes comandos:

  • Para verificar apenas plug-ins específicos da Apigee: 
    apigee-service apigee-sosreport diagnose -l

    Isso retorna a lista de plug-ins específicos da Apigee a seguir.

    sosreport (version 3.9)

The following plugins are currently enabled:

apigee-mgmt          This is the apigee plugin for edge-management-server
apigee-mp            This is the apigee plugin for edge-message-processor
apigee-rrt           This is the apigee plugin for edge-router
apigee-sample        Main diagnostics gatehring class
  • Para verificar todos os plug-ins: 
    apigee-service apigee-sosreport diagnose -s -l

    Isso vai retornar a seguinte lista de plug-ins disponíveis com o sosreport:

    sosreport (version 3.9)

The following plugins are currently enabled:

 acpid                ACPI daemon information
 alternatives         System alternatives
 anacron              Anacron job scheduling service
 apigee-cassandra     This is the base class for sosreport plugins. Plugins should subclass
    this and set the class variables where applicable. ←truncated→
 apigee-mgmt          This is the base class for sosreport plugins. Plugins should subclass
    this and set the class variables where applicable. ←truncated→
 apigee-mp            Main diagnostics gathering class
 apigee-rrt           This is the base class for sosreport plugins. Plugins should subclass
    this and set the class variables where applicable. ←truncated→

………………………………………………….
………………………………………………….
………………………………………………….
←truncated→

Como criar um relatório

Para criar um relatório usando a ferramenta Sosreport, execute o comando sosreport com a opção de plug-in necessária. Consulte Plug-ins da Apigee. A o diretório padrão em que o relatório é armazenado é tmp ou /var/tmp. É possível alterar o diretório em que o relatório é armazenado passando um diretório diferente à opção tmp-dir. Por exemplo, para criar um relatório no servidor de gerenciamento e salvá-lo em um diretório chamado my_report-dir, insira uma das seguintes opções:

  • Usando a versão de sosreport da Apigee: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf -o apigee-mgmt  --batch --tmp-dir=my_report-dir
  • Usando a versão SoS do sosreport: 
    sudo sosreport -o apigee-mgmt  --batch --tmp-dir=my_report-dir

O relatório é armazenado em um arquivo .tar.xz no diretório especificado por meio do método tmp-dir. O local do arquivo .tar.xz é mostrado em STDOUT, assim como a soma de verificação. Exemplo:

Your sosreport has been generated and saved in:
 /var/sosreport-prc-test-0-9613-2021-07-12-orwxufx.tar.xz
The checksum is: 5a8b97c6020346a688254c8b04ef86ec
For more available options for sosreport, read the man file:
sudo man sosreport

O relatório é armazenado em um arquivo .tar.xz no diretório especificado por meio do método tmp-dir. O local do .tar.xz file aparece em STDOUT, assim como checksum. Exemplo:

Para ver mais opções disponíveis para sosreport, leia o arquivo man:

sudo man sosreport

Plug-ins da Apigee

As seções a seguir descrevem os plug-ins da Apigee para a ferramenta Sosreport para os seguintes componentes:

Servidor de gerenciamento

O plug-in apigee-mgmt coleta as seguintes informações do Servidor de gerenciamento:

  • nome do host do servidor (padrão)
  • cpuinfo (padrão)
  • meminfo (padrão)
  • configurações de máquina virtual Java (JVM), como memória, Djdk.tls.allowUnsafeServerCertChange e assim por diante (padrão)
  • Registros do gerenciamento atual (padrão)
  • Dez saídas sequenciais superiores e do jstacks (padrão)
  • Toda a pasta de registros de gerenciamento (opcional)
  • config-files (opcional)

Exemplos:

Para coletar todos os itens padrão, digite uma das seguintes opções:

  • Usando a versão de sosreport da Apigee: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mgmt --batch my_report-dir
  • Usando a versão SoS de sosreport: 
    sudo sosreport -o apigee-mgmt --batch my_report-dir

Para coletar todos os itens padrão e também os itens opcionais especificados no comando, por exemplo, arquivos de configuração e todos os registros, digite uma das seguintes opções:

  • Usando a versão de sosreport da Apigee: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mgmt --batch -k apigee-mgmt.config-files -k apigee-mgmt.all-logs
  • Usando a versão SoS de sosreport: 
    sudo sosreport -o apigee-mgmt --batch -k apigee-mgmt.config-files -k apigee-mgmt.all-logs

Para coletar tudo, digite uma das seguintes opções:

  • Usando a versão de sosreport da Apigee: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mgmt --batch -k apigee-mgmt.config-files -k apigee-mgmt.all-logs

    Como alternativa, você pode inserir:

    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mgmt --batch -a
  • Usando a versão SoS de sosreport: 
    sudo sosreport -o apigee-mgmt --batch -k apigee-mgmt.config-files -k apigee-mgmt.all-logs

    Como alternativa, você pode inserir:

    sudo sosreport -o apigee-mgmt --batch -a

processador de mensagens

O plug-in apigee-mp coleta as seguintes informações do Processador de gerenciamento (MP, na sigla em inglês):

  • Nome do host do servidor (padrão)
  • cpuinfo (padrão)
  • meminfo (padrão)
  • buildinfo/release info (padrão)
  • status apigee-all (padrão)
  • detalhes do servidor (padrão)
  • Configurações no nível da JVM, como memória, Djdk.tls.allowUnsafeServerCertChange, etc. (padrão)
  • Registros do MP atual (padrão)
  • Saída de 10 principais métricas sequenciais jstacks e NIO (padrão)
  • Toda a pasta de registros MP (opcional)
  • Árvore de classificação (opcional)
  • Heap dump (opcional)
  • config-files (opcional)
  • Rastreamento do ambiente de execução (opcional e somente quando org:env:api:rev detail) é fornecido). Observação: o plug-in aguarda 25 segundos para coletar as solicitações de tempo de execução.

Exemplos:

Para coletar todos os itens padrão, digite uma das seguintes opções:

  • Usando a versão de sosreport da Apigee: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mp --batch
  • Usando a versão SoS de sosreport: 
    sudo sosreport -o apigee-mp --batch

Você também pode especificar outros itens opcionais para coletar, além de todos os itens padrão. Por exemplo, para especificar o heap dump, usar a flag -k apigee-mp.heap, digite uma das seguintes opções:

  • Usando a versão de sosreport da Apigee: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mp --batch -k apigee-mp.heap
  • Usando a versão SoS de sosreport: 
    sudo sosreport -o apigee-mp --batch -k apigee-mp.heap

Da mesma forma, é possível especificar os seguintes itens opcionais:

-k apigee-mp.deployments
-k apigee-mp.heap
-k apigee-mp.all-logs
-k apigee-mp.config-files
-k apigee-mp.trace=gsc-cps:test:httpbin:3

É possível especificar várias opções em um único comando. Exemplo:

  • Usando a versão de sosreport da Apigee: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mp --batch -k apigee-mp.deployments -k apigee-mp.all-logs
  • Usando a versão SoS de sosreport: 
    sudo sosreport -o apigee-mp --batch -k apigee-mp.deployments -k apigee-mp.all-logs

Para coletar tudo, exceto o trace, digite uma das seguintes opções:

  • Usando a versão de sosreport da Apigee: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mp --batch -a
  • Usando a versão SoS de sosreport: 
    sudo sosreport -o apigee-mp --batch -a

Roteador

O plug-in apigee-rrt coleta as seguintes informações do Roteador:

  • Nome do host do servidor (padrão)
  • cpuinfo (padrão)
  • meminfo (padrão)
  • buildinfo/release info (padrão)
  • status apigee-all (padrão)
  • detalhes do servidor (padrão)
  • ps. Isso dará às configurações no nível da JVM, por exemplo, memória, Djdk.tls.allowUnsafeServerCertChange e assim por diante (padrão).
  • Registros atuais do roteador (padrão)
  • Lista de nomes de arquivos vhost, incluindo nomes de arquivo incorretos (padrão)
  • Toda a pasta de registros do roteador (opcional)
  • config-files (opcional)

Exemplos:

Para coletar todos os itens padrão, digite uma das seguintes opções:

  • Usando a versão de sosreport da Apigee: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-rrt --batch
  • Usando a versão SoS de sosreport: 
    sudo sosreport -o apigee-rrt --batch

Você também pode especificar outros itens opcionais para coletar, além de todos os itens padrão. Por exemplo, para especificar toda a pasta de registros, usando a flag -k apigee-rrt.all-logs, digite uma das seguintes opções:

  • Usando a versão de sosreport da Apigee: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-rrt --batch -k apigee-rrt.all-logs
  • Usando a versão SoS de sosreport: 
    sudo sosreport -o apigee-rrt --batch -k apigee-rrt.all-logs

Da mesma forma, é possível especificar os seguintes itens opcionais:

-k apigee-rrt.all-logs
-k apigee-rrt.config-files

Para coletar tudo:

  • Usando a versão de sosreport da Apigee: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-rrt --batch -a
  • Usando a versão SoS de sosreport: 
    sudo sosreport -o apigee-rrt --batch -a

Cassandra

O plug-in apigee-cassandra coleta as seguintes informações de Nós do Cassandra:

  • Estatísticas da máquina: 
    "hostname -i"
"cat /proc/cpuinfo"
"cat /proc/meminfo"
"ulimit -a"
"ps auxw"
"df -kh"
"du -sh"
"netstat -ntlpu"
"free -h"
"ifconfig -h"
"ps -ef"
  • Status e versão do componente da Apigee versão apigee-all && status apigee-all
  • registros do apigee-cassandra: Todos os arquivos em /opt/apigee/var/log/apigee-cassandra/
  • Contagem de registros de confirmação
  • Saída do comando Top
  • Despejo de thread
  • Arquivos de configuração: cassandra-topology.properties, cassandra.yaml, cassandra-env.sh
  • Saída do Nodetool para os seguintes parâmetros: version, status, ring, info, gossipinfo, compactionstats -H, tpstats, netstats, cfstats, proxyhistograms

Exemplo:

Para coletar todos os itens padrão, digite uma das seguintes opções:

  • Usando a versão de sosreport da Apigee: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-cassandra
  • Usando a versão SoS de sosreport: 
    sudo sosreport -o apigee-cassandra