Rastreo de consultas SQL con el SDK de X-Ray para Node.js

nota

End-of-support aviso: el 25 de febrero de 2027, AWS X-Ray dejará de ofrecer soporte para AWS X-Ray SDKs and daemon. A partir del 25 de febrero de 2027, dejaréis de recibir actualizaciones ni versiones. Para obtener más información sobre el cronograma de soporte, consulteCronología del fin del soporte de X-Ray SDK y daemon. Se recomienda migrar a OpenTelemetry. Para obtener más información sobre la migración a OpenTelemetry, consulte Migración de una instrumentación de rayos X a una instrumentación. OpenTelemetry

Instrumente las consultas de base de datos SQL incluyendo su cliente SQL en el método del cliente de SDK de X-Ray para Node.js correspondiente.

• PostgreSQL – AWSXRay.capturePostgres()

  var AWSXRay = require('aws-xray-sdk');
  var pg = AWSXRay.capturePostgres(require('pg'));
  var client = new pg.Client();

• MySQL – AWSXRay.captureMySQL()

  var AWSXRay = require('aws-xray-sdk');
  var mysql = AWSXRay.captureMySQL(require('mysql'));
  ...
  var connection = mysql.createConnection(config);

Cuando usa un cliente instrumentado para realizar consultas SQL, el SDK de X-Ray para Node.js registra información acerca de la conexión y consultas en un subsegmento.

Inclusión de datos adicionales en subsegmentos SQL

Puede agregar información adicional a los subsegmentos generados para consultas SQL, siempre que se asigne a un campo SQL con permiso. Por ejemplo, para registrar la cadena de consultas SQL saneada en un subsegmento, puede agregarla directamente al objeto SQL del subsegmento.

ejemplo Asignar SQL al subsegmento

    const queryString = 'SELECT * FROM MyTable';
connection.query(queryString, ...);

// Retrieve the most recently created subsegment
const subs = AWSXRay.getSegment().subsegments;

if (subs & & subs.length > 0) {
  var sqlSub = subs[subs.length - 1];
  sqlSub.sql.sanitized_query = queryString;
}
	 

Para obtener una lista completa de campos SQL con permiso, consulte Consultas SQL en la Guía para desarrolladores de AWS X-Ray .