Logging en monitoring in Apps Script

Logging-opties in Apps Script

Apps Script heeft drie logging-mechanismes, elk voor een ander doel:

• Logger.log(): zichtbaar in de Apps Script-editor onder Uitvoeringslogboek. Handig tijdens ontwikkeling.
• console.log(): stuurt naar Google Cloud Logging (vroeger Stackdriver genoemd). Blijft langer bewaard en is doorzoekbaar.
• Aangepaste sheet-log: schrijft naar een spreadsheet voor business-audit-trails.

function logVoorbeelden() {
  Logger.log('Eenvoudige string');
  Logger.log('Object: %s', JSON.stringify({sleutel: 'waarde'}));

  console.log('Naar Cloud Logging');
  console.info('Info niveau');
  console.warn('Waarschuwing niveau');
  console.error('Fout niveau');
}

Gestructureerde logging

Door je logregels als JSON weg te schrijven, kun je ze in Cloud Logging filteren op velden zoals niveau, gebruiker en context.

const LogNiveau = {
  DEBUG: 'DEBUG',
  INFO: 'INFO',
  WARN: 'WARN',
  ERROR: 'ERROR',
};

function log(niveau, bericht, context = {}) {
  const entry = {
    tijdstip: new Date().toISOString(),
    niveau,
    bericht,
    gebruiker: Session.getActiveUser().getEmail(),
    script: 'mijn-script-naam',
    ...context,
  };

  const logString = JSON.stringify(entry);

  if (niveau === LogNiveau.ERROR) {
    console.error(logString);
  } else if (niveau === LogNiveau.WARN) {
    console.warn(logString);
  } else {
    console.log(logString);
  }

  return entry;
}

Audit-log naar Sheets

Voor business-gebeurtenissen die niet-technisch leesbaar moeten blijven, is een audit-tabblad in een spreadsheet vaak handiger dan een technisch log.

function schrijfAuditLog(actie, details, status = 'SUCCESS') {
  const blad = SpreadsheetApp.openById('AUDIT_SHEET_ID')
    .getSheetByName('Auditlog');

  const lock = LockService.getScriptLock();
  try {
    lock.waitLock(5000);
    blad.appendRow([
      new Date(),
      Session.getActiveUser().getEmail(),
      actie,
      details,
      status,
    ]);
  } finally {
    lock.releaseLock();
  }
}

function verwerkBestelling(bestellingId) {
  schrijfAuditLog('BESTELLING_GESTART', `Bestelling ${bestellingId}`);

  try {
    Logger.log(`Verwerking bestelling ${bestellingId}`);
    schrijfAuditLog('BESTELLING_VERWERKT', `Bestelling ${bestellingId} klaar`);
  } catch(e) {
    schrijfAuditLog('BESTELLING_FOUT', e.message, 'ERROR');
    throw e;
  }
}

Uitvoeringslogboek bekijken

Het uitvoeringslogboek is toegankelijk via de Apps Script-editor en het menu-item Uitvoeringslogboek. Hier zie je de laatste uitvoeringen met datum, duur, triggers en eventuele fouten. Dit logboek blijft maar kort bewaard, dus voor langere bewaring leun je op Cloud Logging.

function logMetTijdsmeting() {
  const startTijd = Date.now();

  Utilities.sleep(500);
  const tussentijd = Date.now() - startTijd;

  Logger.log(`Stap 1 klaar na ${tussentijd}ms`);

  Utilities.sleep(300);
  const totaal = Date.now() - startTijd;
  Logger.log(`Totale uitvoertijd: ${totaal}ms`);
}

Foutmeldingen naar e-mail sturen

Een wrapper die fouten opvangt, logt en doorstuurt zorgt dat je niet afhankelijk bent van iemand die toevallig in de logs kijkt.

function withErrorNotification(fn, functieNaam) {
  try {
    return fn();
  } catch(e) {
    const foutmelding = `
Fout in script: ${functieNaam}
Tijdstip: ${new Date().toLocaleString('nl-NL')}
Foutbericht: ${e.message}
Stack: ${e.stack || 'Niet beschikbaar'}
    `.trim();

    GmailApp.sendEmail(
      'beheer@bedrijf.nl',
      `Apps Script fout: ${functieNaam}`,
      foutmelding
    );

    console.error(JSON.stringify({
      type: 'SCRIPT_FOUT',
      functie: functieNaam,
      fout: e.message,
      stack: e.stack,
    }));

    throw e;
  }
}

function mijnTriggerFunctie() {
  withErrorNotification(() => {
    Logger.log('Script gestart');
  }, 'mijnTriggerFunctie');
}

Cloud Logging gebruiken

Met een gestructureerde JSON-regel inclusief severity en labels kun je in Cloud Logging gericht filteren en grafieken maken.

function schrijfNaarCloudLogging() {
  console.log(JSON.stringify({
    severity: 'INFO',
    message: 'Dagelijkse verwerking gestart',
    aantalRijen: 150,
    duurMs: 2340,
    labels: {
      omgeving: 'productie',
      versie: '2.1.0',
    },
  }));
}

Bekijk de logs via de Google Cloud-console onder Logging en de Log Verkenner. Filter op resource.type="app_script_function" om alleen logregels van Apps Script-functies te zien. Wil je dit gebruiken, koppel dan je Apps Script-project aan een Google Cloud-project (een standaardproject of een eigen project).

Goede logging is essentieel voor productie-scripts. Met een combinatie van Cloud Logging voor technische logs en een audit-sheet voor business-gebeurtenissen heb je volledige zichtbaarheid in je automatiseringsworkflows.