442      小米MIX

項目（Project）__基礎概念_用戶指南_日誌服務-阿裏雲

項目（Project）是日誌服務中的資源管理單元。它管理著用戶的所有日誌庫（Logstore），采集日誌的機器配置等信息，同時它也是用戶訪問日誌服務資源的入口。具體來說，Project提供用戶如下功能：

• 幫助用戶組織、管理不同的Logstore。在實際使用中，用戶可能需要使用日誌服務集中收集、存儲不同項目、產品或者環境的日誌。用戶可以把不同項目、產品或者環境的日誌分類管理在不同的Project中，方便後續的日誌消費、導出或者索引。同時，Project還是日誌訪問權限管理的載體。
• 提供用戶日誌服務資源的訪問入口。每創建一個Project，日誌服務會為該Project分配一個獨有的訪問入口。該訪問入口支持通過網絡寫入、讀取及管理日誌。

本章接下來將詳細解釋如何操作和使用日誌服務Project。

創建項目

目前，日誌服務僅提供控製台方式創建Project。你可以參考項目操作了解如何使用控製台創建項目。在創建項目時需要注意如下幾點：

• Project的名字長度在3~63字節以內，隻能包括小寫字母、數字、短橫線(-)，必須以小寫字母或數字開頭和結尾。如果你選擇的Project名字不符合要求，係統會及時提醒。
• Project的名字全局唯一（所有阿裏雲Region內）。如果你選擇的Project名稱已經被別人使用，係統會及時提醒。
• Project創建時需要指定所在的阿裏雲Region。你需要根據需要收集的日誌來源和其他實際情況選擇合適的阿裏雲Region。如果你需要收集來自阿裏雲ECS虛擬機的日誌，建議在ECS虛擬機相同的Region創建Project。這樣既可以加快日誌收集速度，還可以使用阿裏雲內網（不占用ECS虛擬機公網帶寬）收集日誌。Project一旦創建完成則無法改變其所屬Region，且日誌服務目前也不支持Project的遷移，所以請謹慎選擇Project的所屬Region。

1. 一個用戶在所有阿裏雲Region總計最多可創建10個Project。

訪問項目

成功創建完Project後，日誌服務後端即給該Project分配了唯一的訪問入口。該訪問入口的格式如下：

<project_name>.<region_endpoint>

其中，<project_name>即為創建的Project名稱，而<region_endpoint>為Project所屬阿裏雲Region的日誌服務入口。目前已有多個阿裏雲Region已開通日誌服務（服務入口），現假設用戶在“華東 1 (杭州)”Region創建了名稱為’myslsproject’的Project，則該項目的訪問入口為：

myslsproject.cn-hangzhou.sls.aliyuncs.com

如果在阿裏雲的ECS機器內使用日誌服務API，還可以使用內網服務入口（使用內網服務入口訪問日誌服務不消耗ECS公網流量，可以節約寶貴的ECS公網帶寬），各個Region的日誌服務內網根服務入口。如上例，其內網訪問地址如下：

myslsproject.cn-hangzhou-intranet.sls.aliyuncs.com

在獲得該訪問入口後，用戶就可以通過日誌服務的API或者SDK來訪問該Project下麵的日誌庫、向具體日誌庫寫入日誌，消費日誌內容或者查詢日誌信息。同時，你也可以通過日誌服務的控製台列出Project下的所有日誌庫，創建日誌庫等。具體可以參考項目操作。

管理項目

如前所述，Project為日誌服務的資源管理單元，用戶可以通過Project來管理自己的各種日誌庫，需要采集日誌的機器。具體來說，用戶可以如下管理日誌服務的Project：

• 創建和刪除Project內的日誌庫（Logstore）。日誌庫為日誌服務內的日誌存儲單元，它用於存儲一類日誌。而一個用戶實際項目中可能需要收集的日誌類型可能有多種，如前端Web服務器的訪問日誌（access log），後端應用程序生成的應用日誌（application log）等。用戶則可以在Project創建獨立的日誌庫並把不同類型的日誌寫入不同的日誌庫。關於日誌庫的更多信息請參考管理日誌庫。
• 管理采集日誌的機器。 用戶的日誌會在各個不同的日誌源產生，其中最為常見的即為服務器。Project以“機器組（Machine Group）”的方式幫助用戶管理需要采集日誌的服務器。用戶可以在一個Project中創建和刪除機器組，同樣機器IP把需要采集的服務器歸類到相應的機器組中。一種常見的實踐就是讓需要寫入一個Logstore的所有日誌源（如所有前端Web服務器）加入到一個機器組進行管理。

目前，日誌服務僅提供控製台方式幫助用戶管理Project。你可以通過控製台完成如上所述的所有管理操作。具體可以參考項目操作。

刪除項目

在某些情況下（如關閉日誌服務，銷毀Project的所有日誌等），用戶可能需要刪除整個Project。日誌服務允許用戶在控製台上方便地刪除整個Project。當用戶的Project被刪除後，其管理的所有日誌數據及配置信息都會永久釋放，不可恢複。所以，在刪除Project前請仔細確認，避免數據丟失。具體如何在控製台刪除Project，請參考項目操作。

最後更新：2016-08-29 11:33:32

  上一篇： 核心概念__基礎概念_用戶指南_日誌服務-阿裏雲

  下一篇： 日誌庫（Logstore）__基礎概念_用戶指南_日誌服務-阿裏雲