New Relicカスタムイベントと属性 - ビジネスメトリクスの計測と分析 ​

const newrelic = require('newrelic');

// 購入完了イベントの記録
function recordPurchaseEvent(orderData) {
  newrelic.recordCustomEvent('PurchaseCompleted', {
    orderId: orderData.id,
    amount: orderData.totalAmount,
    currency: orderData.currency,
    paymentMethod: orderData.paymentMethod,
    customerTier: orderData.customer.tier,
    productCategory: orderData.items[0].category,
    shippingMethod: orderData.shipping.method,
    promocodeUsed: orderData.promocode !== null,
    itemCount: orderData.items.length
  });
}

// ユーザーエンゲージメントイベント
function recordUserEngagement(actionData) {
  newrelic.recordCustomEvent('UserEngagement', {
    userId: actionData.userId,
    action: actionData.action,
    featureName: actionData.feature,
    sessionDuration: actionData.sessionTime,
    deviceType: actionData.device.type,
    browserVersion: actionData.browser.version
  });
}

// Node.js でのカスタム属性追加
const newrelic = require('newrelic');

// ユーザー認証時の属性追加
function addUserAttributes(user) {
  newrelic.addCustomAttribute('user.id', user.id);
  newrelic.addCustomAttribute('user.tier', user.subscriptionTier);
  newrelic.addCustomAttribute('user.region', user.region);
  newrelic.addCustomAttribute('user.signupDate', user.createdAt);
  newrelic.addCustomAttribute('user.lastLoginDays', 
    Math.floor((Date.now() - user.lastLogin) / (1000 * 60 * 60 * 24)));
}

// リクエスト処理中の動的属性追加
function processRequest(req, res, next) {
  // A/Bテストバリエーション
  const abTestVariant = determineABTestVariant(req.user);
  newrelic.addCustomAttribute('ab.test.variant', abTestVariant);
  
  // 機能フラグの状態
  const featureFlags = getFeatureFlags(req.user);
  Object.keys(featureFlags).forEach(flag => {
    newrelic.addCustomAttribute(`feature.${flag}`, featureFlags[flag]);
  });
  
  next();
}

// 良い命名例
{
  'user.id': 'user123',
  'user.tier': 'premium',
  'order.amount': 150.99,
  'order.currency': 'USD',
  'payment.method': 'credit_card',
  'shipping.method': 'express',
  'product.category': 'electronics'
}

// 避けるべき命名例
{
  'userId': 'user123',
  'UserTier': 'premium',
  'order_amount': 150.99,
  'Currency': 'USD'
}

// 高カーディナリティ（注意が必要）
newrelic.addCustomAttribute('user.id', userId); // 数百万の異なる値

// 適切なカーディナリティ
newrelic.addCustomAttribute('user.tier', userTier); // premium, standard, trial など

// カーディナリティを下げる工夫
newrelic.addCustomAttribute('user.signupMonth', 
  new Date(user.signupDate).toISOString().substr(0, 7)); // 2024-01 形式

// 非同期でのカスタムイベント記録
async function processOrder(orderData) {
  try {
    // メインの処理
    const result = await completeOrder(orderData);
    
    // カスタムイベントは非同期で記録
    setImmediate(() => {
      recordPurchaseEvent(orderData);
    });
    
    return result;
  } catch (error) {
    // エラーイベントも記録
    setImmediate(() => {
      newrelic.recordCustomEvent('OrderProcessingError', {
        orderId: orderData.id,
        errorType: error.constructor.name,
        errorMessage: error.message.substring(0, 100)
      });
    });
    throw error;
  }
}

// 適切なデータサイズ管理
function sanitizeCustomData(data) {
  return {
    userId: data.userId,
    action: data.action.substring(0, 50), // 文字列長制限
    amount: Math.round(data.amount * 100) / 100, // 小数点精度制限
    timestamp: Date.now(),
    // 不要な大きなオブジェクトは除外
    // rawData: data.rawData // これは含めない
  };
}