Cygnus エージェントの設定

コンテンツ :

イントロダクション

どの Cygnus エージェントも 2つの異なるファイルで設定されます :

  • cygnus_instance_<id>.conf ファイル : Flume エージェント名、このインスタンスの特定のログファイル、管理ポートなど、すべての非Flumeパラメータを設定します。この設定ファイルは、Cygnus がスタンドアロンアプリケーション(後述)として実行されている場合は必要ありませんが、サービスとして実行する場合は必須です(後述)
  • agent_<id>.conf ファイル : Flume エージェントを構成する異なるソース、チャネル、シンクなどを、Cygnus インスタンスの背後にどのように構成するか、それらのすべての Flume パラメータを設定します。常に必須です

<id> によって識別されるいくつかの Cygnus インスタンスが存在する可能性があることに注意してください。この<id>は、同じ Cygnus インスタンスに関する両方の設定ファイルで同じでなければなりません。Cygnus の複数のインスタンスを同じマシン内のサービスとして実行したい場合は、これが必要です。たとえば、Cygnus の2つの異なるインスタンスを実行するには、次のものが必要です :

  • 最初のインスタンス:
    • cygnus_instance_1.conf
    • agent_1.conf
  • 二番目のインスタンス:
    • cygnus_instance_2.conf
    • agent_2.conf

さらに、ユニークな log4j.properties は、 Cygnus がトレースを記録する方法を制御します。

トップ

cygnus_instance_<id>.conf

cygnus_instance_<id>.conf ファイルは、Cygnusリポジトリにあるテンプレート conf/cygnus_instance.conf.template からインスタンス化することができます。

# The OS user that will be running Cygnus. Note this must be `root` if you want to run cygnus in a privileged port (<1024), either the admin port or the port in which Cygnus receives Orion notifications
CYGNUS_USER=cygnus
# Which is the config folder
CONFIG_FOLDER=/usr/cygnus/conf
# Which is the config file
CONFIG_FILE=/usr/cygnus/conf/agent_<id>.conf
# Name of the agent. The name of the agent is not trivial, since it is the base for the Flume parameters naming conventions, e.g. it appears in <AGENT_NAME>.sources.http-source.channels=...
AGENT_NAME=cygnus-common
# Name of the logfile located at /var/log/cygnus. It is important to put the extension '.log' in order to the log rotation works properly
LOGFILE_NAME=cygnus.log
# Administration port. Must be unique per instance
ADMIN_PORT=8081
# Polling interval (seconds) for the configuration reloading
POLLING_INTERVAL=30

ご覧のとおり、このファイルではログファイルを設定できます。詳細なログ設定については、log4j.properties セクションを確認してください。

トップ

agent_<id>.conf

agent_<id>.conf ファイルは、Cygnus リポジトリにあるテンプレート conf/agent.conf.template からインスタンス化することができます。

特定の Cygnus エージェントは使用されていませんが、このテンプレートは Apache Flume テンプレートにすぎません。

トップ