SLS コンポーネントは、主に SLS ログのクエリおよび書き込み機能を提供します。
機能説明
操作 | 説明 | シナリオ |
run_query | SLS ログをクエリします。 | SLS ログをクエリします。 |
putLogs | ログを SLS に書き込みます。 | ログを SLS に書き込みます。 |
コンポーネント構成例
このトピックでは、SLS コンポーネントの各操作のパラメーター構成例を示します。テストプレイブックとしてインポートできます。ビジュアルフローエディターを使用すると、各操作の構成パラメーターをより直感的に理解してテストし、コンポーネントの機能ロジックと使用方法を簡単に習得できます。手順については、「プレイブックのインポート」をご参照ください。
サンプルデータを最初に JSON ファイルとして保存してから、エディターにインポートできます。
サンプルデータ
{
"cells": [
{
"shape": "custom-edge",
"zIndex": 1,
"id": "SequenceFlow_0yvd0ew",
"data": {
"nodeType": "sequenceFlow",
"appType": "basic",
"icon": "icon-upper-right-arrow",
"isRequired": false
},
"labels": [],
"isNode": false,
"source": {
"cell": "Action_15qsqhz"
},
"target": {
"cell": "32124b94-ecd0-4370-9878-c08676bacde4"
},
"vertices": []
},
{
"position": {
"x": -560,
"y": 0
},
"size": {
"width": 137,
"height": 66
},
"view": "react-shape-view",
"shape": "activity",
"id": "Action_15qsqhz",
"zIndex": 1,
"data": {
"nodeType": "action",
"appType": "component",
"nodeName": "SLS_1",
"valueData": {
"query": "*",
"limit": "10",
"project": "test_project",
"from": "<%=currentTimeToMs()- 100 * 60 * 1000L%>",
"to": "<%=currentTimeToMs()%>",
"logstore": "test_logstore",
"endpoint": "cn-shangzhou.log.aliyuncs.com"
},
"icon": "https://sophon-gen-v2.oss-cn-zhangjiakou.aliyuncs.com/componentUpload/1641804391435_SLS_logo.svg?Expires=1745566401&OSSAccessKeyId=STS.NVuDNZvKqtwuTJkfJtY******&Signature=s3Rr36HjjDz%2Bqu5wx%2FaTAtTR0dc%3D&security-token=CAIS2AJ1q6Ft5B2yfSjIr5XAD%2FTum5RQw7WeVmzagkohVbkU2PzZrDz2IHhMenFpAegcv%2Fw%2BlGFZ6%2F8elrp6SJtIXleCZtF94oxN9h2gb4fb40wIXRWK0s%2FLI3OaLjKm9u2wCryLYbGwU%2FOpbE%2B%2B5U0X6LDmdDKkckW4OJmS8%2FBOZcgWWQ%2FKBlgvRq0hRG1YpdQdKGHaONu0LxfumRCwNkdzvRdmgm4NgsbWgO%2Fks0OP3AOrlrBN%2Bdiuf8T9NvMBZskvD42Hu8VtbbfE3SJq7BxHybx7lqQs%2B02c5onDWwAJu0%2FXa7uEo4wydVNjFbM9A65Dqufxn%2Fpgt%2Braj4X7xhhEIOVJSSPbSZBbSxJNvU1RXDxQVcEYWxylurjnXvF%2Bo5q63vwUGin%2B2svzhw6RGJ1dq8DgINtD0jokjPndRVbLXs84nxS7gbsGn76oY2zradH%2FdU4il8CyMytAXxqAAZDNL%2FMfqwnfpUW9RMOXa9Q0%2FU5jug3GzZT64g7TdTWpUYEW9f10E3bF%2BHv5B%2Bd9c5yYLrOjVRiwJ7hkN8GRS67b55hST1lWccu6vd%2FKBk9qxZbSc02pD7ymERlhj7sts0FXMLuYlYqc%2BSSGF8vK0GW%2F%2FST%2FLdOTF2wDJB4C9oTCIAA%3D",
"advance": {
"inputParamMode": false,
"onError": "stop_cur_flow",
"rspStatusType": "3",
"rspStatusThreshold": "0",
"description": "Query logs from SLS" // SLS からログをクエリする
},
"componentName": "SLS",
"actionName": "run_query",
"assetUuid": "54c20873-deb3-4474-bdc2-12aba357acb4",
"cascaderValue": []
},
"isNode": true
},
{
"position": {
"x": -788,
"y": 15
},
"size": {
"width": 36,
"height": 36
},
"attrs": {
"body": {
"fill": "white",
"strokeOpacity": 0.95,
"stroke": "black",
"strokeWidth": 2
},
"label": {
"text": "",
"fontSize": 12,
"refX": 0.5,
"refY": "100%",
"refY2": 4,
"textAnchor": "middle",
"textVerticalAnchor": "top"
}
},
"visible": true,
"shape": "circle",
"id": "StartEvent_1",
"zIndex": 1,
"data": {
"nodeType": "startEvent",
"appType": "basic",
"valueData": {},
"icon": "icon-circle"
},
"markup": [
{
"tagName": "circle",
"selector": "body"
},
{
"tagName": "text",
"selector": "label"
}
],
"isNode": true
},
{
"position": {
"x": -21,
"y": 25
},
"size": {
"width": 36,
"height": 36
},
"attrs": {
"body": {
"fill": "white",
"strokeOpacity": 0.95,
"stroke": "black",
"strokeWidth": 2
},
"path": {
"r": 12,
"refX": "50%",
"refY": "50%",
"fill": "black",
"strokeOpacity": 0.95,
"stroke": "black",
"strokeWidth": 4
},
"label": {
"text": "",
"fontSize": 12,
"refX": 0.5,
"refY": "100%",
"refY2": 4,
"textAnchor": "middle",
"textVerticalAnchor": "top"
}
},
"visible": true,
"shape": "circle",
"id": "EndEvent_1bi7n65",
"zIndex": 1,
"data": {
"nodeType": "endEvent",
"appType": "basic",
"valueData": {},
"icon": "icon-radio-off-full"
},
"markup": [
{
"tagName": "circle",
"selector": "body"
},
{
"tagName": "circle",
"selector": "path"
},
{
"tagName": "text",
"selector": "label"
}
],
"isNode": true
},
{
"shape": "custom-edge",
"zIndex": 1,
"id": "SequenceFlow_0d1fm8e",
"data": {
"nodeType": "sequenceFlow",
"appType": "basic",
"icon": "icon-upper-right-arrow",
"isRequired": false
},
"labels": [],
"isNode": false,
"source": {
"cell": "StartEvent_1"
},
"target": {
"cell": "Action_15qsqhz"
},
"vertices": [],
"visible": true,
"router": {
"name": "manhattan",
"args": {
"padding": 5,
"excludeHiddenNodes": true,
"excludeNodes": [
"clone_node_id"
]
}
}
},
{
"position": {
"x": -304,
"y": 0
},
"size": {
"width": 137,
"height": 66
},
"view": "react-shape-view",
"shape": "activity",
"id": "32124b94-ecd0-4370-9878-c08676bacde4",
"zIndex": 1,
"data": {
"nodeType": "action",
"appType": "component",
"nodeName": "SLS_2",
"valueData": {
"logItems": "{\"test\":\"test\"}",
"project": "test_project",
"logstore": "test_logstore",
"endpoint": "cn-shangzhou.log.aliyuncs.com",
"topic": "test"
},
"icon": "https://sophon-gen-v2.oss-cn-zhangjiakou.aliyuncs.com/componentUpload/1641804391435_SLS_logo.svg?Expires=1745566401&OSSAccessKeyId=STS.NVuDNZvKqtwuTJkfJtY******&Signature=s3Rr36HjjDz%2Bqu5wx%2FaTAtTR0dc%3D&security-token=CAIS2AJ1q6Ft5B2yfSjIr5XAD%2FTum5RQw7WeVmzagkohVbkU2PzZrDz2IHhMenFpAegcv%2Fw%2BlGFZ6%2F8elrp6SJtIXleCZtF94oxN9h2gb4fb40wIXRWK0s%2FLI3OaLjKm9u2wCryLYbGwU%2FOpbE%2B%2B5U0X6LDmdDKkckW4OJmS8%2FBOZcgWWQ%2FKBlgvRq0hRG1YpdQdKGHaONu0LxfumRCwNkdzvRdmgm4NgsbWgO%2Fks0OP3AOrlrBN%2Bdiuf8T9NvMBZskvD42Hu8VtbbfE3SJq7BxHybx7lqQs%2B02c5onDWwAJu0%2FXa7uEo4wydVNjFbM9A65Dqufxn%2Fpgt%2Braj4X7xhhEIOVJSSPbSZBbSxJNvU1RXDxQVcEYWxylurjnXvF%2Bo5q63vwUGin%2B2svzhw6RGJ1dq8DgINtD0jokjPndRVbLXs84nxS7gbsGn76oY2zradH%2FdU4il8CyMytAXxqAAZDNL%2FMfqwnfpUW9RMOXa9Q0%2FU5jug3GzZT64g7TdTWpUYEW9f10E3bF%2BHv5B%2Bd9c5yYLrOjVRiwJ7hkN8GRS67b55hST1lWccu6vd%2FKBk9qxZbSc02pD7ymERlhj7sts0FXMLuYlYqc%2BSSGF8vK0GW%2F%2FST%2FLdOTF2wDJB4C9oTCIAA%3D",
"description": "Write data to SLS", // SLS にデータを書き込む
"advance": {
"inputParamMode": false,
"onError": "stop_cur_flow",
"rspStatusType": 3,
"rspStatusThreshold": 0
},
"componentName": "SLS",
"actionName": "putLogs",
"assetUuid": "54c20873-deb3-4474-bdc2-12aba357acb4",
"cascaderValue": [
{
"label": "SLS_1",
"value": "${SLS_1}",
"children": []
}
]
},
"isNode": true
},
{
"shape": "custom-edge",
"zIndex": 1,
"id": "0823a20d-6441-4cef-83e0-0d04dc14fc3b",
"data": {
"nodeType": "sequenceFlow",
"appType": "basic",
"icon": "icon-upper-right-arrow",
"isRequired": false
},
"labels": [],
"isNode": false,
"source": {
"cell": "32124b94-ecd0-4370-9878-c08676bacde4"
},
"target": {
"cell": "EndEvent_1bi7n65"
},
"vertices": []
}
]
}リソースインスタンス構成
SLS ロギングコンポーネントを使用するには、最初に Simple Log Service の関連情報を構成する必要があります。次の手順に従います。
コンポーネントをクリックし、[基本情報構成] タブで、リソースインスタンス構成エリア の [リソースインスタンス構成] をクリックします。
[リソースインスタンス構成] ページで、[追加] ボタンをクリックします。次のように構成を完了します。
構成項目
説明
assetname
ビジネスニーズに応じてリソース名をカスタマイズできます。
end_point
SLS サービスのアクセスアドレス。アクセスアドレスの詳細については、「サービスエンドポイント」をご参照ください。
sub_id
Simple Log Service を操作できるユーザーの AccessKey ID。 AccessKey の作成方法については、「AccessKey を作成する」をご参照ください。
access_key
Simple Log Service を操作できるユーザーの AccessKey Secret。
重要RAM ユーザーの AccessKey 情報を使用する場合は、RAM ユーザーに Simple Log Service API を操作する権限があることを確認してください。
run_query
パラメータ
パラメータ | 説明 |
project | アクセスする SLS プロジェクトの名前。 |
logstore | アクセスする SLS ログストアの名前。 |
endpoint | SLS サービスのアクセスアドレス。アクセスアドレスの詳細については、「サービスエンドポイント」をご参照ください。 |
query | SLS をクエリするための SQL 構文。 SQL 構文の詳細については、「SQL 構文と関数」をご参照ください。 重要 分析ステートメントを使用し、設定された制限が 100 を超える場合は、order by フィールドを設定する必要があります。そうでない場合、一部のデータをクエリできません。 |
from | クエリの開始時刻 (ミリ秒単位)。 |
to | クエリの終了時刻 (ミリ秒単位)。 |
limit | 最大エントリ数。上限は 10,000 です。 |
PutLogs 操作
パラメータ
パラメータ | 説明 |
project | アクセスする SLS プロジェクトの名前。 |
logstore | アクセスする SLS Logstore の名前。 |
endpoint | SLS サービスのアクセスアドレス。 |
topic | ログのバッチをマークするために使用されるユーザー定義フィールド。 |
logItems | 書き込むログ情報。ログフォーマットは、JSON フォーマット文字列、JSONObject 3、および JSONArray（例： {"test":"test"}）のみをサポートします。 説明 書き込み時に、各ログエントリに一意の識別子として _logUuid フィールドが追加され、ユーザーは最近書き込まれたログを簡単にクエリできます。 |