導入＃
Open iT 、ログファイルを収集し、Open iT フォーマットに変換することで、ALMの使用状況レポートをサポートします。
Open iT クライアントがライセンスサーバにインストールされ ており、ライセンスサーバはこの収集のためにライセンス使用履歴 ログを作成しません。データコレクタは、5 分ごとにライセンスマネージャからライセンス使用 履歴ログを要求するように生のデータコレクタを開始し、データ収集プロセ スをトリガします。ログを受信すると、生データコレクタはそれをデータコレクタに渡す。収集されたデータは、処理のためにデータプリプロセッ サに送られます。前処理後、最終的な前処理済みデータが送信され、Core Server に保存されます。
Rawコレクターによるログファイル解析ワークフロー
これにより、過去の報告に使用される以下のような集計データが作成される：
ログデータを記録する：
- (89)ライセンス使用件数合計
- (90)個人ライセンス使用ライセンスイベント
- (91)ユーザーグループ ライセンス使用 ライセンスイベント
- (108)ホスト・ライセンス使用ライセンスイベント
- (109)ホストグループ・ライセンス使用 Licenseevents
イベントログデータ：
- (104)ライセンス・ログファイル・イベント v2.0
- (107)拒否されたライセンス使用 ライセンスイベント
以下のセクションでは、必要なデータを収集し、サーバーに送信するために必要な設定を説明します。
Open iT クライアントに表示されている設定を適用します。
要件 #
- Open iT Open iT サーバーまたは共存するOpen iT セットアップに接続されたOpen iT クライアント
- ライセンスサーバーの管理者権限
- デバッグ・ログ・ファイルへのフル・パス
ログデータ収集の有効化 #
これらは、ALM ログデータの収集を有効にするために必要な手順です。
- 管理者レベルの権限でコマンドプロンプトを開く。
- binディレクトリ（デフォルトはC:¥Program Files¥OpeniT¥Corebin）に移動し、コマンドを実行する：
コマンド構文
cd $BIN_DIR
例
cd C:¥Program Files¥OpeniT¥Corebin
- ディレクトリに入ったら、ALM ログデータの収集を有効にして、コマンドを実行します：
コマンド構文
openit_oconfinit -u "collect_license_alm-logs.root.scheduler.jobs.collect_alm_raw_licenselogs.general.active=true"
- ALMが生成するデータベースへのパスを設定し、コマンドを実行します：
コマンド構文
openit_oconfinit -u “collect_license_alm-logs.root.scheduler.jobs.collect_alm_raw_licenselogs.operations.arguments=automationlm –databasefile \”<database_file>\” –outputfile \”${OpeniT.directories.temp}/SqlCeUtil/ALM/automationlm.csv\” –logdir \”${OpeniT.directories.log}\””
where <database_file> is the path to the database produced by ALM. This is usually in C:\ProgramData\Siemens\Automation\Automation License Manager\logging.
例
openit_oconfinit -u “collect_license_alm-logs.root.scheduler.jobs.collect_alm_raw_licenselogs.operations.arguments=automationlm –databasefile \”C:\ProgramData\Siemens\Automation\Automation License Manager\logging\almdb.sdf\” –outputfile \”${OpeniT.directories.temp}/SqlCeUtil/ALM/automationlm.csv\” –logdir \”${OpeniT.directories.log}\””
高度なコンフィギュレーション
| 属性名 | 許容値 | 説明 |
| マックスインスタンス | Uint（例：5、8、9） | 同時に実行できるインスタンスの数。 |
| マックスハンドリング | 文字列（end-oldest、end-all-old、または end-new） | end-oldest - このオプションを指定すると、最も古いインスタンスを停止/キルし、新 しいインスタンスを開始する。end-all-old - このオプションを指定すると、新しいインスタンスを開始する 前に、実行中のすべてのインスタンスを停止/キルする。 |
| エンドタイムアウト | タイムスパン（例：P30S、P5M、P1H） | 実行中のインスタンスを終了するまでの最大待機時間。 |
| 隔離 | タイムスパン（例：P30S、P5M、P1H） | 前のインスタンスの後に新しいインスタンスを開始するまでの待ち時間。 |
ログファイル収集の設定 #
ALMログファイル設定ファイルlogfilecollector-alm.xmlはComponentsディレクトリにあり、デフォルトではC:¥Program Files¥OpeniT¥Core¥Configuration¥Componentsにあります。これを更新する必要はありませんが、その動作について詳しく知りたい場合は、ALM Log Parser Configuration の表を参照してください。
| オブジェクト名 | 許容値 | 説明 |
| ソース.dir | DirName (すなわち、${OpeniT.directories.temp}/SqlCeUtil/ALM/) | ALM ログファイルの場所。 |
| ソースパターン | 文字列（例：*.csv） | ソース・ディレクトリ内のソース・ファイルを特定するグロブ・パターン。 |
| ソース | 文字列（収集、無視、または末尾） | collect - このオプションを指定すると、毎回最初から収集する。 ignore - このオプションを指定すると、同じファイルからの再度の収集をスキップする。 tail - このオプションを指定すると、前回のファイルの終わりから収集を継続する（つまり、前回以降に追加されたものを収集する）。 |
| ソース.cmplines | 整数（例：6、10、20） | これは、source.seen の値が tail の場合に必要です。これは、収集を開始する場所を決定するために、以前に収集されたソース・ファイルと比較する行数です。 注意：この数が少なすぎると、正しくない位置になってしまい、ログ・ファイルに重複したデータが存在する可能性があります。通常、1行でも少なすぎるよりは、厳密に必要な行数より数行多い方がよい。 |
| ターゲットディレクトリ | DirName（例：${OpeniT.directories.temp}/LogFileCollector） | これは、収集されたログデータを含むディレクトリの場所である。 |
| ターゲットモジュール | 文字列（つまりライセンス） | 対象となるモジュールのタイプ（一般的に）。 |
| target.datatype | 文字列 | 対象データの具体的な種類。 |
| ターゲット・インターバル | タイムスパン（例：P30S、P5M、P1D） | コレクタの実行間隔。 |
| ターゲット回転サイズ | 整数（例：6、10、20） | ログファイルは、定義された数（mb）を超えると回転する。 |
| ターゲット回転グローブ | 文字列 (例: *) | ログファイルがローテートする前にマッチさせるグロブパターン。 |
ALM ログパーサーの設定
記録ログデータ収集の停止 #
ログデータ収集をオンにすると、記録ログデータとイベントログデータが自動的に集計されます。イベントログデータのみを収集したい場合は、以下の手順に従ってください。
- 管理者レベルの権限でコマンドプロンプトを開く。
- binディレクトリ（デフォルトはC:¥Program Files¥OpeniT¥Corebin）に移動し、コマンドを実行する：
コマンド構文
cd $BIN_DIR
例
cd C:¥Program Files¥OpeniT¥Corebin
- ディレクトリに入ったら、記録ログデータの収集を停止し、コマンドを実行する：
コマンド構文
openit_oconfinit -u "collect_license_alm-logs.root.scheduler.jobs.preprocess_alm_licenselogs-records.general.active=false"
- イベントログの取り扱いを変更するには、次のコマンドを実行する：
コマンド構文
openit_oconfinit -u "collect_license_alm-logs.root.scheduler.jobs.preprocess_alm_licenselogs-events.operations.arguments=-srcdir \"${OpeniT.directories.temp}/LogFileCollector" -srcpattern raw-alm-license-LogFileCollector*.data -srcfilehandling rename -trgdir ˶"${OpeniT.directories.temp}/LogParserALM"-module license -datatype event -resolution PT1H -matchobjects ˶"${OpeniT.directories.conf}/matchobjects-event-alm.oconf˶"-type event -disable-statlogging"
- データ転送スケジュールを変更し、コマンドを実行する：
コマンド構文
openit_oconfinit -u "collect_license_alm-logs.root.scheduler.jobs.transfer_alm_licenselogs.scheduling.start-triggers.trigger#1.job-name=preprocess_alm_licenselogs-events"。
ログデータ収集の検証 #
アクティベーション後、以下の手順でデータが収集され、サーバーに送信されていることを確認できます：
- 管理者レベルの権限でコマンドプロンプトを開く。
- binディレクトリ（デフォルトはC:¥Program Files¥OpeniT¥Corebin）に移動し、コマンドを実行：
コマンド構文
cd $BIN_DIR
例
cd C:¥Program Files¥OpeniT¥Corebin
- コマンドを実行する：
コマンド構文
openit_executor -r collect_license_alm-logs
- サーバ内のアーカイバディレクトリ（デフォルトではC:¥ProgramData¥archiver¥archiver）にarchiver*.inファイルが作成されていることを確認する。
