您可以將OSS Bucket中的記錄檔,通過資料匯入方式匯入到Log Service,實現日誌的查詢分析、加工等操作。目前Log Service只支援匯入5 GB以內的OSS檔案,壓縮檔大小按照壓縮後的大小計算。
費用說明
Log Service不針對匯入功能收取費用,但匯入功能需要訪問OSS API,會產生OSS的流量費用和請求費用。相關計費項目的定價詳情,請參見OSS定價。匯入OSS資料時,每天產生的OSS費用的計算公式如下:
前提條件
已上傳記錄檔到OSS Bucket中。具體操作,請參見控制台上傳檔案。
已建立Project和Logstore。具體操作,請參見建立專案Project和建立Logstore。
已經完成雲資源訪問授權,即已授權Log Service使用AliyunLogImportOSSRole角色訪問您的OSS資源。
帳號具有oss:ListBuckets許可權,用於訪問oss bucket資源。具體操作,請參見為RAM使用者授權自訂的權限原則。
如果您使用的是RAM使用者,還需授予RAM使用者PassRole許可權,授權策略如下所示。具體操作,請參見建立自訂權限原則和為RAM使用者授權。
{ "Statement": [ { "Effect": "Allow", "Action": "ram:PassRole", "Resource": "acs:ram:*:*:role/aliyunlogimportossrole" }, { "Effect": "Allow", "Action": "oss:GetBucketWebsite", "Resource": "*" }, { "Effect": "Allow", "Action": "oss:ListBuckets", "Resource": "*" } ], "Version": "1" }
建立資料匯入配置
針對更新過的OSS檔案,資料匯入任務會重新進行全量匯入。即之前已匯入過的檔案,又追加了部分內容,那麼這個檔案中資料將再次被全部匯入。
在接入資料地區的資料匯入頁簽中,選擇OSS-資料匯入。
選擇目標Project和Logstore,單擊下一步。
設定匯入配置。
在匯入配置步驟中,設定如下參數。
單擊預覽,預覽匯入結果。
確認無誤後,單擊下一步。
建立索引和預覽資料,然後單擊下一步。Log Service預設開啟全文索引。您也可以根據採集到的日誌,手動建立欄位索引,或者單擊自動產生索引,Log Service將自動產生欄位索引。更多資訊,請參見建立索引。
重要如果需要查詢日誌中的所有欄位,建議使用全文索引。如果只需查詢部分欄位、建議使用欄位索引,減少索引流量。如果需要對欄位進行分析(SELECT語句),必須建立欄位索引。
單擊查詢日誌,進入查詢和分析頁面,確認是否成功匯入OSS資料。
等待1分鐘左右,如果有目標OSS資料匯入,則說明匯入成功。
相關操作
建立匯入配置成功後,您可以在控制台中查看已建立的匯入配置及產生的統計報表。
在Project列表地區,單擊目標Project。
在 中,選擇目標日誌庫下的 ,單擊配置名稱。
查看任務
在匯入配置概覽頁面,查看匯入配置的基本資料和統計報表。
修改任務
單擊修改配置,修改匯入配置的相關資訊。更多資訊,請參見設定匯入配置。
刪除任務
單擊刪除配置,刪除該匯入配置。
警告刪除後不可恢複,請謹慎操作。
停止任務
單擊停止,停止該匯入任務。
常見問題
問題 | 可能原因 | 解決方案 |
預覽時顯示無資料。 | OSS Bucket中沒有檔案、檔案中沒有資料或者沒有符合過濾條件的檔案。 |
|
資料中存在亂碼。 | 資料格式、壓縮格式或編碼格式配置不符合預期。 | 確認OSS檔案的真實格式,然後調整資料格式、壓縮格式或編碼格式等配置項。 如果需要修複已有的亂碼資料,請建立新的Logstore和匯入配置。 |
Log Service中顯示的資料時間和資料本身的時間不一致。 | 設定匯入配置時,沒有指定日誌時間欄位或者設定時間格式、時區有誤。 | 設定指定的日誌時間欄位以及正確的時間格式和時區。更多資訊,請參見建立資料匯入配置。 |
匯入資料後,無法查詢和分析資料。 |
| |
匯入的資料條目數量少於預期。 | 部分檔案存在單行資料大小超過3 MB的資料,導致資料在匯入處理程序被丟棄。更多資訊,請參見採集限制。 | 寫入資料到OSS檔案時,避免單行資料大小超過3 MB。 |
檔案數量和總資料量都很大,但匯入資料的速度不及預期(正常情況下,可達到80 MB/s)。 | Logstore Shard數量過少。更多資訊,請參見效能限制。 | Logstore Shard數量較少時,請嘗試增加Shard的個數(10個及以上),並觀察延遲情況。具體操作,請參見管理Shard。 |
建立匯入配置時,無法選擇OSS Bucket。 | 未完成AliyunLogImportOSSRole角色授權。 | 參見文本中的前提條件完成授權。 |
部分檔案沒有匯入。 | 過濾條件設定存在問題或者存在單個檔案大小超出5 GB的檔案。更多資訊,請參見採集限制。 |
|
歸檔檔案沒有匯入。 | 未開啟匯入歸檔檔案開關。更多資訊,請參見採集限制。 |
|
多行文本日誌解析錯誤。 | 首行Regex或尾行Regex設定錯誤。 | 檢查首行Regex或尾行Regex的正確性。 |
新檔案匯入延遲大。 | 存量檔案太多(即符合檔案路徑首碼過濾的檔案數量太多) 且匯入配置中沒有開啟使用OSS中繼資料索引開關。 | 如果符合檔案路徑首碼過濾條件檔案數量太多(超過100萬),需要在匯入配置中開啟使用OSS中繼資料索引開關。否則,發現新檔案的效率非常低。 |
錯誤處理機制
錯誤項 | 說明 |
讀取檔案失敗 | 讀檔案時,如果遇到檔案不完整的錯誤(例如由網路異常、檔案損壞等導致),匯入任務會自動重試,重試3次後仍然讀取失敗,將跳過該檔案。 稍候再試和檢查新檔案周期一致。如果檢查新檔案周期為永不檢查,則重試周期為5分鐘。 |
壓縮格式解析錯誤 | 解壓檔案時,如果遇到檔案壓縮格式無效的錯誤,匯入任務將直接跳過該檔案。 |
資料格式解析錯誤 |
|
OSS Bucket不存在 | 匯入任務會定期重試,即重建Bucket後,匯入任務會自動回復匯入。 |
許可權錯誤 | 從OSS Bucket讀取資料或者寫資料到Log ServiceLogstore存在許可權錯誤時,匯入任務會定期重試,即修複許可權問題後,匯入任務會自動回復。 遇到許可權錯誤時,匯入任務不會跳過任何檔案,因此修複許可權問題後,匯入任務會自動將Bucket中還未被處理的檔案中的資料匯入到Log ServiceLogstore中。 |
OSS投遞介面
操作 | 介面 |
建立OSS匯入任務 | |
修改OSS匯入任務 | |
擷取OSS匯入任務 | |
刪除OSS匯入任務 | |
啟動OSS匯入任務 | |
停止OSS匯入任務 |