gl-store-s3.js/node_modules/aws-sdk/lib/publisher/index.js

125 lines
3.3 KiB
JavaScript

var dgram = require('dgram');
var stringToBuffer = require('./string-to-buffer').stringToBuffer;
var MAX_MESSAGE_SIZE = 1024 * 8; // 8 KB
/**
* Publishes metrics via udp.
* @param {object} options Paramters for Publisher constructor
* @param {number} [options.port = 31000] Port number
* @param {string} [options.clientId = ''] Client Identifier
* @param {boolean} [options.enabled = false] enable sending metrics datagram
* @api private
*/
function Publisher(options) {
// handle configuration
options = options || {};
this.enabled = options.enabled || false;
this.port = options.port || 31000;
this.clientId = options.clientId || '';
if (this.clientId.length > 255) {
// ClientId has a max length of 255
this.clientId = this.clientId.substr(0, 255);
}
this.messagesInFlight = 0;
this.address = 'localhost';
}
Publisher.prototype.fieldsToTrim = {
UserAgent: 256,
SdkException: 128,
SdkExceptionMessage: 512,
AwsException: 128,
AwsExceptionMessage: 512,
FinalSdkException: 128,
FinalSdkExceptionMessage: 512,
FinalAwsException: 128,
FinalAwsExceptionMessage: 512
};
/**
* Trims fields that have a specified max length.
* @param {object} event ApiCall or ApiCallAttempt event.
* @returns {object}
* @api private
*/
Publisher.prototype.trimFields = function(event) {
var trimmableFields = Object.keys(this.fieldsToTrim);
for (var i = 0, iLen = trimmableFields.length; i < iLen; i++) {
var field = trimmableFields[i];
if (event.hasOwnProperty(field)) {
var maxLength = this.fieldsToTrim[field];
var value = event[field];
if (value && value.length > maxLength) {
event[field] = value.substr(0, maxLength);
}
}
}
return event;
};
/**
* Handles ApiCall and ApiCallAttempt events.
* @param {Object} event apiCall or apiCallAttempt event.
* @api private
*/
Publisher.prototype.eventHandler = function(event) {
// set the clientId
event.ClientId = this.clientId;
this.trimFields(event);
var message = stringToBuffer(JSON.stringify(event));
if (!this.enabled || message.length > MAX_MESSAGE_SIZE) {
// drop the message if publisher not enabled or it is too large
return;
}
this.publishDatagram(message);
};
/**
* Publishes message to an agent.
* @param {Buffer} message JSON message to send to agent.
* @api private
*/
Publisher.prototype.publishDatagram = function(message) {
var self = this;
var client = this.getClient();
this.messagesInFlight++;
this.client.send(message, 0, message.length, this.port, this.address, function(err, bytes) {
if (--self.messagesInFlight <= 0) {
// destroy existing client so the event loop isn't kept open
self.destroyClient();
}
});
};
/**
* Returns an existing udp socket, or creates one if it doesn't already exist.
* @api private
*/
Publisher.prototype.getClient = function() {
if (!this.client) {
this.client = dgram.createSocket('udp4');
}
return this.client;
};
/**
* Destroys the udp socket.
* @api private
*/
Publisher.prototype.destroyClient = function() {
if (this.client) {
this.client.close();
this.client = void 0;
}
};
module.exports = {
Publisher: Publisher
};