ロギング

ここでは、Oracle Enterprise Manager for MySQL Databaseのロギングについて説明します。

Oracle Management Serviceや管理エージェントのログについては、『Oracle Enterprise Manager管理者ガイド』のEnterprise Managerログ・ファイルの特定と構成を参照してください。

管理エージェントでは、すべてのエージェントとプラグインのロギングにlog4jライブラリが使用されます。ロギング構成は、log4j2.xmlファイルのプロパティによって定義されます。

Oracle Enterprise Manager for MySQL Database固有のログ・ファイルは、Oracle Enterprise Manager Agentインストールの次の場所に書き込まれます:

/plugins/oracle.mysql.omys.agent.plugin_versionNumber/scripts/oracle_omys_database/logs

ログ構成は、Oracle Enterprise Manager Agentインストールの次のディレクトリに格納されます:

/plugins/oracle.mysql.omys.agent.plugin_versionNumber/scripts/oracle_omys_database/etc

ここでのversionNumberは、このプラグインのバージョンです。

自動検出プラグインのロギングも、log4j2.xml構成によって構成されます。デフォルトでは、このファイルは、管理エージェント・インストールの/plugins/oracle.mysql.omys.discovery.plugin_versionNumber/etcディレクトリに作成されます。

自動検出ログ出力のデフォルトのディレクトリは次のとおりです:

/plugins/oracle.mysql.omys.discovery.plugin_versionNumber/logs

versionNumberはこのプラグインのバージョンです。

次に、log4j2.xmlファイルの例を示します:

<Configuration status="INFO">
    <Properties>
        <Property name="logging.filename">myoem</Property>
    </Properties>

    <Appenders>
        <Console name="stdout" target="SYSTEM_OUT">
            <PatternLayout pattern="%d %5p [%t:%c{3}] %m%n"/>
        </Console>

        <RollingFile name="pluginFile" fileName="${sys:logging.path}/${sys:logging.filename}.log"
                    filePattern="${sys:logging.path}/${sys:logging.filename}.log.%i">
            <PatternLayout>
                <Pattern>%d %5p [%t:%c] %m%n</Pattern>
            </PatternLayout>
            <Policies>
                <SizeBasedTriggeringPolicy size="10 MB"/>
            </Policies>
            <DefaultRolloverStrategy max="10"/>
        </RollingFile>
    </Appenders>

    <Loggers>
        <Root level="info">
            <AppenderRef ref="pluginFile"/>
        </Root>

        <Logger name="com.mysql.etools.emplugin.collection.availability" level="info"/>
        <Logger name="com.mysql.etools.emplugin.collection.discovery" level="info"/>
        <Logger name="com.mysql.etools.emplugin.collection.assets" level="info"/>
        <Logger name="com.mysql.etools.emplugin.collection.manufactured" level="info"/>

    </Loggers>
</Configuration>

一般ログと収集タイプ・ログは、モニター対象のMySQLインスタンスごとに生成されます。収集タイプ・ログは、com.mysql.etools.emplugin.collection.*プロパティによって定義されます。それらは、デフォルトではINFOレベルであり、詳細(可用性、メトリック、レスポンス時間など)をログ記録します。収集タイプごとにログ・ファイルが1つ生成されます。一般ログでは、ロギングの詳細(このプラグインの動作、エラー、ステータス・メッセージなど)が示されます。これらのログ・ファイルは10MBでロールオーバーされ、ログ・タイプごとに10ファイルまで保持されます。10ファイルという上限を超えた古いログは削除されます。

サポート担当者から求められた場合を除き、ログ・プロパティの編集はお薦めしません。