Proyek merupakan unit dasar manajemen sumber daya dalam Simple Log Service (SLS) yang digunakan untuk isolasi sumber daya dan kontrol akses.
Latar Belakang
Sebuah proyek dapat berisi sumber daya seperti logstore, metricstore, dan kelompok mesin, serta berfungsi sebagai titik masuk untuk mengakses sumber daya SLS. Gunakan proyek yang berbeda untuk mengelola data dari aplikasi, produk, atau lingkungan yang berbeda karena alasan berikut:
Mengatur dan mengelola logstore atau metricstore yang berbeda: Gunakan proyek untuk mengklasifikasikan dan mengelola log dari aplikasi, produk, atau lingkungan yang berbeda. Hal ini menyederhanakan tugas konsumsi data, ekspor, dan analisis.
Mengisolasi kontrol akses: Berikan izin kepada pengguna Resource Access Management (RAM) untuk melakukan operasi pada proyek tertentu.
Titik akhir spesifik proyek: Setiap proyek memiliki titik akhir unik yang berfungsi sebagai titik masuk jaringan untuk menulis, membaca, dan mengelola sumber dayanya. Untuk informasi selengkapnya tentang titik akhir, lihat Service endpoints.
Buat proyek
Buat proyek untuk mengelola semua log dan sumber log terkait untuk suatu aplikasi.
Konsol
Login ke Simple Log Service console, navigasikan ke bagian Projects, lalu klik Create Project.
Konfigurasikan proyek.
Region: Pilih wilayah Alibaba Cloud berdasarkan lokasi sumber log Anda dan faktor lainnya. Setelah proyek dibuat, wilayahnya tidak dapat diubah. SLS tidak mendukung migrasi proyek cross-region. Jika Anda ingin mengumpulkan log dari instance ECS, pilih wilayah yang sama dengan instance ECS tersebut. Hal ini memungkinkan Anda mengumpulkan log melalui jaringan internal Alibaba Cloud dan mempercepat pengumpulan log.
Project Name: Nama proyek. Nama harus unik secara global dalam Alibaba Cloud. Setelah proyek dibuat, namanya tidak dapat diubah.
Biarkan parameter lain pada nilai default-nya.
API
Identifikasi sumber proyek
SLS dapat secara otomatis membuat proyek saat dikaitkan dengan layanan cloud lainnya. Jika Anda memiliki banyak proyek, Anda dapat melacak sumbernya untuk menemukan informasi seperti origin, data yang disimpan, dan biayanya.
Login ke Simple Log Service console dan temukan proyek target dalam daftar proyek.
Periksa ikon di sebelah nama proyek atau lihat kolom Description untuk mengidentifikasi sumber proyek:
Jika ikon muncul sebelum nama proyek, arahkan kursor ke ikon tersebut. Nama layanan cloud terkait akan ditampilkan.
Jika kolom Description berisi informasi, informasi tersebut menjelaskan sumber proyek.
Jika kedua kondisi tersebut tidak terpenuhi, proyek tersebut dibuat secara manual.
Setelah Anda mengidentifikasi layanan cloud yang terkait dengan proyek tersebut, lihat Collection of Alibaba Cloud service logs untuk informasi selengkapnya, seperti data yang disimpan.
Jika layanan cloud terkait masih digunakan, jangan hapus proyek yang dibuat secara otomatis.
Untuk menganalisis dan memperkirakan penggunaan sumber daya dan penagihan proyek, lihat Use CloudLens for SLS to analyze resource usage.
Aktifkan perlindungan penghapusan proyek
Aktifkan fitur recycle bin untuk proyek yang berisi data penting guna mencegah penghapusan tidak disengaja. Saat fitur ini diaktifkan, proyek yang dihapus akan dipindahkan ke recycle bin. Proyek dalam recycle bin bersifat inactive dan tidak mendukung operasi baca atau tulis. Jika Anda kemudian memutuskan bahwa proyek yang dihapus masih diperlukan, segera pulihkan dari recycle bin. Anda hanya dikenai biaya untuk penyimpanan data proyek dalam recycle bin.
Proyek disimpan dalam recycle bin selama 7 hari secara default dan dihapus secara otomatis setelah periode retensi berakhir.
Konsol
Aktifkan fitur recycle bin
Login ke Simple Log Service console. Di bagian Projects, klik nama proyek target.
Di bagian Basic Information pada halaman Project Overview, aktifkan Recycle Bin.
API
Ubah parameter recycleBinEnabled dalam operasi UpdateProject.
Hapus dan pulihkan sumber daya proyek
Saat Anda menghapus proyek, data dalam logstore-nya akan dihapus secara permanen. Sebelum menghapus proyek, pastikan data dalam sumber daya seperti logstore, metricstore, dan eventstore tidak lagi diperlukan atau telah dibackup.
Anda dikenai biaya untuk penyimpanan dan sumber daya lainnya pada hari penghapusan proyek. Untuk informasi selengkapnya tentang cara menghentikan penagihan, lihat How do I disable SLS and stop billing?. Penagihan untuk SLS berhenti pada hari ketiga setelah Anda menghapus proyek.
Konsol
Bersihkan sumber daya sebelum penghapusan
Tidak ada keterkaitan layanan:
Saat Anda mengaktifkan fitur analisis log untuk layanan Alibaba Cloud seperti komputasi elastis, penyimpanan, keamanan, dan database, proyek dan logstore yang sesuai akan dibuat secara otomatis di konsol SLS. Jika Anda tidak lagi memerlukan log dari layanan Alibaba Cloud tertentu, Anda harus menonaktifkan fitur analisis log untuk layanan tersebut di konsol layanan tersebut. Pastikan proyek tidak terkait dengan layanan Alibaba Cloud lainnya.
Tidak ada ketergantungan penagihan: Pastikan semua sumber daya berbayar terkait, seperti storage plan atau kapasitas yang disediakan, telah dilepas atau dibatalkan langgannya.
Langkah-langkah menghapus proyek
Backup data penting (Opsional)
Backup data logstore: Jika proyek berisi data log yang perlu Anda simpan, Anda harus mengekspor data terlebih dahulu menggunakan fitur Download logs.
Backup informasi konfigurasi: Catat konfigurasi utama, seperti nama proyek, kapasitas penyimpanan, dan pengaturan kontrol akses, untuk mencegah kehilangan informasi setelah penghapusan.
Hapus proyek
Di daftar proyek, temukan proyek yang ingin Anda hapus dan klik Delete di kolom Actions.
Di kotak dialog Delete Project, masukkan nama proyek, pilih alasan penghapusan, lalu klik OK.
PeringatanSetelah proyek dihapus, semua data log dan informasi konfigurasi dalam proyek tersebut akan dihapus dan tidak dapat dipulihkan. Lakukan dengan hati-hati untuk mencegah kehilangan data.
Jika fitur recycle bin diaktifkan untuk proyek, temukan proyek yang dihapus di tab Recycle Bin Projects dalam daftar proyek. Secara default, proyek disimpan dalam recycle bin selama 7 hari, di mana Anda dapat memulihkan atau menghapusnya secara permanen.
API
Kelola kuota sumber daya
Jika kuota sumber daya Anda tidak mencukupi, ajukan peningkatan kuota untuk berbagai metrik proyek, seperti jumlah maksimum logstore, shard, konfigurasi Logtail, dan kelompok mesin.
Anda dapat membuat maksimal 150 proyek di bawah satu Akun Alibaba Cloud. Untuk meminta kuota yang lebih tinggi, submit a ticket untuk mengajukan peningkatan.
Konsol
Login ke Simple Log Service console. Di bagian Projects, klik nama proyek target.
Di bagian Basic Information pada halaman Project Overview, temukan Resource Quotas dan klik Manage. Di panel Resource Quotas, sesuaikan kuota untuk sumber daya yang diinginkan lalu klik Save untuk mengirimkan permohonan. Modifikasi akan berlaku dalam waktu sekitar satu jam.
Percepat transfer log cross-region
Untuk transfer log jarak jauh, seperti dari wilayah luar daratan Tiongkok ke wilayah dalam daratan Tiongkok, aktifkan fitur akselerasi transfer. Fitur ini memanfaatkan jaringan global pusat data dan routing cerdas untuk mengarahkan permintaan ke titik akses SLS terdekat, secara signifikan meningkatkan kecepatan transfer melalui jalur jaringan dan protokol yang dioptimalkan. Anda dikenai biaya untuk akselerasi transfer berdasarkan jumlah data yang ditransfer.
Konsol
Aktifkan akselerasi transfer
Login ke Simple Log Service console. Di bagian Projects, klik nama proyek target.
Di bagian Endpoint pada halaman Project Overview, temukan Acceleration Endpoint dan klik Enable. Baca pesan dalam kotak dialog lalu klik Modify.
Setelah Anda mengaktifkan akselerasi transfer, kecepatan transmisi meningkat saat Anda menggunakan Logtail untuk mengumpulkan log atau menjalankan pekerjaan transformasi data.
API
Pertama, panggil operasi PutProjectTransferAcceleration.
Untuk menggunakan fitur ini, Anda harus mengatur parameter
endpointke titik akhir percepatan. Titik akhir percepatan hanya mendukung akses API melalui HTTP dan HTTPS. Titik akhir ini tidak mendukung protokol lain seperti Kafka atau gRPC. Dalam skenario di mana akselerasi transfer tidak diperlukan, gunakan endpoints untuk mengurangi biaya transmisi./** * Contoh ini memperoleh ID AccessKey dan Rahasia AccessKey dari variabel lingkungan. */String accessId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"); String accessKey = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"); /** * Titik akhir layanan SLS. Gunakan titik akhir percepatan. */String endpoint = "log-global.aliyuncs.com"; /** * Buat klien SLS. */static Client client = new Client(host, accessId, accessKey);
Kelola resource group
Untuk mengelompokkan proyek, gunakan tag atau resource group. Perbedaan utamanya terletak pada cakupan pengelompokan. Tag digunakan untuk pengelompokan dan manajemen di tingkat proyek. Resource group menyediakan mekanisme untuk mengelola sumber daya di tingkat Akun Alibaba Cloud.
Atur resource group
Satu proyek hanya dapat dimiliki oleh satu resource group.
Konsol
Login ke Simple Log Service console. Di bagian Projects, klik nama proyek target.
Di bagian Resource Group Details pada halaman Project Overview, arahkan kursor ke ID resource group, klik Modify, lalu pilih resource group baru.
API
Atur tag
Konsol
Login ke Simple Log Service console. Di bagian Projects, klik nama proyek target.
Di bagian Tag pada halaman Project Overview, klik Edit, lalu konfigurasikan tag.
API
Lihat nama domain dan konfigurasikan nama domain kustom
Lihat informasi nama domain atau ganti nama domain publik dengan nama domain kustom. Setelah Anda mengonfigurasi nama domain kustom, gunakan sebagai titik akhir dalam pemanggilan API.
Konsol
Login ke Simple Log Service console. Di bagian Projects, klik nama proyek target.
Di bagian Endpoint pada halaman Project Overview, lihat informasi domain untuk proyek saat ini.
Di bagian Basic Information pada halaman Project Overview, arahkan kursor ke Custom Domain dan klik Modify. Di panel Specify Custom Endpoint, masukkan nama domain lalu klik Bind. Untuk informasi selengkapnya, lihat Register a domain name.
Di Alibaba Cloud DNS console, buat Rekaman CNAME untuk mengarahkan domain kustom Anda ke titik akhir publik. Atur Record Value ke Public Endpoint yang tercatat di halaman Project Overview SLS. Untuk informasi selengkapnya, lihat CNAME record.
API
Monitor sumber daya proyek
Gunakan fitur log layanan untuk memperoleh berbagai jenis log, termasuk operation log untuk tindakan seperti membuat, memodifikasi, memperbarui, dan menghapus. Fitur ini juga menyediakan task execution log untuk pekerjaan seperti SQL terjadwal, impor data, dan pengiriman data, serta log latensi konsumsi untuk kelompok konsumen dalam logstore dan log error, heartbeat, serta statistik untuk Logtail.
Konsol
Login ke Simple Log Service console. Di bagian Projects, klik nama proyek target.
Di halaman Service Log proyek, klik Enable Detailed Logs. Di panel Modify Service Log Settings, pilih log layanan yang akan diaktifkan dan proyek tujuan.
Detailed Logs: Menyediakan operation log lengkap. Ini adalah fitur pay-as-you-go.
Important Logs: Menyediakan metering logs, consumer group latency logs, dan Logtail heartbeat logs. Fitur ini gratis.
Job Operational Logs: Menyediakan execution logs dari pekerjaan impor data, SQL terjadwal, dan pengiriman data. Fitur ini gratis.
Log Storage Location: Pilih proyek yang sudah ada atau biarkan SLS membuat proyek baru secara otomatis untuk menyimpan log ini.
Referensi
Untuk menyimpan berbagai jenis data dalam proyek, Anda harus membuat berbagai jenis store. Untuk informasi selengkapnya, lihat Manage stores.