@netlify/build/lib/error/report.js

Netlify build module

import { isNetlifyMaintainedPlugin } from '../plugins/internal.js';
import { closeClient, formatTags, normalizeTagName, startClient, validateStatsDOptions, } from '../report/statsd.js';
import { addBuildErrorToActiveSpan } from '../tracing/main.js';
import { getErrorInfo } from './info.js';
const TOP_PARENT_TAG = 'run_netlify_build';
/**
 * Record error rates of the build phase for monitoring.
 * Sends to statsd daemon.
 */
export const reportError = async function (error, statsdOpts, framework) {
    addBuildErrorToActiveSpan(error);
    if (!validateStatsDOptions(statsdOpts)) {
        return;
    }
    const [errorInfo] = getErrorInfo(error);
    const pluginName = errorInfo.plugin ? normalizeTagName(errorInfo.plugin.packageName) : null;
    // only send tracking if it is a known plugin
    if (pluginName && !isNetlifyMaintainedPlugin(pluginName)) {
        return;
    }
    const parent = pluginName ? pluginName : TOP_PARENT_TAG;
    const stage = pluginName ? errorInfo.location?.event : errorInfo.stage;
    const statsDTags = { stage: stage ?? 'system', parent };
    // Do not add a framework tag if empty string or null/undefined
    if (framework) {
        statsDTags.framework = framework;
    }
    const client = await startClient(statsdOpts);
    client.increment('buildbot.build.stage.error', 1, formatTags(statsDTags));
    await closeClient(client);
};