Cette page a été traduite par l'API Cloud Translation.
Switch to English

Configurer Cloud Logging pour Node.js

Les plug-ins des applications Node.js sont gérés pour les bibliothèques de journalisation Bunyan et Winston populaires.

Winston est une bibliothèque à usage général qui met en œuvre une variété de formateurs et de transports de journaux.

Bunyan est une bibliothèque spécialisée dans les journaux JSON structurés. La mise en forme des journaux peut être effectuée en redirigeant l'utilisateur vers la ligne de commande Bunyan.

Vous pouvez également utiliser directement la bibliothèque cliente Logging pour Node.js, ou créer vos propres intégrations avec la bibliothèque de journalisation de votre choix.

Vous n'avez pas besoin d'installer l'agent Logging pour utiliser les bibliothèques Bunyan et Winston sur une instance de VM Compute Engine.

Avant de commencer

  1. Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.
  2. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

    Accéder au sélecteur de projet

  3. Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier que la facturation est activée pour votre projet.

  4. Activez Cloud Logging API.

    Activer l'API

  5. Préparez votre environnement au développement de Node.js.

    Accéder au guide de configuration de Node.js

Utiliser Bunyan

Cloud Logging fournit un plug-in pour la bibliothèque de journalisation Node.js Bunyan. Ce plug-in propose une couche simple de niveau supérieur permettant de travailler avec Logging.

Installer le plug-in

  1. Le moyen le plus simple d'installer le plug-in Bunyan de Logging est d'utiliser npm :

    npm install --save bunyan @google-cloud/logging-bunyan
  2. Importez le plug-in et ajoutez-le à votre configuration Bunyan :

    const bunyan = require('bunyan');
    
    // Imports the Google Cloud client library for Bunyan
    const {LoggingBunyan} = require('@google-cloud/logging-bunyan');
    
    // Creates a Bunyan Cloud Logging client
    const loggingBunyan = new LoggingBunyan();
    
    // Create a Bunyan logger that streams to Cloud Logging
    // Logs will be written to: "projects/YOUR_PROJECT_ID/logs/bunyan_log"
    const logger = bunyan.createLogger({
      // The JSON payload of the log as it appears in Cloud Logging
      // will contain "name": "my-service"
      name: 'my-service',
      streams: [
        // Log to the console at 'info' and above
        {stream: process.stdout, level: 'info'},
        // And log to Cloud Logging, logging at 'info' and above
        loggingBunyan.stream('info'),
      ],
    });
    
    // Writes some log entries
    logger.error('warp nacelles offline');
    logger.info('shields at 99%');

Configurer le plug-in

Vous pouvez personnaliser le comportement du plug-in Bunyan à l'aide des options de configuration compatibles avec la bibliothèque cliente Cloud de l'API Cloud Logging pour Node.js. Ces options peuvent être transmises dans l'objet options, qui est lui-même transmis au constructeur du plug-in.

Utiliser Bunyan et Express

Vous pouvez configurer et utiliser Bunyan avec Logging dans une application Node.js Express.

// Imports the Google Cloud client library for Bunyan.
const lb = require('@google-cloud/logging-bunyan');

// Import express module and create an http server.
const express = require('express');

async function startServer() {
  const {logger, mw} = await lb.express.middleware({
    logName: 'samples_express',
  });
  const app = express();

  // Install the logging middleware. This ensures that a Bunyan-style `log`
  // function is available on the `request` object. This should be the very
  // first middleware you attach to your app.
  app.use(mw);

  // Setup an http route and a route handler.
  app.get('/', (req, res) => {
    // `req.log` can be used as a bunyan style log method. All logs generated
    // using `req.log` use the current request context. That is, all logs
    // corresponding to a specific request will be bundled in the Stackdriver
    // UI.
    req.log.info('this is an info log message');
    res.send('hello world');
  });

  const port = process.env.PORT || 8080;

  // `logger` can be used as a global logger, one not correlated to any specific
  // request.
  logger.info({port}, 'bonjour');

  // Start listening on the http server.
  const server = app.listen(port, () => {
    console.log(`http server listening on port ${port}`);
  });

  app.get('/shutdown', (req, res) => {
    res.sendStatus(200);
    server.close();
  });
}

startServer();

Utiliser Winston

Cloud Logging fournit un plug-in pour la bibliothèque de journalisation Node.js Winston. Ce plug-in propose une couche simple de niveau supérieur permettant de travailler avec Logging.

Installer le plug-in

  1. Le moyen le plus simple d'installer le plug-in Winston de Logging est d'utiliser npm :

    npm install --save @google-cloud/logging-winston winston
  2. Importez le plug-in et ajoutez-le à votre configuration Winston :

    const winston = require('winston');
    
    // Imports the Google Cloud client library for Winston
    const {LoggingWinston} = require('@google-cloud/logging-winston');
    
    const loggingWinston = new LoggingWinston();
    
    // Create a Winston logger that streams to Stackdriver Logging
    // Logs will be written to: "projects/YOUR_PROJECT_ID/logs/winston_log"
    const logger = winston.createLogger({
      level: 'info',
      transports: [
        new winston.transports.Console(),
        // Add Stackdriver Logging
        loggingWinston,
      ],
    });
    
    // Writes some log entries
    logger.error('warp nacelles offline');
    logger.info('shields at 99%');

Configurer le plug-in

Vous pouvez personnaliser le comportement du plug-in Winston à l'aide des options de configuration compatibles avec la bibliothèque cliente Cloud de l'API Cloud Logging pour Node.js. Ces options peuvent être transmises dans l'objet options, qui est lui-même transmis au constructeur du plug-in.

Pour plus d'informations sur l'installation, consultez la documentation sur les bibliothèques Cloud Logging pour Node.js. Vous pouvez également signaler d'éventuels problèmes à l'aide de l'outil de suivi des problèmes.

Utiliser directement la bibliothèque cliente cloud

Pour savoir comment utiliser directement la bibliothèque cliente Cloud Logging pour Node.js, consultez la page Bibliothèques clientes Cloud Logging.

Exécuter des applications sur Google Cloud

Le rôle Rédacteur de journaux d'IAM sur Google Cloud est nécessaire pour utiliser la bibliothèque Cloud Logging pour Node.js. La plupart des environnements Google Cloud fournissent ce rôle par défaut.

App Engine

Par défaut, App Engine attribue le rôle Rédacteur de journaux.

Il est possible d'utiliser les bibliothèques Cloud Logging pour Node.js sans avoir à fournir explicitement des identifiants.

Cloud Logging est automatiquement activé pour les applications App Engine. Aucune configuration supplémentaire n'est requise.

Google Kubernetes Engine

Sur Google Kubernetes Engine, vous devez ajouter le niveau d'accès logging.write lors de la création du cluster :

gcloud container clusters create example-cluster-name --scopes https://www.googleapis.com/auth/logging.write

Compute Engine

Lorsque vous utilisez des instances de VM Compute Engine, ajoutez le niveau d'accès cloud-platform à chaque instance. Lorsque vous créez une instance via Google Cloud Console, vous pouvez le faire dans la section Identité et accès à l'API du panneau Créer une instance. Utilisez le compte de service par défaut de Compute Engine ou un autre compte de service de votre choix, puis sélectionnez Autoriser l'accès complet à l'ensemble des API Cloud dans la section Identité et accès à l'API. Quel que soit le compte de service sélectionné, vérifiez qu'il dispose du rôle Rédacteur de journaux dans la section IAM et administration de Cloud Console.

Cloud Functions

Par défaut, Cloud Functions attribue le rôle Rédacteur de journaux.

Il est possible d'utiliser les bibliothèques Cloud Logging pour Node.js sans avoir à fournir explicitement des identifiants.

Cloud Functions est configuré pour utiliser Cloud Logging automatiquement.

Exécuter en local et depuis un autre emplacement

Pour utiliser les bibliothèques Cloud Logging pour Node.js en dehors de Google Cloud, y compris en les exécutant sur votre propre poste de travail, sur les ordinateurs de votre centre de données ou sur les instances de VM d'un autre fournisseur cloud, vous devez fournir l'ID de projet Google Cloud ainsi que les identifiants de compte de service appropriés directement dans les bibliothèques Cloud Logging pour Node.js.

Vous pouvez créer et obtenir manuellement des identifiants pour le compte de service. Lorsque vous spécifiez le champ Rôle, utilisez le rôle Rédacteur de journaux. Pour en savoir plus sur les rôles Cloud IAM (Cloud Identity and Access Management), consultez le Guide du contrôle des accès.

Avec Bunyan :

// Imports the Google Cloud client library for Bunyan
const {LoggingBunyan} = require('@google-cloud/logging-bunyan');

// Creates a client
const loggingBunyan = new LoggingBunyan({
  projectId: 'your-project-id',
  keyFilename: '/path/to/key.json',
});

Avec Winston :

// Imports the Google Cloud client library for Winston
const {LoggingWinston} = require('@google-cloud/logging-winston');

// Creates a client
const loggingWinston = new LoggingWinston({
  projectId: 'your-project-id',
  keyFilename: '/path/to/key.json',
});

Afficher les journaux

Après le déploiement, vous pouvez afficher les journaux dans l'explorateur de journaux.

Accéder à l'explorateur de journaux

Dans l'explorateur de journaux, vous devez spécifier une ou plusieurs ressources, mais leur sélection peut ne pas être évidente. Voici quelques conseils pour vous aider à faire vos premiers pas :

  • Si vous déployez votre application sur App Engine ou utilisez les bibliothèques propres à App Engine, définissez votre ressource sur Application GAE.

  • Si vous déployez votre application sur Compute Engine, définissez la ressource sur Instance de VM GCE.

  • Si vous déployez votre application sur Google Kubernetes Engine, la configuration de la journalisation de votre cluster détermine le type de ressource des entrées de journal. Pour en savoir plus sur l'ancienne suite d'opérations Google Cloud et sur les solutions Kubernetes Monitoring de la suite d'opérations Google Cloud, ainsi que sur l'incidence de ces options sur le type de ressource, consultez la page Migrer vers les solutions Kubernetes Monitoring de la suite d'opérations Google Cloud.

  • Si votre application utilise directement l'API Cloud Logging, la ressource dépend de l'API et de votre configuration. Par exemple, dans votre application, vous pouvez spécifier une ressource ou utiliser une ressource par défaut.

  • Si aucun journal ne s'affiche dans l'explorateur de journaux, passez en mode de requête avancée et utilisez une requête vide pour voir toutes les entrées de journal.

    1. Pour passer en mode de requête avancée, cliquez sur le menu (▾) en haut de l'explorateur de journaux, puis sélectionnez Convertir en filtre avancé.
    2. Effacez le contenu qui apparaît dans le champ de filtre.
    3. Cliquez sur Envoyer le filtre.

    Vous pouvez examiner les entrées individuelles pour identifier vos ressources.

Pour obtenir plus d'informations, consultez les sections Afficher les journaux et Requêtes de journaux avancées.