Tracciamento delle query SQL con X-Ray SDK per Node.js - AWS X-Ray
Includere dati aggiuntivi nei sottosegmenti SQL

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Tracciamento delle query SQL con X-Ray SDK per Node.js

Nota

Avviso di SDK/Daemon manutenzione a raggi X: il 25 febbraio 2026, X-Ray SDKs/Daemon entrerà in modalità di manutenzione, in cui AWS limiterà le versioni di AWS X-Ray SDK e Daemon per risolvere solo problemi di sicurezza. Per ulteriori informazioni sulla tempistica del supporto, consulta. Cronologia di X-Ray SDK e Daemon Support Ti consigliamo di migrare a. OpenTelemetry Per ulteriori informazioni sulla migrazione a OpenTelemetry, vedere Migrazione dalla strumentazione a raggi X alla strumentazione. OpenTelemetry

Strumenta le query del database SQL inserendo il client SQL nel metodo client X-Ray SDK for Node.js corrispondente.

  • 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);

Quando utilizzi un client analizzato per eseguire query SQL, X-Ray SDK per Node.js memorizza le informazioni sulla connessione e sulla query in un sottosegmento

Includere dati aggiuntivi nei sottosegmenti SQL

È possibile aggiungere informazioni aggiuntive ai sottosegmenti generati per le query SQL, purché siano mappate su un campo SQL consentito. Ad esempio, per registrare la stringa di query SQL sanificata in un sottosegmento, è possibile aggiungerla direttamente all'oggetto SQL del sottosegmento.

Esempio Assegna SQL al sottosegmento
    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;
}

Per un elenco completo dei campi SQL consentiti, consulta SQL Queries nella Developer Guide.AWS X-Ray