Siapkan klien SLS Java SDK untuk injeksi log - Simple Log Service

Client adalah klien Java SDK yang digunakan untuk mengakses Layanan Log Sederhana. Klien ini menyediakan berbagai metode untuk membuat Proyek, menyiapkan penyimpanan log, menulis log, dan membaca log. Untuk menggunakan Simple Log Service SDK untuk Java dalam mengirimkan permintaan, Anda perlu menginisialisasi instance Client dan menyesuaikan pengaturan default sesuai kebutuhan bisnis Anda.

Prasyarat

Simple Log Service SDK untuk Java telah diinstal. Untuk informasi lebih lanjut, lihat Instal Simple Log Service SDK untuk Java.

Prosedur

Anda dapat memilih salah satu metode inisialisasi berikut berdasarkan kebutuhan bisnis Anda:

Inisialisasi berbasis pasangan AccessKey: Pasangan AccessKey berlaku jangka panjang dan dapat langsung digunakan untuk panggilan API. Metode ini cocok untuk skenario di mana penggantian kredensial akses secara sering tidak diperlukan.
Inisialisasi berbasis STS: Security Token Service (STS) menghasilkan kredensial akses sementara. Metode ini cocok untuk skenario yang memerlukan otorisasi dinamis dan sementara.

Gunakan pasangan AccessKey

Inisialisasi instance Client

 public Client(String endpoint, String  accessKeyId, String accessKeySecret)

Parameter permintaan

Parameter	Tipe	Diperlukan	Deskripsi	Contoh
endpoint	String	Ya	Titik akhir. Titik akhir digunakan untuk mengakses layanan Alibaba Cloud. Pada sebagian besar kasus, titik akhir adalah URL. Titik akhir menentukan informasi tentang layanan, seperti protokol akses, nama host, port, dan jalur. Klien dapat menggunakan informasi tersebut untuk mengakses layanan. Untuk informasi lebih lanjut, lihat Titik Akhir. Layanan Log Sederhana mendukung titik akhir publik, titik akhir VPC, dan titik akhir percepatan. Titik akhir publik: Jika data ditarik melalui titik akhir publik Layanan Log Sederhana, lalu lintas baca melalui Internet akan terjadi. Untuk informasi lebih lanjut tentang penagihan, lihat Item yang dapat ditagih dari pay-by-ingested-data dan Item yang dapat ditagih dari pay-by-feature. Untuk informasi lebih lanjut, lihat Titik Akhir. Titik akhir VPC: Jika Anda menggunakan layanan Alibaba Cloud lain yang berada di wilayah yang sama dengan proyek Layanan Log Sederhana Anda untuk mengakses Layanan Log Sederhana, kami sarankan Anda menggunakan titik akhir VPC. Untuk informasi lebih lanjut, lihat Titik Akhir. Percepatan titik akhir: Jika server Anda dan Layanan Log Sederhana berada di wilayah yang berbeda, seperti di dalam dan luar Tiongkok, latensi jaringan tinggi dan transmisi tidak stabil ketika data ditransmisikan melalui Internet. Dalam hal ini, Anda dapat menggunakan titik akhir percepatan. Untuk informasi lebih lanjut, lihat Gunakan fitur percepatan transfer.	`cn-hangzhou.log.aliyuncs.com`
accessKeyId	String	Ya	ID AccessKey dari akun Alibaba Cloud atau Pengguna Resource Access Management (RAM) jika Anda menggunakan pasangan AccessKey untuk mengonfigurasi kredensial akses. ID AccessKey digunakan untuk mengidentifikasi pengguna. Untuk informasi lebih lanjut, lihat Konfigurasikan kredensial akses. Peringatan Pasangan AccessKey dari akun Alibaba Cloud memiliki izin penuh pada sumber daya. Kami sarankan Anda tidak menggunakan pasangan AccessKey dari akun Alibaba Cloud untuk menghindari risiko yang disebabkan oleh kebocoran pasangan AccessKey. Kami sarankan Anda menggunakan pasangan AccessKey dari pengguna RAM yang diberi izin berdasarkan prinsip hak istimewa minimal.	LTAI****************
accessKeySecret	String	Ya	Rahasia AccessKey dari akun Alibaba Cloud atau pengguna RAM jika Anda menggunakan pasangan AccessKey untuk mengonfigurasi kredensial akses. Rahasia AccessKey digunakan untuk memverifikasi ID AccessKey Anda. Untuk informasi lebih lanjut, lihat Konfigurasikan kredensial akses.	yourAccessKeySecret

Kode contoh

Algoritma tanda tangan V4 menggunakan metode enkripsi dan tanda tangan yang lebih kompleks untuk memberikan keamanan lebih tinggi. Algoritma tanda tangan V1 relatif sederhana. Pilih algoritma tanda tangan berdasarkan kebutuhan bisnis Anda.

Tanda tangan V4

package com.test.controller;

import com.aliyun.openservices.log.Client;
import com.aliyun.openservices.log.http.client.ClientConfiguration;
import com.aliyun.openservices.log.http.signer.SignVersion;

public class Sample {

    public static void main(String[] args) throws Exception {
        // Tentukan titik akhir Layanan Log Sederhana. Dalam contoh ini, titik akhir Layanan Log Sederhana untuk wilayah China (Beijing) digunakan. Ganti nilai parameter dengan titik akhir yang sebenarnya.
        String endpoint = "cn-beijing.log.aliyuncs.com";
        // Dapatkan ID AccessKey dan rahasia AccessKey dari variabel lingkungan.
        String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
        String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
        ClientConfiguration clientConfiguration = new ClientConfiguration();
        clientConfiguration.setRegion("cn-beijing");
        clientConfiguration.setSignatureVersion(SignVersion.V4);
        Client client = new Client(endpoint,
                accessKeyId,
                accessKeySecret,
                clientConfiguration);
    }
}

Tanda tangan V1

package com.test.controller;

import com.aliyun.openservices.log.Client;

public class Sample {

    public static void main(String[] args) throws Exception {
        // Tentukan titik akhir Layanan Log Sederhana. Dalam contoh ini, titik akhir Layanan Log Sederhana untuk wilayah China (Beijing) digunakan. Ganti nilai parameter dengan titik akhir yang sebenarnya.
        String endpoint = "cn-beijing.log.aliyuncs.com";
        // Dapatkan ID AccessKey dan rahasia AccessKey dari variabel lingkungan.
        String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
        String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
        Client client = new Client(endpoint, accessKeyId, accessKeySecret);
    }
}

Gunakan STS

Inisialisasi instance Client

 public Client(String endpoint, String  accessKeyId, String accessKeySecret)

Parameter permintaan

Parameter	Tipe	Diperlukan	Deskripsi	Contoh
endpoint	String	Ya	Titik akhir. Titik akhir digunakan untuk mengakses layanan Alibaba Cloud. Pada sebagian besar kasus, titik akhir adalah URL. Titik akhir menentukan informasi tentang layanan, seperti protokol akses, nama host, port, dan jalur. Klien dapat menggunakan informasi tersebut untuk mengakses layanan. Untuk informasi lebih lanjut, lihat Titik Akhir. Layanan Log Sederhana mendukung titik akhir publik, titik akhir VPC, dan titik akhir percepatan. Titik akhir publik: Jika data ditarik melalui titik akhir publik Layanan Log Sederhana, lalu lintas baca melalui Internet akan terjadi. Untuk informasi lebih lanjut tentang penagihan, lihat Item yang dapat ditagih dari pay-by-ingested-data dan Item yang dapat ditagih dari pay-by-feature. Untuk informasi lebih lanjut, lihat Titik Akhir. Titik akhir VPC: Jika Anda menggunakan layanan Alibaba Cloud lain yang berada di wilayah yang sama dengan proyek Layanan Log Sederhana Anda untuk mengakses Layanan Log Sederhana, kami sarankan Anda menggunakan titik akhir VPC. Untuk informasi lebih lanjut, lihat Titik Akhir. Percepatan titik akhir: Jika server Anda dan Layanan Log Sederhana berada di wilayah yang berbeda, seperti di dalam dan luar Tiongkok, latensi jaringan tinggi dan transmisi tidak stabil ketika data ditransmisikan melalui Internet. Dalam hal ini, Anda dapat menggunakan titik akhir percepatan. Untuk informasi lebih lanjut, lihat Gunakan fitur percepatan transfer.	`cn-hangzhou.log.aliyuncs.com`
accessKeyId	String	Ya	Nilai parameter AccessKeyId di bawah parameter Credentials yang dikembalikan oleh operasi AssumeRole jika Anda menggunakan STS untuk mengonfigurasi kredensial akses.	LTAI****************
accessKeySecret	String	Ya	Nilai parameter AccessKeySecret di bawah parameter Credentials yang dikembalikan oleh operasi AssumeRole jika Anda menggunakan STS untuk mengonfigurasi kredensial akses.	yourAccessKeySecret

Kode contoh

package com.test.controller;

import com.aliyun.openservices.log.Client;

public class Sample {

    public static void main(String[] args) throws Exception {
        // Tentukan titik akhir Layanan Log Sederhana. Dalam contoh ini, titik akhir Layanan Log Sederhana untuk wilayah China (Beijing) digunakan. Ganti nilai parameter dengan titik akhir yang sebenarnya.
        String endpoint = "cn-beijing.log.aliyuncs.com";
        // Dalam contoh ini, dapatkan nilai parameter AccessKeyId di bawah parameter Credentials yang dikembalikan oleh operasi AssumeRole.
        String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
        // Dalam contoh ini, dapatkan nilai parameter AccessKeySecret di bawah parameter Credentials yang dikembalikan oleh operasi AssumeRole.
        String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
        // Dalam contoh ini, dapatkan nilai parameter SecurityToken di bawah parameter Credentials yang dikembalikan oleh operasi AssumeRole.
        String securityToken = System.getenv("ALIBABA_CLOUD_STS_TOKEN");
        Client client = new Client(endpoint, accessKeyId, accessKeySecret);
        client.setSecurityToken(securityToken);
    }
}

Referensi

Setelah menginisialisasi instance Client, Anda dapat menggunakan Simple Log Service SDK untuk Java untuk membuat Proyek dan menulis log. Untuk informasi lebih lanjut, lihat Memulai dengan Simple Log Service SDK untuk Java.