Ringkasan integrasi log SLS dengan SOAR - Security Center

Komponen SLS menyediakan kemampuan kueri dan penulisan log untuk Layanan Log Sederhana (SLS).

Deskripsi fitur

Aksi	Deskripsi	Skenario
run_query	Melakukan kueri log SLS.	Melakukan kueri log SLS.
putLogs	Menulis log ke SLS.	Menulis log ke SLS.

Contoh konfigurasi komponen

Topik ini memberikan contoh konfigurasi parameter untuk setiap aksi dari komponen SLS. Anda dapat mengimpor contoh tersebut sebagai playbook uji. Melalui editor alur visual, Anda dapat lebih intuitif memahami dan menguji parameter konfigurasi setiap aksi, serta dengan mudah menguasai logika fungsional dan penggunaan komponen. Untuk prosedurnya, lihat Impor Playbook.

Catatan

Anda dapat menyimpan data contoh sebagai file JSON terlebih dahulu, lalu mengimpornya ke dalam editor.

Data Contoh

{
    "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": "Kueri log dari 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": "Menulis data ke 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": []
        }
    ]
}

Konfigurasi instance sumber daya

Untuk menggunakan komponen logging SLS, Anda perlu mengonfigurasi informasi terkait Layanan Log Sederhana terlebih dahulu. Ikuti langkah-langkah berikut:

Klik komponen, dan di tab Konfigurasi Informasi Dasar, klik Resource Instance Configuration di area Konfigurasi Instance Sumber Daya.

Di halaman Konfigurasi Instance Sumber Daya, klik tombol Add. Lengkapi konfigurasi sebagai berikut:

Item konfigurasi	Deskripsi
assetname	Anda dapat menyesuaikan nama sumber daya sesuai dengan kebutuhan bisnis Anda.
end_point	Alamat akses layanan SLS. Untuk informasi lebih lanjut tentang alamat akses, lihat Titik akhir layanan.
sub_id	ID AccessKey dari pengguna yang dapat mengoperasikan Layanan Log Sederhana. Untuk informasi tentang cara membuat AccessKey, lihat Buat AccessKey.
access_key	AccessKey Secret dari pengguna yang dapat mengoperasikan Layanan Log Sederhana. Penting Jika Anda menggunakan informasi AccessKey dari pengguna RAM, pastikan bahwa pengguna RAM memiliki izin untuk mengoperasikan API Layanan Log Sederhana.

run_query

Parameter

Parameter	Deskripsi
project	Nama proyek SLS yang akan diakses.
logstore	Nama logstore SLS yang akan diakses.
endpoint	Alamat akses layanan SLS. Untuk informasi lebih lanjut tentang alamat akses, lihat Titik akhir layanan.
query	Sintaks SQL untuk kueri SLS. Untuk informasi lebih lanjut tentang sintaks SQL, lihat Sintaks SQL dan fungsi. Penting Jika Anda menggunakan pernyataan analisis dan batas yang dikonfigurasi melebihi 100, Anda harus mengonfigurasi bidang order by. Jika tidak, beberapa data tidak dapat dikueri.
from	Waktu mulai kueri, dalam milidetik.
to	Waktu akhir kueri, dalam milidetik.
limit	Jumlah maksimum entri, dengan batas atas 10.000.

Aksi PutLogs

Parameter

Parameter	Deskripsi
project	Nama proyek SLS yang akan diakses.
logstore	Nama logstore SLS yang akan diakses.
endpoint	Alamat akses layanan SLS.
topic	Bidang yang ditentukan pengguna digunakan untuk menandai sekelompok log.
logItems	Informasi log yang akan ditulis. Format log hanya mendukung string format JSON, JSONObject 3, dan JSONArray, seperti {"test":"test"}. Catatan Bidang _logUuid akan ditambahkan ke setiap entri log sebagai pengenal unik saat menulis, sehingga memudahkan pengguna untuk mencari log yang baru saja ditulis.