API 脚本ガイド

Instana のSynthetic API スクリプトでは、スクリプト開発を効率化するために、以下の事前定義されたグローバル変数が使用されています：

GET 要求を送信するには、以下の構文を使用します。

const assert = require('assert');
(async function () {
    var options = {
      url: 'https://reqres.in/api/messages',
      https:{ rejectUnauthorized: false }
    };

    // Send GET request
    let response = await $got.get(options);

    // Validate the response status code, it should be 200 here
    assert.ok(response && response.statusCode == 200, 'Expect 200');
})();
 

POST JSON リクエストを送信するには、次の構文を使用します：

const assert = require('assert');
(async function () {
    // Send JSON Data example
    let URL = 'https://reqres.in/api/users';

    // Define JSON data
    let data = {
      'job': 'leader',
      'name': 'morpheus'
    };

    // Make POST request
    let response = await $got.post(URL, {
      header: {
        'content-type': 'application/json'
      },
      json: data
    });

    // Validate the response code, if assertion fails, log "failed to create message, error is " plus 
    // results as error message on Synthetic dashboard
    assert.ok(response && response.statusCode == 201, 'expect 201');
})();
 

POST のフォームリクエストを送信するには、次の構文を使用します：

const assert = require('assert');
(async function () {
    const response = await $got.post('https://httpbin.org/anything', {
      form: {
        text: 'hello world'
      }
    });

    assert.ok(response && response.statusCode == 200, 'expect 200');
})();    
 

HTTPS リクエストを送信し、セキュリティ保護されていない証明書を許可するには、次の構文を使用します：

 // Allow the insecure certificate
 await $got('https://example.com', {
   https:{ rejectUnauthorized: false }
 });
 

証明書を添付して TLS / SSL プロトコルのリクエストを送信するには、次の構文を使用します：

 // Single key with passphrase
 await $got('https://example.com', {
   https: {
     key: $secure.key,
     certificate: $secure.certificate,
     passphrase: $secure.passphrase
   }
 });
 

基本認証要求を送信するには、以下の構文を使用します。

 await $got.get('http://some.server.com/', {
   https:{ rejectUnauthorized: false },
   headers: {
     Authorization: "Basic " + $secure.AUTH_CRED
   }
 });
 

ベアラ認証リクエストを送信するには、以下の構文を使用する：

 await $got.get('http://some.server.com/', {
   headers: {
     'Authorization': "Bearer " + $secure.authToken
   }
 });
 

サポートされるモジュールをインポートするには、 Node.js のインポートに関する標準的な手順に従ってください。 以下の例を参照してください。

const crypto = require('crypto-js');
 

サポートされるコア・モジュールは以下のとおりです。

• アサート
• 非同期フック
• バッファー
• 定数
• 暗号
• Dgram
• DNS
• ドメイン
• イベント
• fs
• http
• http2
• HTTPS
• モジュール
• 純
• os
• パス
• パフォーマンス・フック
• 穿孔コード
• queryString
• ストリーム
• ストリング・デコーダー
• タイマー
• tls
• トレース・イベント
• tty
• URL
• Util
• zlib

以下のサード・パーティー・モジュールがサポートされています。

• assert-plus 1.0.0
• VOB 2.1.2
• aws-sdk/client-cloudwatch 3.624.0
• @aws-sdk/client-s3 3.626.0
• aws-sdk/client-secrets-manager 3.624.0
• aws-sdk/client-sts 3.624.0
• @babel/コア 7.23.2
• @ibm-cloud/secrets-manager 2.0.10
• akamai-edgegrid 3.4.5
• basic-ftp 4.6.6
• body-parser 1.20.0
• btoa 1.2.1
• 複製 0.1.19
• 色 1.4.0
• consoleplusplus 1.4.4
• 暗号 js 4.2.0
• デバッグ 2.6.9
• 3.0.2 の拡張
• Faker 5.5.3
• 11.8.6 を取得しました
• Ji 17.6.0
• js-yaml 3.14.1
• JSPRIM 1.4.2
• kafkajs 2.2.4
• ldapauth-fork 5.0.5
• 宿泊施設 4.17.21
• モーメント 2.29.4
• mongodb 6.5.0
• mssql 11.0.1
• net-snmp 3.8.2
• node-stream-zip 1.15.0
• oracledb 6.9.0
• prom-クライアント 14.2.0
• protocol-buffers 4.2.0
• 1.5.1
• 要求 ( @cypress/request@3.0.1に基づく)
• 13.2.3
• SIP 0.0.6
• ssh2-sftp-client 7.2.3
• sshpk 1.17.0
• ssl-チェッカー 2.0.8
• swagger-パーサー 8.0.4
• telnet-client 2.2.1
• テキスト・エンコード 0.7.0
• スリフト 0.14.2
• タフクッキー 4.1.3
• 下線 1.13.4
• unzipper 0.10.11
• url-parse 1.5.10
• urllib2.43.0
• uuid 3.4.0
• バリデーター 13.7.0
• わあ7.5.10
• xml2js 0.5.0

API スクリプトをテストおよびデバッグするには、次の例に示すように コマンド script-cli を使用します：

# Usage:
# test a single script
script-cli <script_name>
# test bundled scripts
script-cli -d <dir> <script-entry-file>
# Example:
script-cli examples/example1.js
script-cli -d examples/bundle-example1 index.js
 

シンセティック・スクリプトを作成した後、以下のステップを実行します。

1. を使用して synthetic-api-scriptAPI スクリプトを作成し、次の script-cli コマンドでそのスクリプトを文字列に変換します：

   # Usage:
   script-cli -s <script-file-path>
   # Example:
   script-cli -s examples/got-get.js
    

   以下の例では、結果を表示します。

   {
     "syntheticType":"HTTPScript",
     "script":"var assert = require('assert');\n\n(async function() {\n  var options = {\n    url: 'https://httpbin.org/get',\n    https:{\n      rejectUnauthorized: false\n    }\n  };\n\n  let response = await $got.get(options);\n  assert.equal(response.statusCode, 200, 'Expected a 200 OK response');\n  console.log('Request URL %s, statusCode: %d', response.url, response.statusCode);\n})();\n"
   }
    

2. スクリプトの内容をコピーして貼り付け、以下のサンプル API スクリプトのテスト JSON を作成してください。

   {
     "label": "APIScript_Test",
     "active": true,
     "testFrequency": 1,
     "locations": ["DemoPoP1_saas_instana_test"],
     "configuration": {
       "syntheticType": "HTTPScript",
       "script": "converted script string"
     }
   }
    

ビジネス・ロジックが複雑である場合は、開発者が Git リポジトリーで複数のスクリプト・ファイルを管理するのは難しいため、単一のスクリプトにすべてを含めることはできません。

API スクリプトのバンドルテストを作成するには、以下の手順を実行してください：

1. script-cli コマンドを使用して、圧縮ファイルにスクリプトをバンドルします。

   # Usage:
   script-cli -z <bundle-script-folder> <entry-script>
   # Example:
   script-cli -z bundle-example1 bundle-example1/index.js
    

2. テスト構成の および bundle に、 コマンド script-cliscriptFile の出力を入力してください：

   • scriptFile は、バンドルされたスクリプトのエントリー・ポイントです。
   • bundle は、 base64でエンコードされた圧縮ファイルです。

シンセティック・バンドル・テストを作成するには、以下の例に示すようにテスト・ペイロードを入力します。

 {
   "label": "APIScriptBundle_Test",
   "active": true,
   "testFrequency": 5,
   "locations": ["DemoPoP1_saas_instana_test"],
   "configuration": {
     "syntheticType": "HTTPScript",
     "scripts": {
       "scriptFile": "index.js",
       "bundle": "zipped scripts encoded with base64"
     }
   }
 }
 

資格情報を作成するには、 synctl コマンドを使用します。 ユーザー名の資格情報とパスワードの資格情報を作成する例を次に示します。

synctl create cred --key username --value user123

synctl create cred --key password --value pass123
 

資格情報を使用した基本認証を以下の例に示します。

const assert = require('assert');

(async function(){
    const auth = Buffer.from($secure.username + ":" + $secure.password).toString('base64');

    let gotResponse = await $got.get('https://<your-basic-auth-url>', {
        // If rejectUnauthorized is true, it will throw on invalid certificates, such as expired or self-signed ones.
        https:{ rejectUnauthorized: false },
        // set additional headers
        headers: {
            Authorization: `Basic ${auth}`
        },
        timeout: {
            request: 10000 //ms
        }
      }
    );

    console.log('Response statusCode:', gotResponse.statusCode);

    // verify status code
    assert.ok(gotResponse.statusCode == 200, "GET statusCode is " + gotResponse.statusCode + ", it should be 200");
})();
 

Instana の API スクリプトを使用すると、次のようにhttpbin APIを同期的にテストできます：

const assert = require('assert');

async function getExample(){
    var getOptions = {
        url: 'https://httpbin.org/get',
        https:{ rejectUnauthorized: false },
        headers: {
            'Additional-Header': 'Additional-Header-Data'
        }
    };

    let getResponse = await $got.get(getOptions);
    console.info("Sample API - GET, response code: " + getResponse.statusCode);
    assert.ok(getResponse.statusCode == 200, "GET status is " + getResponse.statusCode + ", it should be 200");
    var bodyObj1 = JSON.parse(getResponse.body);
    assert.ok(bodyObj1.url == "https://httpbin.org/get", "httpbin.org REST API GET URL verify failed");
}

async function postExample(){
    var postOptions = {
        url: 'https://httpbin.org/post',
        json: {
            "name1": "this is the first data",
            "name2": "second data"
        },
        https:{ rejectUnauthorized: false },
        headers:{"accept": "application/json"}
    };

    let postResponse = await $got.post(postOptions);
    console.info("Sample API - POST, response code: " + postResponse.statusCode);
    assert.ok(postResponse.statusCode == 200, 'POST status is ' + postResponse.statusCode + ', it should be 200');
    const jsonBody2 = JSON.parse(postResponse.body);
    assert.equal(jsonBody2.json.name1, 'this is the first data', 'Expected this is the first data');
    assert.equal(jsonBody2.json.name2, 'second data', 'Expected second data');
}

async function putExample(){
    var putOptions = {
        url: 'https://httpbin.org/put',
        json: {
            "name1": 'this is the first data',
            "name2": 'second data'
        },
        https:{ rejectUnauthorized: false },
        headers:{"accept": "application/json"}
    };

    let putResponse = await $got.put(putOptions);
    console.info("Sample API - PUT, response code: " + putResponse.statusCode);
    assert.ok(putResponse.statusCode == 200, 'PUT status is ' + putResponse.statusCode + ', it should be 200');
    const jsonBody3 = JSON.parse(putResponse.body);
    assert.ok(jsonBody3.url == "https://httpbin.org/put", "httpbin.org REST API PUT URL verify failed");
    assert.equal(jsonBody3.json.name2, 'second data', 'Expected second data');
}

async function deleteExample(){
    var deleteOptions = {
        url: 'https://httpbin.org/delete',
        https:{ rejectUnauthorized: false },
        headers:{"accept": "application/json"}
    };

    let deleteResponse = await $got.delete(deleteOptions);
    console.info("Sample API - DELETE, response code: " + deleteResponse.statusCode);
    assert.ok(deleteResponse.statusCode == 200, 'DELETE status is ' + deleteResponse.statusCode + ', it should be 200');
    const jsonBody4 = JSON.parse(deleteResponse.body);
    assert.ok(jsonBody4.url == "https://httpbin.org/delete", "httpbin.org REST API DELETE URL verify failed");
}

function showEnvironment(){
    // to print environment variables
    console.info('List PoP environment variables using $synthetic API');
    console.info('Test ID:', $synthetic.TEST_ID);
    console.info('Test Name:', $synthetic.TEST_NAME);
    console.info('Location:', $synthetic.LOCATION);
    console.info('TimeZone:', $synthetic.TIME_ZONE);
    console.info('Job ID:', $synthetic.JOB_ID);

    // to print test custom property defined in customProperties of test definition 
    console.info('Test custom property -> Team: ' + $synthetic.labels.Team);
    console.info('Test custom property -> Purpose: ' + $synthetic.labels.Purpose);

    // to set custom tags dynamically
    // Users can use tag key to to pass the customized value to Smart Alert custom payload 
    $attributes.set('tag_key1', 'value1');
}

async function main(){
    await getExample();
    await postExample()
    await putExample();
    await deleteExample();

    await showEnvironment();
}

main();

 

API のスクリプト例については、 「Syntheticの API スクリプト」 を参照してください。