Helfen Sie uns, dasAWS SDK for JavaScriptVersion 3 (V3) -Dokumentation durch Feedback unter Verwendung derFeedbackLink oder erstellen Sie ein Problem oder ziehen Sie eine Anfrage anGitHubaus.

DieAWS SDK for JavaScriptReferenzhandbuch zur V3-API-Referenzbeschreibt ausführlich alle API-Operationen für dieAWS SDK for JavaScriptVersion 3 (V3).

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Abrufen von Metriken aus Amazon CloudWatch

Dieses Node.js-Codebeispiel zeigt:

Das Szenario

Metriken sind Daten über die Leistung Ihrer Systeme. Sie können die detaillierte Überwachung einiger Ressourcen, wie der Amazon EC2 EC2-Instances, oder Ihrer eigenen Anwendungsmetriken aktivieren.

In diesem Beispiel werden eine Reihe von Modulen Node.js verwendet, um Metriken von CloudWatch abzurufen und Ereignisse an Amazon CloudWatch Events zu senden. Die Node.js Module verwenden das SDK für JavaScript, um Metriken von CloudWatch mithilfe dieser Methoden desCloudWatchClient-Klasse:

Weitere Informationen zu CloudWatch Metriken finden Sie unter Amazon-CloudWatch-Metriken im Amazon-CloudWatch-Benutzerhandbuch.

Erforderliche Aufgaben

Zum Einrichten und Ausführen dieses Beispiels müssen Sie zunächst diese Aufgaben abschließen:

Auflisten von Metriken

Erstellen eineslibsErstellen Sie ein Modul Node.js mit dem DateinamencloudWatchClient.jsaus. Kopieren Sie den folgenden Code und fügen Sie ihn ein, wodurch das CloudWatch-Clientobjekt erstellt wird. ErsetzenREGIONmit IhrerAWSRegion.

import { CloudWatchClient } from "@aws-sdk/client-cloudwatch";
// Set the AWS Region.
const REGION = "REGION"; //e.g. "us-east-1"
// Create an Amazon CloudWatch service client object.
export const cwClient = new CloudWatchClient({ region: REGION });

Dieser Code ist verfügbarhier auf GitHubaus.

Erstellen Sie ein Node.js-Modul mit dem Dateinamen listMetrics.js. Stellen Sie sicher, dass Sie das SDK, wie zuvor dargestellt CloudWatch konfigurieren. Erstellen Sie ein JSON-Objekt mit den erforderlichen Parametern für das Auflisten von Metriken. Rufen Sie die ListMetricsCommand-Methode zum Auflisten der IncomingLogEvents-Metrik auf.

// Import required AWS SDK clients and commands for Node.js
import { ListMetricsCommand } from "@aws-sdk/client-cloudwatch";
import { cwClient } from "./libs/cloudWatchClient.js";

// Set the parameters
export const params = {
  Dimensions: [
    {
      Name: "LogGroupName" /* required */,
    },
  ],
  MetricName: "IncomingLogEvents",
  Namespace: "AWS/Logs",
};

export const run = async () => {
  try {
    const data = await cwClient.send(new ListMetricsCommand(params));
    console.log("Success. Metrics:", JSON.stringify(data.Metrics));
    return data;
  } catch (err) {
    console.log("Error", err);
  }
};
// Uncomment this line to run execution within this file.
// run();

Um das Beispiel auszuführen, geben Sie an der Eingabeaufforderung Folgendes ein.

node listMetrics.js

Diesen Beispiel-Code finden Siehier auf GitHubaus.

Einreichen benutzerdefinierter Metriken

Erstellen eineslibsErstellen Sie ein Modul Node.js mit dem DateinamencloudWatchClient.jsaus. Kopieren Sie den folgenden Code und fügen Sie ihn ein, wodurch das CloudWatch-Clientobjekt erstellt wird. ErsetzenREGIONmit IhrerAWSRegion.

import { CloudWatchClient } from "@aws-sdk/client-cloudwatch";
// Set the AWS Region.
const REGION = "REGION"; //e.g. "us-east-1"
// Create an Amazon CloudWatch service client object.
export const cwClient = new CloudWatchClient({ region: REGION });

Dieser Code ist verfügbarhier auf GitHubaus.

Erstellen Sie ein Node.js-Modul mit dem Dateinamen putMetricData.js. Stellen Sie sicher, dass Sie das SDK, wie zuvor dargestellt CloudWatch konfigurieren. Erstellen Sie ein JSON-Objekt mit den erforderlichen Parametern für das Übermitteln eines Datenpunktes an die benutzerdefinierte PAGES_VISITED-Metrik. Rufen Sie die PutMetricDataCommand-Methode auf.

// Import required AWS SDK clients and commands for Node.js
import { PutMetricDataCommand } from "@aws-sdk/client-cloudwatch";
import { cwClient } from "./libs/cloudWatchClient.js";

// Set the parameters
export const params = {
  MetricData: [
    {
      MetricName: "PAGES_VISITED",
      Dimensions: [
        {
          Name: "UNIQUE_PAGES",
          Value: "URLS",
        },
      ],
      Unit: "None",
      Value: 1.0,
    },
  ],
  Namespace: "SITE/TRAFFIC",
};

export const run = async () => {
  try {
    const data = await cwClient.send(new PutMetricDataCommand(params));
    console.log("Success", data.$metadata.requestId);
    return data;
  } catch (err) {
    console.log("Error", err);
  }
};
// Uncomment this line to run execution within this file.
// run();

Um das Beispiel auszuführen, geben Sie an der Eingabeaufforderung Folgendes ein.

node putMetricData.js

Diesen Beispiel-Code finden Siehier auf GitHubaus.