すべてのプロダクト
Search
ドキュメントセンター

Simple Log Service:CR を使用して Logtail 構成を管理する

最終更新日:Jul 23, 2025

Simple Log Service は、カスタムリソースを作成するための CustomResourceDefinitions(CRD)を提供します。Logtail 構成のカスタムリソース(CR)を作成できます。このトピックでは、AliyunPipelineConfig CRD と AliyunLogConfig CRD の機能と相違点の概要について説明します。

背景情報

CRD は、カスタムリソースを作成できる Kubernetes API オブジェクトです。詳細については、「CustomResourceDefinitions を使用した Kubernetes API の拡張」をご参照ください。CRD を使用すると、特定のシナリオに合わせてネイティブ Kubernetes API を拡張できます。CR は CRD から作成できます。

Simple Log Service CRD を使用すると、CR を使用して Logtail 構成を管理できます。最初に、Kubernetes クラスターに接続し、必要な認証を完了します。次に、YAML 構成ファイルを kube-apiserver に送信して、Logtail 構成を定義する CR を作成します。

警告

CR を使用して Logtail 構成を作成し、Simple Log Service コンソールで変更した場合、変更は CR に同期されません。CR で作成された Logtail 構成を更新するには、CR を直接変更する必要があります。コンソールで変更して不整合が発生しないようにしてください。

CR ベースの Logtail 構成管理の実装

  1. Simple Log Service は Deployment を作成して、alibaba-log-controller コンポーネントをインストールします。このコンポーネントは、AliyunLogConfig CRD の変更を監視します。

  2. kubectl またはその他の Kubernetes ツールを使用して AliyunLogConfig CRD を作成、更新、または削除すると、alibaba-log-controller はこれらの変更を監視し、CRD 構成と Logtail 構成ステータスに基づいて Simple Log Service にリクエストを送信します。たとえば、Logtail 構成の更新をリクエストする場合があります。

CRD

クラウドネイティブモードでの Logtail 構成管理を容易にするために、Simple Log Service は AliyunPipelineConfig と AliyunLogConfig の 2 つの CRD を定義しています。次の表に、CRD の機能と相違点を示します。

重要

AliyunPipelineConfig を使用するには、logtail コンポーネントがバージョン 0.5.1 以降である必要があります。

CRD

AliyunPipelineConfig(推奨)

AliyunLogConfig

ApiGroup

telemetry.alibabacloud.com/v1alpha1

log.alibabacloud.com/v1alpha1

CRD リソース名

ClusterAliyunPipelineConfig

AliyunLogConfig

スコープ

クラスター

名前空間

Logtail 構成フォーマット

LogtailPipelineConfig と同等

LogtailConfig と同等

クロスリージョン機能

サポート

サポート

クロスアカウント機能

サポート

サポート

Webhook 関連のパラメータ検証

サポート

サポートなし

構成の競合検出

サポート

Logtail コンポーネント バージョン 0.5 以降でサポート

構成の難易度

比較的低い

比較的高い

可観測性構成

ステータスフィールドには、エラーの詳細、更新時刻、以前に適用された Logtail 構成、および以前に Logtail 構成が適用された時点の情報が含まれています。

ステータスフィールドには、エラーコードとエラーメッセージが含まれています。