(Opcional) Ative o plugin de registro em log do Session Manager - AWS Systems Manager

(Opcional) Ative o plugin de registro em log do Session Manager

O plugin do Session Manager inclui uma opção para permitir o registro em log para sessões que você executar. Por padrão, o registro em log está desativado.

Se você permitir o registro em log, o plugin Session Manager criará arquivos de log para ambas as atividades (session-manager-plugin.log) e erros (errors.log) da aplicação em sua máquina local.

Ative o registro em log do plug-in do Session Manager (Windows)

  1. Localize o arquivo seelog.xml.template para o plugin.

    O local padrão é C:\Program Files\Amazon\SessionManagerPlugin\seelog.xml.template.

  2. Altere o nome do arquivo para seelog.xml.

  3. Abra o arquivo e altere minlevel="off" para minlevel="info" ou minlevel="debug".

    nota

    Por padrão, as entradas de log sobre como abrir um canal de dados e reconectar sessões são registrados no nível INFO. As entradas de fluxo de dados (pacotes e confirmação) são registradas no nível DEBUG.

  4. Altere outras opções de configuração as quais deseja modificar. As opções que você pode alterar incluem:

    • Depurar nível: você pode alterar o nível de depuração de formatid="fmtinfo" para formatid="fmtdebug".

    • Opções de arquivo de log: você pode fazer alterações nas opções de arquivo de log, incluindo onde os logs são armazenados, com exceção dos nomes dos arquivos.

      Importante

      Não altere os nomes de arquivos ou o registro não funcionará corretamente.

      <rollingfile type="size" filename="C:\Program Files\Amazon\SessionManagerPlugin\Logs\session-manager-plugin.log" maxsize="30000000" maxrolls="5"/> <filter levels="error,critical" formatid="fmterror"> <rollingfile type="size" filename="C:\Program Files\Amazon\SessionManagerPlugin\Logs\errors.log" maxsize="10000000" maxrolls="5"/>
  5. Salve o arquivo.

Habilite o registro em log para o plug-in do Session Manager (Linux e macOS)

  1. Localize o arquivo seelog.xml.template para o plugin.

    O local padrão é /usr/local/sessionmanagerplugin/seelog.xml.template.

  2. Altere o nome do arquivo para seelog.xml.

  3. Abra o arquivo e altere minlevel="off" para minlevel="info" ou minlevel="debug".

    nota

    Por padrão, as entradas de log sobre como abrir canais de dados e reconectar sessões são registrados no nível INFO. As entradas de fluxo de dados (pacotes e confirmação) são registradas no nível DEBUG.

  4. Altere outras opções de configuração as quais deseja modificar. As opções que você pode alterar incluem:

    • Depurar nível: você pode alterar o nível de depuração de formatid="fmtinfo" para outputs formatid="fmtdebug"

    • Opções de arquivo de log: você pode fazer alterações nas opções de arquivo de log, incluindo onde os logs são armazenados, com exceção dos nomes dos arquivos.

      Importante

      Não altere os nomes de arquivos ou o registro não funcionará corretamente.

      <rollingfile type="size" filename="/usr/local/sessionmanagerplugin/logs/session-manager-plugin.log" maxsize="30000000" maxrolls="5"/> <filter levels="error,critical" formatid="fmterror"> <rollingfile type="size" filename="/usr/local/sessionmanagerplugin/logs/errors.log" maxsize="10000000" maxrolls="5"/>
      Importante

      Se você usar o diretório padrão para armazenar logs, você deve executar comandos de sessão usando sudo ou atribuir o diretório onde o plugin está instalado permissões totais de leitura e gravação. Para ignorar essas restrições, altere o local onde os logs são armazenados.

  5. Salve o arquivo.