配置DNA中心中的Kibana以實現日誌視覺化

簡介

本文檔介紹如何使用Kibana在不同的Cisco DNA Center服務中搜尋特定日誌。

必要條件

需求

您還必須具有管理員角色的GUI才能訪問Cisco DNA Center。您必須熟悉Cisco DNA Center服務的名稱和用途。

採用元件

本文中的資訊是根據特定實驗室環境內的裝置所建立。文中使用到的所有裝置皆從已清除（預設）的組態來啟動。如果您的網路運作中，請確保您瞭解任何指令可能造成的影響。

背景資訊

  

Kibana是Elasticsearch的開源資料視覺化外掛。在Cisco DNA Center中可用的Elasticsearch群集上索引的內容之上，它提供了視覺化功能。

您可以通過兩種方式訪問Kibana:

• https://<Cisco DNA Center ip>/kibana
• 主選單>系統>系統360 ->群集工具 — >日誌資源管理器

預設Kibana網頁

配置Kibana以實現日誌視覺化

導航到左欄選單，然後點選Discover:

Kibana有多個欄位，這些欄位在下一張圖中突出顯示：

在Kibana中新增欄位

導航到Filters > Available欄位

必須為日誌視覺化新增以下欄位：

• Kubernetes.labels.serviceName -顯示特定日誌的服務
• Log — 日誌的原始內容

點選add按鈕

確保您具有下一個配置：

在Kibana中新增和編輯篩選器

要新增過濾器，請執行以下活動：

• 按一下Add篩選器
• 欄位選擇：Kubernetes.labels.serviceName
• 運算子選擇：是
• 價值：選擇您感興趣的服務
• 按一下Save按鈕

請看下一個示例，其中所選服務是apic-em-inventory-manager-service:

您可以根據需要新增更多過濾器。

下一個示例新增了一個新篩選器，其中Field:log、operator:is和Value: error:

從特定日期獲取日誌

可以將時間元素新增到搜尋條件中。 

使用「時間範圍」(Time Range)欄位中的下一個選項之一：

• 絕對 — 從特定日期到另一個特定日期。 
• 相對 — 從過去X分鐘、小時、天或周到特定日期。
• Now — 將時間設定為「現在」意味著每次刷新時，此時間將設定為刷新時間。

使用Lucene的使用案例

Lucene是一個高效能、全功能的文本搜尋引擎庫。這項技術幾乎適用於任何需要全文搜尋的應用。

導航到搜尋欄並禁用KQL以啟用Lucene:

獲取特定服務的日誌

在篩選欄中鍵入下一個查詢，然後按刷新按鈕

kubernetes.labels.serviceName:<service-name>

請看下一個task-service示例：

kubernetes.labels.serviceName:task-service

獲取包含特定詞的日誌

提示：指示問題的最常見日誌條目包含「 Error 」、「 Failed 」和「 Exception 」，但您可以將該字串修改為任何其他可以指導您進行故障排除的常見字串。

在篩選欄中鍵入下一個查詢，然後按刷新按鈕

log:error

混合併匹配您的搜尋

通過在字串之間使用AND（或&&），可以搜尋與字串組合匹配的條目。

log:error AND kubernetes.labels.serviceName:onboarding-service

注意：並非所有欄位均可搜尋。

如果您希望在「可用欄位」窗格中只看到可搜尋的欄位，請選擇該齒輪，然後自定義檢視。還可以定義要使用的搜尋型別，例如，字串、布林值、數字等。

同時搜尋兩個不同的服務以查詢錯誤

在搜尋條件中包括兩個或多個服務。確保服務名稱在括弧中輸入，並用OR分隔它們。

log:error && (kubernetes.labels.serviceName:onboarding-service OR kubernetes.labels.serviceName:telemetry-agent)

參考

• 彈性搜尋常用選項
• Apache Lucene — 查詢分析器語法