@sentry/node
Version:
Sentry Node SDK using OpenTelemetry for performance instrumentation
279 lines (275 loc) • 11.3 kB
JavaScript
Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
const api = require('@opentelemetry/api');
const instrumentation = require('@opentelemetry/instrumentation');
const semanticConventions = require('@opentelemetry/semantic-conventions');
const semconv = require('./semconv.js');
const AttributeNames = require('./AttributeNames.js');
const utils = require('./utils.js');
const core = require('@sentry/core');
const PACKAGE_NAME = "@sentry/instrumentation-mysql";
class MySQLInstrumentation extends instrumentation.InstrumentationBase {
constructor(config = {}) {
super(PACKAGE_NAME, core.SDK_VERSION, config);
this._setSemconvStabilityFromEnv();
}
// Used for testing.
_setSemconvStabilityFromEnv() {
this._netSemconvStability = instrumentation.semconvStabilityFromStr("http", process.env.OTEL_SEMCONV_STABILITY_OPT_IN);
this._dbSemconvStability = instrumentation.semconvStabilityFromStr("database", process.env.OTEL_SEMCONV_STABILITY_OPT_IN);
}
_updateMetricInstruments() {
this._connectionsUsageOld = this.meter.createUpDownCounter(semconv.METRIC_DB_CLIENT_CONNECTIONS_USAGE, {
description: "The number of connections that are currently in state described by the state attribute.",
unit: "{connection}"
});
}
/**
* Convenience function for updating the `db.client.connections.usage` metric.
* The name "count" comes from the eventually replacement for this metric per
* https://opentelemetry.io/docs/specs/semconv/non-normative/db-migration/#database-client-connection-count
*/
_connCountAdd(n, poolNameOld, state) {
this._connectionsUsageOld?.add(n, { state, name: poolNameOld });
}
init() {
return [
new instrumentation.InstrumentationNodeModuleDefinition(
"mysql",
[">=2.0.0 <3"],
(moduleExports) => {
if (instrumentation.isWrapped(moduleExports.createConnection)) {
this._unwrap(moduleExports, "createConnection");
}
this._wrap(moduleExports, "createConnection", this._patchCreateConnection());
if (instrumentation.isWrapped(moduleExports.createPool)) {
this._unwrap(moduleExports, "createPool");
}
this._wrap(moduleExports, "createPool", this._patchCreatePool());
if (instrumentation.isWrapped(moduleExports.createPoolCluster)) {
this._unwrap(moduleExports, "createPoolCluster");
}
this._wrap(moduleExports, "createPoolCluster", this._patchCreatePoolCluster());
return moduleExports;
},
(moduleExports) => {
if (moduleExports === void 0) return;
this._unwrap(moduleExports, "createConnection");
this._unwrap(moduleExports, "createPool");
this._unwrap(moduleExports, "createPoolCluster");
}
)
];
}
// global export function
_patchCreateConnection() {
return (originalCreateConnection) => {
const thisPlugin = this;
return function createConnection(_connectionUri) {
const originalResult = originalCreateConnection(...arguments);
thisPlugin._wrap(originalResult, "query", thisPlugin._patchQuery(originalResult));
return originalResult;
};
};
}
// global export function
_patchCreatePool() {
return (originalCreatePool) => {
const thisPlugin = this;
return function createPool(_config) {
const pool = originalCreatePool(...arguments);
thisPlugin._wrap(pool, "query", thisPlugin._patchQuery(pool));
thisPlugin._wrap(pool, "getConnection", thisPlugin._patchGetConnection(pool));
thisPlugin._wrap(pool, "end", thisPlugin._patchPoolEnd(pool));
thisPlugin._setPoolCallbacks(pool, "");
return pool;
};
};
}
_patchPoolEnd(pool) {
return (originalPoolEnd) => {
const thisPlugin = this;
return function end(callback) {
const nAll = pool._allConnections.length;
const nFree = pool._freeConnections.length;
const nUsed = nAll - nFree;
const poolNameOld = utils.getPoolNameOld(pool);
thisPlugin._connCountAdd(-nUsed, poolNameOld, "used");
thisPlugin._connCountAdd(-nFree, poolNameOld, "idle");
originalPoolEnd.apply(pool, arguments);
};
};
}
// global export function
_patchCreatePoolCluster() {
return (originalCreatePoolCluster) => {
const thisPlugin = this;
return function createPool(_config) {
const cluster = originalCreatePoolCluster(...arguments);
thisPlugin._wrap(cluster, "getConnection", thisPlugin._patchGetConnection(cluster));
thisPlugin._wrap(cluster, "add", thisPlugin._patchAdd(cluster));
return cluster;
};
};
}
_patchAdd(cluster) {
return (originalAdd) => {
const thisPlugin = this;
return function add(id, config) {
if (!thisPlugin["_enabled"]) {
thisPlugin._unwrap(cluster, "add");
return originalAdd.apply(cluster, arguments);
}
originalAdd.apply(cluster, arguments);
const nodes = cluster["_nodes"];
if (nodes) {
const nodeId = typeof id === "object" ? "CLUSTER::" + cluster._lastId : String(id);
const pool = nodes[nodeId].pool;
thisPlugin._setPoolCallbacks(pool, id);
}
};
};
}
// method on cluster or pool
_patchGetConnection(pool) {
return (originalGetConnection) => {
const thisPlugin = this;
return function getConnection(arg1, arg2, arg3) {
if (!thisPlugin["_enabled"]) {
thisPlugin._unwrap(pool, "getConnection");
return originalGetConnection.apply(pool, arguments);
}
if (arguments.length === 1 && typeof arg1 === "function") {
const patchFn = thisPlugin._getConnectionCallbackPatchFn(arg1);
return originalGetConnection.call(pool, patchFn);
}
if (arguments.length === 2 && typeof arg2 === "function") {
const patchFn = thisPlugin._getConnectionCallbackPatchFn(arg2);
return originalGetConnection.call(pool, arg1, patchFn);
}
if (arguments.length === 3 && typeof arg3 === "function") {
const patchFn = thisPlugin._getConnectionCallbackPatchFn(arg3);
return originalGetConnection.call(pool, arg1, arg2, patchFn);
}
return originalGetConnection.apply(pool, arguments);
};
};
}
_getConnectionCallbackPatchFn(cb) {
const thisPlugin = this;
const activeContext = api.context.active();
return function(err, connection) {
if (connection) {
if (!instrumentation.isWrapped(connection.query)) {
thisPlugin._wrap(connection, "query", thisPlugin._patchQuery(connection));
}
}
if (typeof cb === "function") {
api.context.with(activeContext, cb, this, err, connection);
}
};
}
_patchQuery(connection) {
return (originalQuery) => {
const thisPlugin = this;
return function query(query, _valuesOrCallback, _callback) {
if (!thisPlugin["_enabled"]) {
thisPlugin._unwrap(connection, "query");
return originalQuery.apply(connection, arguments);
}
const attributes = {};
const { host, port, database, user } = utils.getConfig(connection.config);
const portNumber = parseInt(port, 10);
const dbQueryText = utils.getDbQueryText(query);
if (thisPlugin._dbSemconvStability & instrumentation.SemconvStability.OLD) {
attributes[semconv.ATTR_DB_SYSTEM] = semconv.DB_SYSTEM_VALUE_MYSQL;
attributes[semconv.ATTR_DB_CONNECTION_STRING] = utils.getJDBCString(host, port, database);
attributes[semconv.ATTR_DB_NAME] = database;
attributes[semconv.ATTR_DB_USER] = user;
attributes[semconv.ATTR_DB_STATEMENT] = dbQueryText;
}
if (thisPlugin._dbSemconvStability & instrumentation.SemconvStability.STABLE) {
attributes[semanticConventions.ATTR_DB_SYSTEM_NAME] = semanticConventions.DB_SYSTEM_NAME_VALUE_MYSQL;
attributes[semanticConventions.ATTR_DB_NAMESPACE] = database;
attributes[semanticConventions.ATTR_DB_QUERY_TEXT] = dbQueryText;
}
if (thisPlugin._netSemconvStability & instrumentation.SemconvStability.OLD) {
attributes[semconv.ATTR_NET_PEER_NAME] = host;
if (!isNaN(portNumber)) {
attributes[semconv.ATTR_NET_PEER_PORT] = portNumber;
}
}
if (thisPlugin._netSemconvStability & instrumentation.SemconvStability.STABLE) {
attributes[semanticConventions.ATTR_SERVER_ADDRESS] = host;
if (!isNaN(portNumber)) {
attributes[semanticConventions.ATTR_SERVER_PORT] = portNumber;
}
}
const span = thisPlugin.tracer.startSpan(utils.getSpanName(query), {
kind: api.SpanKind.CLIENT,
attributes
});
if (thisPlugin.getConfig().enhancedDatabaseReporting) {
let values;
if (Array.isArray(_valuesOrCallback)) {
values = _valuesOrCallback;
} else if (arguments[2]) {
values = [_valuesOrCallback];
}
span.setAttribute(AttributeNames.AttributeNames.MYSQL_VALUES, utils.getDbValues(query, values));
}
const cbIndex = Array.from(arguments).findIndex((arg) => typeof arg === "function");
const parentContext = api.context.active();
if (cbIndex === -1) {
const streamableQuery = api.context.with(api.trace.setSpan(api.context.active(), span), () => {
return originalQuery.apply(connection, arguments);
});
api.context.bind(parentContext, streamableQuery);
return streamableQuery.on(
"error",
(err) => span.setStatus({
code: api.SpanStatusCode.ERROR,
message: err.message
})
).on("end", () => {
span.end();
});
} else {
thisPlugin._wrap(arguments, cbIndex, thisPlugin._patchCallbackQuery(span, parentContext));
return api.context.with(api.trace.setSpan(api.context.active(), span), () => {
return originalQuery.apply(connection, arguments);
});
}
};
};
}
_patchCallbackQuery(span, parentContext) {
return (originalCallback) => {
return function(err, results, fields) {
if (err) {
span.setStatus({
code: api.SpanStatusCode.ERROR,
message: err.message
});
}
span.end();
return api.context.with(parentContext, () => originalCallback(...arguments));
};
};
}
_setPoolCallbacks(pool, id) {
const poolNameOld = id || utils.getPoolNameOld(pool);
pool.on("connection", (_connection) => {
this._connCountAdd(1, poolNameOld, "idle");
});
pool.on("acquire", (_connection) => {
this._connCountAdd(-1, poolNameOld, "idle");
this._connCountAdd(1, poolNameOld, "used");
});
pool.on("release", (_connection) => {
this._connCountAdd(1, poolNameOld, "idle");
this._connCountAdd(-1, poolNameOld, "used");
});
}
}
exports.MySQLInstrumentation = MySQLInstrumentation;
//# sourceMappingURL=instrumentation.js.map