admin

admin

Drop-in Node.js Admin termin Tondpoint para ajudá-lo a analisar os problemas de produção.

Demoção ao vivo | Uso | FAQ | Plugins | Exemplo de projeto | Changelog

---

A execução de aplicativos na produção pode ser um desafio. Os aplicativos podem travar, encontrar bugs ou ficar lento. Existem várias maneiras de abordar tais questões. O Admin é uma ferramenta para ajudar a solucionar problemas de aplicativos. Ele foi projetado para fornecer informações detalhadas de depuração sobre a execução de aplicativos Node.js.

O Admin fornece terminais de depuração por meio de um servidor HTTP. A funcionalidade fornecida por este servidor é extensível, pois o Admin é um sistema de plug -in.

Em vez de descrever isso longamente, confira o sistema de demonstração ao vivo no Heroku!

Conteúdo

• Instalação
• Uso
• Perguntas frequentes
  • Como faço para inspecionar a interface do usuário do administrador quando ela se liga apenas ao host local?

Instalação

Para usar o Admin, o pacote admin Node.js e pelo menos um plug -in precisa ser instalado. O exemplo a seguir mostra uma configuração típica.

 npm install --save admin 
  admin-plugin-config 
  admin-plugin-healthcheck 
  admin-plugin-environment 
  admin-plugin-index 
  admin-plugin-profile 
  admin-plugin-report 
  admin-plugin-terminate

Uso

Para usar o Admin, ele precisa ser configurado e iniciado com seu aplicativo. A listagem de códigos Flying mostra como isso pode ser feito.

 const admin = require ( 'admin' ) ;

admin . configure ( {
  http : { // optional
    bindAddress : '127.0.0.1' , // default
    port : 2999 // default
  } ,

  plugins : [
    require ( 'admin-plugin-index' ) ( ) ,
    require ( 'admin-plugin-report' ) ( ) ,
    require ( 'admin-plugin-environment' ) ( ) ,
    require ( 'admin-plugin-profile' ) ( ) ,
    require ( 'admin-plugin-terminate' ) ( ) ,
    require ( 'admin-plugin-config' ) ( {
      config : {
        // An application config goes here. This config object will be
        // visible in the admin UI and via the admin REST endpoints.
        secret : '42' ,
        port : 8080
      }
    } ) ,
    require ( 'admin-plugin-healthcheck' ) ( {
      checks : {
        // Define multiple healthchecks which check critical components
        // in the system. The following example shows valid return values.
        random ( ) {
          const v = Math . random ( ) ;
          if ( v > 0.8 ) {
            throw new Error ( 'Random value >0.8' ) ;
          } else if ( v > 0.3 ) {
            return "Healthy like an application that isn't used." ;
          } else {
            return Promise . reject ( 'Something bad happened here…' ) ;
          }
        }
      }
    } )
  ]
} ) ;

admin . start ( ) ; 

Perguntas frequentes

Como faço para inspecionar a interface do usuário do administrador quando ela se liga apenas ao host local?

A solução mais fácil é configurar um túnel SSH para a máquina:

 SSH_KEY="~/.ssh/<my_key>"
REMOTE_USER="<user>"
REMOTE_HOST="<host>"
ADMIN_PORT="<port>"

ssh -i "$SSH_KEY" -Nf -L "$ADMIN_PORT:localhost:$ADMIN_PORT" "$REMOTE_USER@$REMOTE_HOST"
curl "localhost:$ADMIN_PORT"