Input telemetry

apps/RenderCadenceCompositor/README.md

@@ -273,6 +273,10 @@ Input telemetry:
 
 - `inputFramesReceived`: frames accepted into `InputFrameMailbox`
 - `inputFramesDropped`: ready input frames dropped or missed because the mailbox was full
+- `inputConsumeMisses`: render ticks where no ready input frame was available to upload
+- `inputUploadMisses`: input texture upload attempts that reused the previous GL input texture
+- `inputReadyFrames`: ready input frames currently queued in `InputFrameMailbox`
+- `inputReadingFrames`: input frames currently protected while render uploads them
 - `inputLatestAgeMs`: age of the newest submitted input frame
 - `inputUploadMs`: render-thread GL upload/decode submission time for the latest uploaded input frame
 - `inputFormatSupported`: whether the latest frame reaching the render upload path was BGRA8 or UYVY8 compatible

apps/RenderCadenceCompositor/render/RenderThread.cpp

@@ -87,6 +87,10 @@ RenderThread::Metrics RenderThread::GetMetrics() const
 	metrics.shaderBuildFailures = mShaderBuildFailures.load(std::memory_order_relaxed);
 	metrics.inputFramesReceived = mInputFramesReceived.load(std::memory_order_relaxed);
 	metrics.inputFramesDropped = mInputFramesDropped.load(std::memory_order_relaxed);
+	metrics.inputConsumeMisses = mInputConsumeMisses.load(std::memory_order_relaxed);
+	metrics.inputUploadMisses = mInputUploadMisses.load(std::memory_order_relaxed);
+	metrics.inputReadyFrames = mInputReadyFrames.load(std::memory_order_relaxed);
+	metrics.inputReadingFrames = mInputReadingFrames.load(std::memory_order_relaxed);
 	metrics.inputLatestAgeMilliseconds = mInputLatestAgeMilliseconds.load(std::memory_order_relaxed);
 	metrics.inputUploadMilliseconds = mInputUploadMilliseconds.load(std::memory_order_relaxed);
 	metrics.inputFormatSupported = mInputFormatSupported.load(std::memory_order_relaxed);
@@ -240,6 +244,9 @@ void RenderThread::PublishInputMetrics(const InputFrameTexture& inputTexture)
 		const InputFrameMailboxMetrics mailboxMetrics = mInputMailbox->Metrics();
 		mInputFramesReceived.store(mailboxMetrics.submittedFrames, std::memory_order_relaxed);
 		mInputFramesDropped.store(mailboxMetrics.droppedReadyFrames + mailboxMetrics.submitMisses, std::memory_order_relaxed);
+		mInputConsumeMisses.store(mailboxMetrics.consumeMisses, std::memory_order_relaxed);
+		mInputReadyFrames.store(mailboxMetrics.readyCount, std::memory_order_relaxed);
+		mInputReadingFrames.store(mailboxMetrics.readingCount, std::memory_order_relaxed);
 		mInputLatestAgeMilliseconds.store(mailboxMetrics.latestFrameAgeMilliseconds, std::memory_order_relaxed);
 		mInputSignalPresent.store(mailboxMetrics.hasSubmittedFrame, std::memory_order_relaxed);
 	}
@@ -247,10 +254,14 @@ void RenderThread::PublishInputMetrics(const InputFrameTexture& inputTexture)
 	{
 		mInputFramesReceived.store(0, std::memory_order_relaxed);
 		mInputFramesDropped.store(0, std::memory_order_relaxed);
+		mInputConsumeMisses.store(0, std::memory_order_relaxed);
+		mInputReadyFrames.store(0, std::memory_order_relaxed);
+		mInputReadingFrames.store(0, std::memory_order_relaxed);
 		mInputLatestAgeMilliseconds.store(0.0, std::memory_order_relaxed);
 		mInputSignalPresent.store(false, std::memory_order_relaxed);
 	}
 
+	mInputUploadMisses.store(inputTexture.UploadMisses(), std::memory_order_relaxed);
 	mInputUploadMilliseconds.store(inputTexture.LastUploadMilliseconds(), std::memory_order_relaxed);
 	mInputFormatSupported.store(inputTexture.LastFrameFormatSupported(), std::memory_order_relaxed);
 }

apps/RenderCadenceCompositor/render/RenderThread.h

@@ -40,6 +40,10 @@ public:
 		uint64_t shaderBuildFailures = 0;
 		uint64_t inputFramesReceived = 0;
 		uint64_t inputFramesDropped = 0;
+		uint64_t inputConsumeMisses = 0;
+		uint64_t inputUploadMisses = 0;
+		std::size_t inputReadyFrames = 0;
+		std::size_t inputReadingFrames = 0;
 		double inputLatestAgeMilliseconds = 0.0;
 		double inputUploadMilliseconds = 0.0;
 		bool inputFormatSupported = true;
@@ -94,6 +98,10 @@ private:
 	std::atomic<uint64_t> mShaderBuildFailures{ 0 };
 	std::atomic<uint64_t> mInputFramesReceived{ 0 };
 	std::atomic<uint64_t> mInputFramesDropped{ 0 };
+	std::atomic<uint64_t> mInputConsumeMisses{ 0 };
+	std::atomic<uint64_t> mInputUploadMisses{ 0 };
+	std::atomic<std::size_t> mInputReadyFrames{ 0 };
+	std::atomic<std::size_t> mInputReadingFrames{ 0 };
 	std::atomic<double> mInputLatestAgeMilliseconds{ 0.0 };
 	std::atomic<double> mInputUploadMilliseconds{ 0.0 };
 	std::atomic<bool> mInputFormatSupported{ true };

apps/RenderCadenceCompositor/telemetry/CadenceTelemetry.h

@@ -26,6 +26,10 @@ struct CadenceTelemetrySnapshot
 	uint64_t shaderBuildFailures = 0;
 	uint64_t inputFramesReceived = 0;
 	uint64_t inputFramesDropped = 0;
+	uint64_t inputConsumeMisses = 0;
+	uint64_t inputUploadMisses = 0;
+	std::size_t inputReadyFrames = 0;
+	std::size_t inputReadingFrames = 0;
 	double inputLatestAgeMilliseconds = 0.0;
 	double inputUploadMilliseconds = 0.0;
 	bool inputFormatSupported = true;
@@ -104,6 +108,10 @@ public:
 		snapshot.shaderBuildFailures = renderMetrics.shaderBuildFailures;
 		snapshot.inputFramesReceived = renderMetrics.inputFramesReceived;
 		snapshot.inputFramesDropped = renderMetrics.inputFramesDropped;
+		snapshot.inputConsumeMisses = renderMetrics.inputConsumeMisses;
+		snapshot.inputUploadMisses = renderMetrics.inputUploadMisses;
+		snapshot.inputReadyFrames = renderMetrics.inputReadyFrames;
+		snapshot.inputReadingFrames = renderMetrics.inputReadingFrames;
 		snapshot.inputLatestAgeMilliseconds = renderMetrics.inputLatestAgeMilliseconds;
 		snapshot.inputUploadMilliseconds = renderMetrics.inputUploadMilliseconds;
 		snapshot.inputFormatSupported = renderMetrics.inputFormatSupported;

apps/RenderCadenceCompositor/telemetry/CadenceTelemetryJson.h

@@ -28,6 +28,10 @@ inline void WriteCadenceTelemetryJson(JsonWriter& writer, const CadenceTelemetry
 	writer.KeyUInt("shaderFailures", snapshot.shaderBuildFailures);
 	writer.KeyUInt("inputFramesReceived", snapshot.inputFramesReceived);
 	writer.KeyUInt("inputFramesDropped", snapshot.inputFramesDropped);
+	writer.KeyUInt("inputConsumeMisses", snapshot.inputConsumeMisses);
+	writer.KeyUInt("inputUploadMisses", snapshot.inputUploadMisses);
+	writer.KeyUInt("inputReadyFrames", static_cast<uint64_t>(snapshot.inputReadyFrames));
+	writer.KeyUInt("inputReadingFrames", static_cast<uint64_t>(snapshot.inputReadingFrames));
 	writer.KeyDouble("inputLatestAgeMs", snapshot.inputLatestAgeMilliseconds);
 	writer.KeyDouble("inputUploadMs", snapshot.inputUploadMilliseconds);
 	writer.KeyBool("inputFormatSupported", snapshot.inputFormatSupported);