ストラテジーでのログ記録

StockSharp では、Strategy クラスが BaseLogReceiver を継承しているため、取引ストラテジーの動作中に発生するすべてのアクションやイベントをログ記録する組み込みツールを使用できます。

ログレベル

StockSharp は次のログレベルをサポートしています (重要度が低いものから高いものの順)。

Verbose - トレース用の最も詳細なログレベル
Debug - デバッグ用メッセージ
Info - 通常の情報メッセージ
Warning - 潜在的な問題に関する警告
Error - エラーメッセージ

ストラテジー内のログ記録メソッド

ストラテジーは、ログへメッセージを書き込むために次のメソッドを提供します。

LogVerbose

LogVerbose メソッドは、トレース用の詳細メッセージを記録するために設計されています。

protected override void OnStarted2(DateTime time)
{
	base.OnStarted2(time);

	LogVerbose("戦略をパラメーター付きで開始: 長期SMA={0}, 短期SMA={1}", LongSmaLength, ShortSmaLength);

	// ...
}

LogDebug

LogDebug メソッドは、デバッグメッセージに使用されます。

private void ProcessCandle(ICandleMessage candle)
{
	LogDebug("ローソク足を処理中: {0}, 始値={1}, 終値={2}, 高値={3}, 安値={4}, 出来高={5}",
		candle.OpenTime, candle.OpenPrice, candle.ClosePrice, candle.HighPrice, candle.LowPrice, candle.TotalVolume);

	// ...
}

LogInfo

LogInfo メソッドは、通常の情報メッセージに使用されます。

private void CalculateSignal(decimal shortSma, decimal longSma)
{
	bool isShortGreaterThanLong = shortSma > longSma;

	LogInfo("シグナル: {0}, 短期SMA={1}, 長期SMA={2}",
		isShortGreaterThanLong ? "Buy" : "Sell", shortSma, longSma);

	// ...
}

LogWarning

LogWarning メソッドは、警告を記録するために使用されます。

public void RegisterOrder(Order order)
{
	if (order.Volume <= 0)
	{
		LogWarning("無効な数量で注文を登録しようとしました: {0}", order.Volume);
		return;
	}

	// ...
}

LogError

LogError メソッドは、エラーメッセージを記録するために使用されます。

try
{
	// 何らかの処理
}
catch (Exception ex)
{
	LogError("操作中のエラー: {0}", ex.Message);
	Stop();
}

例外を直接受け取る LogError オーバーロードもあります。

try
{
	// 何らかの処理
}
catch (Exception ex)
{
	LogError(ex);
	Stop();
}

ログレベルの設定

Strategy クラスには、どのメッセージをログへ書き込むかを決定する LogLevel プロパティがあります。

// ストラテジーのログレベルを設定
strategy.LogLevel = LogLevels.Info;

選択したログレベルでは、そのレベル以上のメッセージのみが記録されます。たとえば LogLevels.Info が設定されている場合、Verbose と Debug のメッセージは無視されます。

LogLevel パラメーター

ストラテジーコンストラクターでログレベルを便利に設定するために、パラメーターを追加できます。

public class SmaStrategy : Strategy
{
	private readonly StrategyParam<LogLevels> _logLevel;

	public SmaStrategy()
	{
		_logLevel = Param(nameof(LogLevel), LogLevels.Info)
					.SetDisplay("ログレベル", "ログメッセージの詳細レベル", "ログ設定");
	}

	public override LogLevels LogLevel
	{
		get => _logLevel.Value;
		set => _logLevel.Value = value;
	}

	// ...
}

実際のストラテジーでの使用例

ストラテジー開始と停止のログ記録

protected override void OnStarted2(DateTime time)
{
	base.OnStarted2(time);

	LogInfo("Strategy {0} started at {1}. Instrument: {2}, Portfolio: {3}",
		Name, time, Security?.Code, Portfolio?.Name);

	// ...
}

protected override void OnStopped()
{
	LogInfo("Strategy {0} stopped. Position: {1}, P&L: {2}",
		Name, Position, PnL);

	base.OnStopped();
}

約定のログ記録

protected override void OnNewMyTrade(MyTrade trade)
{
	LogInfo("{0} {1} {2} 価格 {3}。数量: {4}",
		trade.Order.Direction == Sides.Buy ? "Bought" : "Sold",
		trade.Order.Security.Code,
		trade.Order.Type,
		trade.Trade.Price,
		trade.Trade.Volume);

	base.OnNewMyTrade(trade);
}

注文登録エラーのログ記録

protected override void OnOrderRegisterFailed(OrderFail fail, bool calcRisk)
{
	LogError("注文登録エラー {0}: {1}",
		fail.Order.TransactionId, fail.Error.Message);

	base.OnOrderRegisterFailed(fail, calcRisk);
}

ログリスナーの接続

ストラテジーからメッセージを受信するには、LogManager を通じてリスナーを接続します。

var logManager = new LogManager();

// ファイルへ書き込み
var fileListener = new FileLogListener("{0}_{1:00}_{2:00}.txt".Put(DateTime.Now.Year, DateTime.Now.Month, DateTime.Now.Day));
logManager.Listeners.Add(fileListener);

// メール送信
var emailListener = new EmailLogListener("from@stocksharp.com", "to@stocksharp.com");
emailListener.Filters.Add(msg => msg.Level == LogLevels.Error);
logManager.Listeners.Add(emailListener);

// ストラテジーをログソースとして追加
logManager.Sources.Add(strategy);

ログの表示

ストラテジーログへ書き込まれたメッセージは、次の場所で表示できます。

Designer プログラムの "Logs" パネル
FileLogListener が設定されている場合はログファイル
LogControl を通じたユーザーインターフェイス（GuiLogListener が使用されている場合）