633      iPhone_iPad_Mac_手機_平板_蘋果apple

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

日誌庫（Logstore）是日誌服務中的日誌存儲和查詢單元，通常用於存儲一類日誌數據。

• 無論是寫入或者查詢日誌，用戶都需要指定操作的日誌庫。
• 如果用戶希望投遞日誌數據到ODPS做離線分析，其數據投遞也是以Logstore為單元進行數據同步（即一個Logstore內的日誌數據投遞到一張ODPS的Table）。

具體來說，Logstore提供如下功能：

• 收集日誌，支持實時日誌寫入。
• 存儲日誌，支持實時消費。
• 建立索引，支持日誌實時查詢。
• 提供投遞到ODPS的數據通道。

本章接下來將詳細解釋如何操作和使用Logstore。

創建Logstore

目前，日誌服務支持在控製台或者通過API創建Logstore。你可以參考日誌庫操作了解如何在控製上創建一個Logstore，使用API創建Logstore請參考CreateLogstore。在創建Logstore時需要注意如下幾點：

1. 任何一個Logstore必須在某一個Project下創建，且一個Project下最多可以創建100個Logstore。
2. Logstore名字隻能包括小寫字母，數字，短橫線（-）和下劃線（_），必須以小寫字母或者數字開頭和結尾，長度必須在3-63字節以內。且Logstore名稱在其所屬項目內必須唯一。
3. Logstore目前支持“日誌消費”，“日誌投遞”和“日誌索引”三種消費模式，其中“日誌消費”消費模式是默認打開的，且用戶無法禁用該模式。

向Logstore寫入日誌

在創建完Logstore之後，用戶就可以使用LogHub采集功能向Logstore寫入日誌。目前，日誌服務支持通過API或者SDK來寫入日誌數據。如果用戶希望收集阿裏雲ECS服務器的數據，日誌服務提供的Logtail日誌收集可以幫助用戶非常方便的收集到日誌數據。

正如核心概念章節所述，日誌服務的日誌數據模型為一個半結構化格式。用戶需要按照日誌數據模型組織日誌數據，然後寫入指定的Logstore。

消費Logstore中的日誌

如前麵所述，“日誌消費”消費模式是默認開啟的，因此用戶可以實時通過指定遊標（Cursor）和分區（shard）大批量消費日誌數據。你可以通過日誌服務的API或者SDK查詢Logstore中的日誌。同時，日誌服務控製台也提供了日誌預覽界麵，直觀顯示日誌內容等。具體請參考日誌消費預覽。

關鍵詞查詢Logstore中的日誌

在啟動“日誌索引”消費模式後，用戶的每條寫入日誌都會被日誌服務端建立索引。因此，用戶得以在海量日誌數據上完成近實時的日誌查詢操作。日誌服務提供靈活的查詢語法讓用戶可以方便、快速的檢索出感興趣的日誌數據。

Logstore下二級分類：主題(Topic)

為了幫助用戶在“日誌索引”模式內更好組織日誌，日誌服務支持日誌主題（Topic）。用戶在寫入日誌的時候可以指定該日誌所屬Topic。在寫入後即可以限製在一個Topic內進行查詢。

每個logstore根據topic可以劃分成一個或多個子空間，當進行查詢時，指定topic可以限定查詢範圍，達到更快速度。因此我們推薦對logstore有二級分類需求的用戶用戶使用topic進行劃分。

當指定一個或多個topic進行查詢時，僅從符合條件的topic中進行查詢。但不輸入topic，默認查詢所有topic下的數據。

你可以通過日誌服務的API或者SDK查詢Logstore中的日誌。同時，日誌服務控製台也提供了強大的日誌查詢頁麵幫助用戶查詢日誌，直觀顯示查詢結果等。具體請參考日誌查詢。

刪除Logstore

在某些情況下（如希望廢棄某個Logstore），用戶可能需要刪除指定Logstore。日誌服務允許用戶在控製台上刪除Logstore。一旦Logstore刪除，其存儲的日誌數據將會被永久丟失，不可恢複。如果該Logstore上還啟用了“日誌投遞”的消費模式，則不保證刪除前Logstore裏的所有數據都會成功投遞到ODPS中。如果用戶需要保證被刪除的Logstore內所有數據都能投遞到ODPS，請按照如下流程操作：

1. 刪除前先停止向該Logstore寫入新日誌。
2. 確認Logstore裏的所有日誌數據都成功導入到ODPS。
3. 刪除Logstore。

同樣，日誌庫操作提供控製台刪除Logstore的具體操作方式。

最後更新：2016-12-12 23:21:15

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

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