ホーム
製品
OpenShift Container Platform
4.6
ロギング
8.2. ログ転送カスタムリソースの更新

8.2. ログ転送カスタムリソースの更新

OpenShift Container Platform 4.6 では、OpenShift Container Platform ログ転送 API はテクノロジープレビューから一般利用が可能となりました。GA リリースには、ClusterLogging カスタムリソース (CR) に変更を加え、LogForwarding カスタムリソース (CR) を ClusterLogForwarder CR に置き換える必要がある改善点および機能拡張が含まれています。

OpenShift Container Platform 4.6 の ClusterLogForwarder インスタンスのサンプル

apiVersion: logging.openshift.io/v1
kind: ClusterLogForwarder
metadata:
  name: instance
  namespace: openshift-logging
....
spec:
  outputs:
  - url: http://remote.elasticsearch.com:9200
    name: elasticsearch
    type: elasticsearch
  - url: tls://fluentdserver.example.com:24224
    name: fluentd
    type: fluentdForward
    secret:
      name: fluentdserver
  pipelines:
  - inputRefs:
      - infrastructure
      - application
    name: mylogs
    outputRefs:
     - elasticsearch
  - inputRefs:
      - audit
    name: auditlogs
    outputRefs:
      - fluentd
      - default
...

apiVersion: logging.openshift.io/v1
kind: ClusterLogForwarder
metadata:
  name: instance
  namespace: openshift-logging
....
spec:
  outputs:
  - url: http://remote.elasticsearch.com:9200
    name: elasticsearch
    type: elasticsearch
  - url: tls://fluentdserver.example.com:24224
    name: fluentd
    type: fluentdForward
    secret:
      name: fluentdserver
  pipelines:
  - inputRefs:
      - infrastructure
      - application
    name: mylogs
    outputRefs:
     - elasticsearch
  - inputRefs:
      - audit
    name: auditlogs
    outputRefs:
      - fluentd
      - default
...

Copy to Clipboard

Toggle word wrap

OpenShift Container Platform 4.5 の ClusterLogForwarder CR のサンプル

apiVersion: logging.openshift.io/v1alpha1
kind: LogForwarding
metadata:
  name: instance
  namespace: openshift-logging
spec:
  disableDefaultForwarding: true
  outputs:
   - name: elasticsearch
     type: elasticsearch
     endpoint: remote.elasticsearch.com:9200
   - name: fluentd
     type: forward
     endpoint: fluentdserver.example.com:24224
     secret:
       name: fluentdserver
  pipelines:
   - inputSource: logs.infra
     name: infra-logs
     outputRefs:
     - elasticearch
   - inputSource: logs.app
     name: app-logs
     outputRefs:
      -  elasticearch
   - inputSource: logs.audit
     name: audit-logs
     outputRefs:
      -  fluentd

apiVersion: logging.openshift.io/v1alpha1
kind: LogForwarding
metadata:
  name: instance
  namespace: openshift-logging
spec:
  disableDefaultForwarding: true
  outputs:
   - name: elasticsearch
     type: elasticsearch
     endpoint: remote.elasticsearch.com:9200
   - name: fluentd
     type: forward
     endpoint: fluentdserver.example.com:24224
     secret:
       name: fluentdserver
  pipelines:
   - inputSource: logs.infra
     name: infra-logs
     outputRefs:
     - elasticearch
   - inputSource: logs.app
     name: app-logs
     outputRefs:
      -  elasticearch
   - inputSource: logs.audit
     name: audit-logs
     outputRefs:
      -  fluentd

Copy to Clipboard

Toggle word wrap

以下の手順では、変更が必要な各パラメーターを示しています。

手順

4.5 の ClusterLogForwarder CR を 4.6 の ClusterLogForwarding に更新するには、以下の変更を行います。

ClusterLogging カスタムリソース (CR) を編集して logforwardingtechpreview アノテーションを削除します。

ClusterLogging CR の例

apiVersion: "logging.openshift.io/v1"
kind: "ClusterLogging"
metadata:
  annotations:
    clusterlogging.openshift.io/logforwardingtechpreview: enabled 
  name: "instance"
  namespace: "openshift-logging"
....

apiVersion: "logging.openshift.io/v1"
kind: "ClusterLogging"
metadata:
  annotations:
    clusterlogging.openshift.io/logforwardingtechpreview: enabled


  name: "instance"
  namespace: "openshift-logging"
....

Copy to Clipboard

Toggle word wrap

1: logforwardingtechpreview アノテーションを削除します。

ClusterLogForwarder CR をエクスポートし、ClusterLogForwarder インスタンスの YAML ファイルを作成します。

oc get LogForwarding instance -n openshift-logging -o yaml| tee ClusterLogForwarder.yaml

$ oc get LogForwarding instance -n openshift-logging -o yaml| tee ClusterLogForwarder.yaml

Copy to Clipboard

Toggle word wrap

YAML ファイルを編集して以下の変更を加えます。
OpenShift Container Platform 4.6 の ClusterLogForwarder インスタンスのサンプル
```
apiVersion: logging.openshift.io/v1 
kind: ClusterLogForwarder 
metadata:
  name: instance
  namespace: openshift-logging
....
spec: 
  outputs:
  - url: http://remote.elasticsearch.com:9200 
    name: elasticsearch
    type: elasticsearch
  - url: tls://fluentdserver.example.com:24224
    name: fluentd
    type: fluentdForward 
    secret:
      name: fluentdserver
  pipelines:
  - inputRefs: 
      - infrastructure
      - application
    name: mylogs
    outputRefs:
     - elasticsearch
  - inputRefs:
      - audit
    name: auditlogs
    outputRefs:
      - fluentd
      - default 
...
```
```
apiVersion: logging.openshift.io/v1 
```
1
```
kind: ClusterLogForwarder 
```
2
```
metadata:
  name: instance
  namespace: openshift-logging
....
spec: 
```
3
```
  outputs:
  - url: http://remote.elasticsearch.com:9200 
```
4
```
    name: elasticsearch
    type: elasticsearch
  - url: tls://fluentdserver.example.com:24224
    name: fluentd
    type: fluentdForward 
```
5
```
    secret:
      name: fluentdserver
  pipelines:
  - inputRefs: 
```
6
```
      - infrastructure
      - application
    name: mylogs
    outputRefs:
     - elasticsearch
  - inputRefs:
      - audit
    name: auditlogs
    outputRefs:
      - fluentd
      - default 
```
7
```
...
```
Copy to Clipboard Toggle word wrap
1
apiVersion を "logging.openshift.io/v1alpha1" から "logging.openshift.io/v1" に変更します。
2
オブジェクトの種類を kind: "LogForwarding" から kind: "ClusterLogForwarder" に変更します。
3
disableDefaultForwarding: true パラメーターを削除します。
4
output パラメーターを spec.outputs.endpoint から spec.outputs.url に変更します。接頭辞がない場合は、https:// や tcp:// など、URL に接頭辞を追加します。
5
Fluentd 出力の場合は、type を forward から fluentdForward に変更します。
6
Pipeline を変更します。
spec.pipelines.inputSource を spec.pipelines.inputRefs に変更します。
logs.infra を infrastructure に変更します。
logs.app を application に変更します。
logs.audit を audit に変更します。
7
オプション: ログを内部 Elasticsearch インスタンスに送信するために default のパイプラインを追加します。default の出力を設定する必要はありません。
注記
ログを内部の OpenShift Container Platform Elasticsearch インスタンスのみに転送する必要がある場合は、ログ転送 API を設定しないようにしてください。
CR オブジェクトを作成します。
```
oc create -f ClusterLogForwarder.yaml
```
```
$ oc create -f ClusterLogForwarder.yaml
```
Copy to Clipboard Toggle word wrap

ログ転送 API の新機能の詳細は、ログのサードパーティーシステムへの転送を参照してください。

トップに戻る

8.2. ログ転送カスタムリソースの更新

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

多様性を受け入れるオープンソースの強化

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links