您可以將記錄從 vRealize Automation 轉送到 vRealize Log Insight，以充分利用更強大的記錄分析和報告產生功能。

vRealize Automation 與基於 fluentd 的記錄代理程式綁定。代理程式會收集並儲存記錄，以便將其包含在記錄服務包中並稍後進行檢查。您可以將代理程式設定為使用 vRealize Log Insight REST API 將記錄複本轉送到 vRealize Log Insight 伺服器。API 允許其他程式與 vRealize Log Insight 進行通訊。

如需有關 vRealize Log Insight 的詳細資訊，包括 vRealize Log Insight REST API 的說明文件，請參閱 vRealize Log Insight 說明文件。

將記錄代理程式設定為使用提供的 vracli 命令列公用程式，持續將 vRealize Automation 記錄轉送到 vRealize Log Insight。

所有記錄行會以主機名稱和環境標籤進行標記，並且可在 vRealize Log Insight 中進行檢查。在高可用性 (HA) 環境中，記錄會以不同的主機名稱進行標記，具體取決於其來源節點。如〈設定或更新 vRealize Log Insight 的整合〉一節中所述，環境標籤可使用 --environment ENV 選項進行設定。在 HA 環境中，無論其來源節點為何，環境標籤的所有記錄行都具有相同的值。

有關如何使用 vracli 命令列公用程式的資訊，可透過在 vracli 命令列中使用 --help 引數取得。例如：vracli vrli --help。若要獲得使用者易懂的回應，請在執行該命令時以 vracli -j vrli 開頭。

備註： 只能設定單一遠端記錄整合。如果 vRealize Log Insight 伺服器和 Syslog 伺服器同時可用，將優先使用 vRealize Log Insight。

檢查 vRealize Log Insight 的現有組態

Command

vracli vrli

Arguments

沒有命令列引數。

Output

vRealize Log Insight 整合的目前組態以 JSON 格式輸出。

Exit codes
以下是可能的結束代碼：
  • 0 - 已設定與 vRealize Log Insight 的整合。
  • 1 - 命令執行過程中發生例外狀況。如需詳細資料，請查看錯誤訊息。
  • 61 (ENODATA) - 未設定與 vRealize Log Insight 的整合。如需詳細資料，請查看錯誤訊息。
Example - check integration configuration 
$ vracli vrli
No vRLI integration configured
 
$ vracli vrli
{
    "agentId": "0",
    "environment": "prod",
    "host": "my-vrli.local",
    "port": 9543,
    "scheme": "https",
    "sslVerify": false
}

設定或更新 vRealize Log Insight 的整合

Command

vracli vrli set [options] FQDN_OR_URL

備註： 執行命令後，記錄代理程式最多可能需要 2 分鐘的時間才能套用您指定的組態。
Arguments
  • FQDN_OR_URL

    指定用於發佈記錄之 vRealize Log Insight 伺服器的 FQDN 或 URL 位址。預設使用連接埠 9543 和 https。若必須變更其中任何設定，您可以改為使用 URL。 

    vracli vrli set <options> https://FQDN:9543
    備註：
    您可以設定不同的主機配置 (預設值為 https) 和連接埠 (https 預設值為 9543，http 預設值為 9000) 以用於傳送記錄，如下列範例所示： 
    vracli vrli set https://HOSTNAME:9543
vracli vrli set --insecure HOSTNAME
vracli vrli set http://HOSTNAME:9000

    vRealize Log Insight 擷取 REST API 將會使用連接埠 9543 (對於 https) 和 9000 (對於 http)，如 vRealize Log Insight 說明文件之《管理 vRealize Log Insight》中的〈連接埠和外部介面〉主題所述。

  • 選項
    • --agent-id SOME_ID

      針對此應用裝置設定記錄代理程式的識別碼。預設值為 0。用於在使用 vRealize Log Insight REST API 將記錄發佈到 vRealize Log Insight 時識別代理程式。

    • --environment ENV

      設定目前環境的識別碼。將在 vRealize Log Insight 記錄中做為每個記錄項目的標籤提供。預設值為 prod。

    • --ca-file /path/to/server-ca.crt

      指定一個檔案，其中包含用來簽署 vRealize Log Insight 伺服器憑證之憑證授權機構 (CA) 的憑證。這會強制記錄代理程式信任指定的 CA，並讓它能夠驗證 vRealize Log Insight 伺服器的憑證 (如果該憑證由不受信任的授權機構簽署)。此檔案可包含整個憑證鏈結以驗證憑證。如果是自我簽署憑證，將傳遞憑證本身。

    • --ca-cert CA_CERT

      與上述 --ca-file 的定義相同，但以字串形式內嵌傳遞憑證 (鏈結)。

    • --insecure

      停用伺服器憑證的 SSL 驗證。這會強制記錄代理程式在發佈記錄時接受任何 SSL 憑證。

  • 進階選項
    • --request-max-size BYTES

      透過單一 API 呼叫擷取多個記錄事件。此引數將控制每個請求的裝載大小上限 (以位元組為單位)。有效值介於 4000 到 4000000 之間。預設值為 256000。如需允許值的相關資訊，請參閱 vRealize Log Insight REST API 說明文件中的 vRealize Log Insight 事件擷取。將此值設定得過低可能會導致捨棄超過允許大小的記錄事件。

    • --request-timeout SECONDS

      對 API 的呼叫可能會因多種原因而懸置，包括遠端問題、網路問題等。此參數可控制將呼叫視為失敗之前等待每項作業 (例如開啟連線、寫入資料或等待回應) 完成的秒數。該值不能少於 1 秒。預設值為 30。

    • --request-immediate-retries RETRIES

      將記錄傳送至 vRealize Log Insight 之前，這些記錄會按彙總區塊形式進行緩衝 (請參閱下方的 --buffer-flush-thread-count)。如果 API 要求失敗，會立即重試記錄。立即重試的預設次數為 3。如果重試均未成功，則會復原整個記錄區塊，並稍後重試。

    • --request-http-compress

      若要降低網路流量，可以將 gzip 壓縮套用到傳送至 vRealize Log Insight 伺服器的請求。如果未指定此參數，則不使用壓縮。

    • --buffer-flush-thread-count THREADS

      為了獲得更佳效能並限制網路流量，記錄會以區塊形式在本機進行緩衝，然後再將其排清並傳送至記錄伺服器。每個區塊包含單一服務中的記錄。區塊可能會變得很大，並且排清很費時間，具體取決於您的環境。此引數將控制可同時排清的區塊數目。預設值為 2。

備註：

透過 https 設定整合時，如果 vRealize Log Insight 伺服器設定為使用不受信任的憑證 (例如，自我簽署憑證) 或由不受信任的授權機構所簽署的憑證，則必須使用 --ca-file、--ca-cert 或 --insecure 選項之一，否則，記錄代理程式無法驗證伺服器身分識別，也不會傳送記錄。使用 --ca-file 或 --ca-cert 時，vRealize Log Insight 伺服器憑證必須對伺服器的主機名稱有效。在所有情況下，透過以下方法驗證整合：允許花幾分鐘時間進行處理，然後確認 vRealize Log Insight 是否收到記錄。

Output

預期沒有輸出。

Exit codes
以下是可能的結束代碼：
  • 0 - 組態已更新。
  • 1 - 執行過程中發生例外狀況。如需詳細資料，請查看錯誤訊息。
Examples - Configure or update integration configuration
以下範例陳述式顯示在單獨的命令列中，但引數可以在單一命令列中組合使用。例如，使用 vracli vrli set {somehost} 或 vracli vrli set --ca-file path/to/server-ca.crt 修改預設代理程式識別碼或環境值時，可以包含多個引數。如需相關資訊，請參閱線上命令說明： vracli vrli --help。 
$ vracli vrli set my-vrli.local 
$ vracli vrli set 10.20.30.40
$ vracli vrli set --ca-file /etc/ssl/certs/ca.crt 10.20.30.40
$ vracli vrli set --ca-cert "$(cat /etc/ssl/certs/ca.crt)" 10.20.30.40
$ vracli vrli set --insecure http://my-vrli.local:8080
$ vracli vrli set --agent-id my-vrli-agent my-vrli.local
$ vracli vrli set --request-http-compress
$ vracli vrli set --environment staging my-vrli.local
$ vracli vrli set --environment staging --request-max-size 10000 --request-timeout 120 --request-immediate-retries 5 --buffer-flush-thread-count 4 my-vrli.local

清除 vRealize Log Insight 的整合

Command

vracli vrli unset

備註： 執行命令後，記錄代理程式最多可能需要 2 分鐘的時間才能套用您指定的組態。
Arguments

沒有命令列引數。

Output

以純文字格式輸出確認。

Exit codes
以下是可用的結束代碼：
  • 0 - 組態已清除或不存在任何組態。
  • 1 - 執行過程中發生例外狀況。如需詳細資料，請查看錯誤訊息。
Examples - Clear integration 
$ vracli vrli unset
Clearing vRLI integration configuration
 
$ vracli vrli unset
No vRLI integration configured