Container Service for Kubernetes:Simple Log Service の設定

仕組み

ワークフロークラスターを作成すると、システムは k8s-log-<clusterid> という名前の SLS プロジェクトを作成します。すべての Pod ログは、workflow-logstore という名前の Logstore に収集されます。

有効化すると、Pod が実行中かどうかに関わらず、Argo CLI、Argo Server、または Argo UI からログを表示できます。

制限事項

• oss-artifact-repository と比較して、SLS は設定可能なログの保持日数によるログの自動ライフサイクル管理と強力なクエリ機能を提供します。SLS を使用してログを収集するには、archiveLogs: true の設定を削除してください。

• ログ収集を有効にすると、Pod が削除された後でも、ワークフローが削除される前であればワークフローログを表示できます。

• ワークフローがデータベースに永続化されている場合、ワークフローが削除された後でも、ログを ZIP ファイルとしてダウンロードするか、SLS コンソールで表示できます。詳細については、「ワークフローの永続化」をご参照ください。

SLS の有効化

k8s-log-<clusterid> プロジェクトが自動的に作成されなかった場合は、手動で作成してください。詳細については、「SLS プロジェクトの作成」をご参照ください。

次のいずれかの方法を選択してください。

argo config sls
Please input log retention days. Default is 7 days.
10

Start to config SLS for your cluster.
Created AliyunLogConfig CR workflow-sls-config in default namespace.
Created SLS logstore workflow-logstore in SLS project k8s-log-<clusterid>, log retention days is 10 days

cat << EOF | kubectl apply -f -
apiVersion: log.alibabacloud.com/v1alpha1
kind: AliyunLogConfig
metadata:
  name: workflow-sls-config
  namespace: default
spec:
  lifeCycle: 5           # ログの保持期間 (日数)
  logstore: workflow-logstore
  logtailConfig:
    configName: workflow-sls-config
    inputType: plugin    # プラグインベースの入力方式を使用
    inputDetail:
      plugin:
        inputs:
        - type: service_docker_stdout  # コンテナの標準出力と標準エラー出力を収集
          detail:
            Stdout: true
            Stderr: true
EOF

ログ収集の検証

SLS を有効にした後、ログが収集されていることを確認します。

1. SLS コンソールにログインします。

2. k8s-log-<clusterid> プロジェクトを検索します。

3. [workflow-logstore] をクリックし、ログエントリが表示されることを確認します。

ログが表示されない場合は、AliyunLogConfig カスタムリソースが作成されているかどうかを確認してください。

kubectl get aliyunlogconfigs -n default

出力には、エラーステータスのない workflow-sls-config が含まれている必要があります。存在しない場合やエラーがある場合は、有効化手順を再実行するか、RAM ユーザーの権限を確認してください。

Argo CLI を使用したログへのアクセス

Argo CLI には、ワークフローログを表示する 2 つの方法があります。Argo Server を必要としないため、直接的な方法 (--sls フラグ) を推奨します。

kubectl logs <pod-name> を実行して既存の Pod のログを表示できますが、このコマンドはデフォルトで最大 2,000 行を返します。より多くのログや、削除された Pod のログを表示するには、次のいずれかの方法を使用してください。

データベースに永続化されたワークフローのログの表示

ワークフローがデータベースに永続化されている場合、ワークフローが削除された後でもログをダウンロードできます。

1. Argo CLI がクラスターにアクセスできるように設定します。

   argo config init  # プロンプトに従って、AccessKey ID と AccessKey Secret を入力します。

2. アーカイブされたワークフローの UID を取得します。

   argo archive list

   期待される出力：

   NAMESPACE   NAME                   STATUS      AGE   DURATION   PRIORITY   MESSAGE   P/R/C   PARAMETERS   UID
   default     hello-world-l6c2r      Succeeded   3d    1m         0                    0/0/0                179eaef0-fde3-496f-946d-549e8f******

3. UID を使用してワークフローログをダウンロードします。

   argo archive logs 179eaef0-fde3-496f-946d-549e8f******

   ログは、現在のディレクトリに <workflow-name>.zip として保存されます。

Argo UI でのログの表示

Argo UI は、ワークフロー Pod のログを直接表示します。Pod が削除された場合、リアルタイムの Pod 出力の代わりに SLS ログが表示されます。

SLS の無効化

1. AliyunLogConfig カスタムリソースを削除します。

   kubectl delete aliyunlogconfigs.log.alibabacloud.com workflow-sls-config -n default

2. SLS コンソールにログインし、workflow-logstore Logstore を削除します。

次のステップ

• ワークフローの永続化 — ワークフローの状態をデータベースに保存し、削除後もログと結果を保持します。

• Alibaba Cloud Argo CLI — CLI をダウンロードして設定し、すべてのログにアクセスできるようにします。