dt-js-runtime

Dynatrace JavaScript ランタイム

Dynatrace JS ランタイムは、JavaScript／TypeScript を実行するサーバーサイドの AppEngine サンドボックスです。

関数の契約

すべてのエントリーポイントで、デフォルトの非同期関数をエクスポートする必要があります。

export default async function () {
  // ...
  return result;
}

ES モジュール構文が必須です。TypeScript も使用できます（型注釈、インターフェース、ジェネリクス）。その他のエクスポート形式はサポートされていません。

参照資料

まずここから始め、必要なファイルだけを読み込んでください。

ファイル	読み込むタイミング
references/limits-and-restrictions.md	タイムアウト／メモリ／I/O のクォータ、禁止事項（eval、WebSocket、ソケット、ファイルシステム）
references/apis-and-modules.md	利用可能な Web API と Node.js 互換モジュール（fetch、crypto、streams、buffer など）
references/fetch.md	内部の /platform/... API または外部 URL の呼び出し、認証情報ボールト、送信先許可リスト
references/sdk.md	@dynatrace-sdk/* パッケージを使用する場合。インデックスから、該当する SDK ごとのファイルに進めます

dtctl で関数を実行する

dtctl exec function を使用すると、アプリをデプロイせずに JS ランタイムのコードを実行できます。

# Run inline code
dtctl exec function --code 'export default async function() { return "hello" }'

# Run from file
dtctl exec function -f script.js

# Pass JSON input — the parsed object is the function's argument
dtctl exec function -f script.js --payload '{"key":"value"}'

関数は省略可能なパラメーターを受け取ることができます。--payload は解析され、その引数として直接渡されます。event.payload フィールドにはラップされません。

export default async function(payload) {
  // with --payload '{"key":"value"}', payload is {"key": "value"}
  return payload.key;
}

認証のセットアップ、コンテキストの切り替え、および exec function の全リファレンスについては、dynatrace-control スキルを読み込んでください。