Hilf uns, das zu verbessernAWS SDK for JavaScriptVersion 3 (V3) -Dokumentation, indem Sie Feedback mithilfe derFeedbackverlinken, oder erstellen Sie ein Issue oder Pull Request aufGitHub
DieAWS SDK for JavaScriptReferenzhandbuch zur V3-APIbeschreibt ausführlich alle API-Operationen für denAWS 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:
So rufen Sie eine Liste der veröffentlichten CloudWatch-Metriken ab.
So veröffentlichen Sie Datenpunkte in CloudWatch-Metriken.
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 Node.js Modulen 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 desCloudWatch
Client-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:
-
Richten Sie die Projektumgebung ein, um diese Node TypeScript-Beispiele auszuführen, und installieren Sie die erforderlichenAWS SDK for JavaScriptund Drittanbieter-Module. Folgen Sie den Anweisungen fürGitHub
aus. Erstellen Sie eine freigegebene Konfigurationsdatei mit Ihren Anmeldeinformationen. Weitere Informationen zum Bereitstellen einer Datei mit gemeinsam genutzten Anmeldeinformationen finden Sie unter Laden der Anmeldeinformationen in Node.js aus der Datei für gemeinsam genutzte Anmeldeinformationen.
Diese Beispiele verwenden ECMASCRIPT6 (ES6). Dies erfordert Node.js Version 13.x oder höher. Informationen zum Herunterladen der neuesten Version von Node.js finden Sie unterNode.js Downloads.
Wenn Sie jedoch lieber CommonJS-Sytax verwenden möchten, lesen Sie bitteJavaScript ES6/CommonJS-Syntax
Auflisten von Metriken
Erstellen eineslibs
Erstellen Sie ein Modul Node.js mit dem DateinamencloudWatchClient.js
aus. Kopieren Sie den folgenden Code und fügen Sie ihn ein, wodurch das CloudWatch-Clientobjekt erstellt wird. ErsetzenREGION
mit 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 GitHub
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();
Geben Sie an der Eingabeaufforderung Folgendes ein.
node listMetrics.js
Diesen Beispielcode finden Sie unterhier auf GitHub
Einreichen benutzerdefinierter Metriken
Erstellen eineslibs
Erstellen Sie ein Modul Node.js mit dem DateinamencloudWatchClient.js
aus. Kopieren Sie den folgenden Code und fügen Sie ihn ein, wodurch das CloudWatch-Clientobjekt erstellt wird. ErsetzenREGION
mit 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 GitHub
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();
Geben Sie an der Eingabeaufforderung Folgendes ein.
node putMetricData.js
Diesen Beispielcode finden Sie unterhier auf GitHub