全部产品
Search
文档中心

Simple Log Service:pull_logs

更新时间:Jun 26, 2025

Mengekstrak log berdasarkan kursor yang ditentukan. Perintah pull_logs dapat dijalankan secara iteratif untuk menanyakan log dan mengembalikan hasilnya, cocok untuk skenario dengan sejumlah besar log.

Sintaks permintaan

aliyunlog log pull_logs --project_name=<nilai> --logstore_name=<nilai> --shard_id=<nilai> --cursor=<nilai> [--count=<nilai>] [--end_cursor=<nilai>] [--compress=<nilai>] [--access-id=<nilai>] [--access-key=<nilai>] [--sts-token=<nilai>] [--region-endpoint=<nilai>] [--client-name=<nilai>] [--jmes-filter=<nilai>] [--format-output=<nilai>] [--decode-output=<nilai>]

Parameter permintaan

Tabel berikut menjelaskan parameter yang diperlukan dan spesifik untuk perintah ini.

Parameter

Tipe

Diperlukan

Contoh

Deskripsi

--project_name

String

Ya

aliyun-test-project

Nama proyek.

--logstore_name

String

Ya

logstore-a

Nama Logstore.

--shard_id

Integer

Ya

0

ID shard.

--cursor

String

Ya

MTYxNDc1MDAyNzM3MzIwNTcxNA==

Kursor awal tempat sistem mulai membaca log.

--count

Integer

Tidak

2

Jumlah log yang ingin Anda baca.

--end_cursor

String

Tidak

MTYxNDc1MDAyNzM3MzIwNTcxNg==

Kursor akhir tempat sistem berhenti membaca log.

--compress

Boolean

Tidak

true

Menentukan apakah akan menekan log yang dikembalikan. Nilai valid:

  • true (default)

  • false

Untuk informasi tentang parameter global antarmuka baris perintah (CLI) Simple Log Service, lihat Parameter Global.

Contoh

  • Permintaan Contoh

    Gunakan akun default untuk menanyakan dua log dari kursor yang ditentukan. Contoh perintah:

    aliyunlog log pull_logs --project_name="aliyun-test-project" --logstore_name="logstroe-a" --shard_id=0 --cursor="MTYxNDc1MDAyNzM3MzIwNTcxNA==" --count="2"
  • Respon Contoh

    {
      "count": 2,
      "logs": [
        {
          "__source__": "203.0.113.10",
          "__tag__:__hostname__": "iZ3s******Z",
          "__tag__:__pack_id__": "81C4812927C6B529-15DA",
          "__tag__:__receive_time__": "1619597641",
          "__time__": 1619597638,
          "__topic__": "",
          "activity_id": "",
          "computer_name": "iZ3stckpfjj7wvZ",
          "event_id": "7036",
          "kernel_time": "0",
          "keywords": "[Classic]",
          "level": "Information",
          "log_name": "System",
          "message": "The Network Setup Service service entered the stopped state.",
          "message_error": "[]",
          "opcode": "",
          "process_id": "544",
          "processor_id": "0",
          "processor_time": "0",
          "provider_guid": "{555908d1-a6d7-4695-8e1e-26931d2012f4}",
          "record_number": "8623",
          "related_activity_id": "",
          "session_id": "0",
          "source_name": "Service Control Manager",
          "task": "",
          "thread_id": "3176",
          "type": "wineventlog",
          "user_data": "{\"xml_name\":\"\"}",
          "user_time": "0",
          "version": "0"
        },
        {
          "__source__": "203.0.113.10",
          "__tag__:__hostname__": "iZ3******vZ",
          "__tag__:__pack_id__": "81C4812927C6B529-15DB",
          "__tag__:__receive_time__": "1619598347",
          "__time__": 1619598344,
          "__topic__": "",
          "activity_id": "",
          "computer_name": "iZ3stckpfjj7wvZ",
          "event_id": "7036",
          "kernel_time": "0",
          "keywords": "[Classic]",
          "level": "Information",
          "log_name": "System",
          "message": "The Windows Update service entered the running state.",
          "message_error": "[]",
          "opcode": "",
          "process_id": "544",
          "processor_id": "0",
          "processor_time": "0",
          "provider_guid": "{555908d1-a6d7-4695-8e1e-26931d2012f4}",
          "record_number": "8624",
          "related_activity_id": "",
          "session_id": "0",
          "source_name": "Service Control Manager",
          "task": "",
          "thread_id": "6868",
          "type": "wineventlog",
          "user_data": "{\"xml_name\":\"\"}",
          "user_time": "0",
          "version": "0"
        }
      ],
      "next_cursor": "MTYxNDc1MDAyNzM3MzIwNTcxNg=="
    }

Kode kesalahan

Jika pesan kesalahan dikembalikan, perbaiki kesalahan sesuai dengan kode kesalahan operasi API terkait.

HttpStatusCode

ErrorCode

ErrorMessage

Deskripsi

404

LogStoreNotExist

Logstore tidak ada.

Logstore yang ditentukan tidak ada.

400

ParameterInvalid

Kursor tidak valid.

Kursor yang ditentukan tidak valid.

400

ParameterInvalid

ParameterCount harus dalam [0-1000].

Nilai parameter count tidak valid. Nilai valid untuk parameter count berada dalam rentang 0 hingga 1000.

400

ShardNotExist

Shard tidak ada.

Shard yang ditentukan tidak ada.

400

InternalServerError

Pesan Kesalahan Server Spesifik.

Terjadi kesalahan server internal.

Untuk informasi lebih lanjut, lihat Kode Kesalahan Umum.