Not able to test KPIs Integration (RTU)

Description

Followed this guide to implement RTU KPI metric on our app.
https://community.amazondeveloper.com/t/how-to-implement-reportfullydrawn-marker-for-webview-apps/9267

Using this doc to test the KPI integration:
https://developer.amazon.com/docs/kepler-tv/ks-measure-app-kpis.html#measure-kpis-in-vs-code

App was installed on the device, and tried both debug and release builds.

  1. Testing from CLI - https://developer.amazon.com/docs/kepler-tv/ks-measure-app-kpis.html#measure-kpis-with-cli-commands

The suggested command is showing invalid:

perf doctor --app-name=in.startv.hotstar 
perf <command> [options] [parameters] 
: error: argument : invalid choice: 'doctor' (choose from 'activity-monitor', 'record', 'kpi-visualizer')

Then I tried : perf kpi-visualizer --app-name=in.startv.hotstar

This worked but gave an error after rebooting completes.

Rebooting device...
Reboot completed...
Waiting for reboot to complete...
Waiting 30/30...
kspt-service directory not found
Could not sideload KSPTService onto device
PerfGlass directory not found
Could not sideload PerfGlass.vpkg onto device

Iteration 1...
Starting trace...
1719 KB/s (1926 bytes in 0.001s)
Tracing tool did not initialize correctly. Exiting...
An Unexpected Error Occurred...

  1. Testing from VSCODE: https://developer.amazon.com/docs/kepler-tv/ks-measure-app-kpis.html#measure-kpis-in-vs-code

Error: App KPI Visualiser failed. Please validate the manifest.toml and try again.

But as per the docs in developer portal and community forum, there are no changes mentioned for manifest.toml.

App Name: JioHotstar

System information

 kepler git:(feature/AF-10640-account-login-info) ✗ kepler platform doctor
Checking installation status at /Users/sauravb1/.kepler/kntools/sdk/0.19.6
A different location can be specified via environment variable KEPLER_SDK_PATH.

✔ System: macOS 14.5
  Architecture: aarch64
✔ Rosetta not enabled
✔ username and token found in knrc file
✔ git found in the path
✔ curl found in the path
✔ Node.js binary compiled for aarch64
✔ VSCode found in the path
✔ XCode Command Line Tools is up to date
✔ /Users/sauravb1/.kepler/kntools/sdk/0.19.6 exists; /Users/sauravb1/.kepler/kntools exists
✔ licenses and legal notices found in /Users/sauravb1/.kepler/kntools/sdk/0.19.6
✔ Installed system packages:
  autossh 1.4g
  binutils 2.44
  coreutils 9.4
  gawk 5.3.1
  findutils 4.10.0
  glib 2.84.0_1
  gnutls 3.8.4
  grep 3.11
  jpeg 9f
  jq 1.7.1
  libepoxy 1.5.10
  libpng 1.6.43
  libslirp 4.9.0
  libssh 0.10.6
  libusb 1.0.27
  lzo 2.10
  lz4 1.10.0
  nettle 3.9.1
  openssh 9.9p2
  pixman 0.42.2
  sdl2 2.30.0
  snappy 1.2.1
  tmux 3.4_1
  unzip 6.0_8
  vde 2.3.3
  xz 5.8.1
  gnu-sed 4.9
  watchman 2025.03.10.00
  zstd 1.5.7
✔ pyenv version 2.5.7 installed
✔ python version 3.12.6 installed
✔ pip version 24.2 installed
✔ pyenv virtualenv version 1.2.4 installed
✔ virtualenv 'kepler-0.19.6' created
✔ Installed Python packages: 
  conan 2.0.17
  docopt 0.6.2
  flatbuffers 23.5.26
  langcodes 3.3.0
  psutil 7.0.0
  PyYAML 6.0.1
  tomli 2.0.1
  wheel 0.41.3
  zstandard 0.22.0
✔ debugger server found
✔ simulator exists at /Users/sauravb1/.kepler/kntools/sdk/0.19.6/simulator/tools/runsimulator
✔ vda version 2.1.0 installed
✔ Vega Packaging Tools vpt binary exists in /Users/sauravb1/.kepler/kntools/sdk/0.19.6/vegapackagingtool/bin/vpt
✔ Hermes Compiler binary exists at /Users/sauravb1/.kepler/kntools/sdk/0.19.6/hermes/072/bin/hermesc
✔ kvdi skipped since simulator is installed
✔ kvd-tv skipped since simulator is installed
✔ Heaptrack Tools binaries exist in /Users/sauravb1/.kepler/kntools/sdk/0.19.6/heaptrack_prebuilts
✔ Kepler Debugging Tools binaries exist in /Users/sauravb1/.kepler/kntools/sdk/0.19.6/kepler_debugging_tools/tools/scripts
✔ Kepler Manifest Module Remapper amzn-kepler-manifest-module-remapper binary exists in /Users/sauravb1/.kepler/kntools/sdk/0.19.6/kepler_manifest_module_remapper/bin/amzn-kepler-manifest-module-remapper
✔ CPU profiling tool for performance analysis binaries exist in /Users/sauravb1/.kepler/kntools/sdk/0.19.6/simpleperf_prebuilts
✔ Corretto JDK version 11.0.20.8.1 installed
✔ Kepler Performance CLI binaries exist in /Users/sauravb1/.kepler/kntools/sdk/0.19.6/kepler_perf_cli
✔ Kepler Studio extensions installed in VSCode
✔ environment setup file exists at /Users/sauravb1/.kepler/kntools/sdk/0.19.6/environment-setup-sdk.sh and has correct contents
✔ /Users/sauravb1/.kepler/kntools/sdk/0.19.6/environment-setup-sdk.sh is sourced from /Users/sauravb1/.zprofile
✔ Telemetry Service exists at /Users/sauravb1/.kepler/kntools/sdk/0.19.6/kepler-telemetry/telemetry. Configuration file exists at /Users/sauravb1/.kepler/kntools/sdk/0.19.6/kepler-telemetry/config.json. Collection of anonymous usage data is enabled


Kepler CLI prerequisites are all correctly installed.

Logs or crash report

Additional Info

Hi @Saurav_Kumar_Bhagat ,

Can you please provide the output of cat /etc/os-release ?

Can you also share your ~/.zshrc file ?
Reason is we want to ensure that the KEPLER_SDK_PATH is set to 0.19.6 (as shown in above System information).

It appears that the perf tool is from an SDK which does not match with the artifact as per the log messages attached.

Thanks,
Rohit

Hi Rohit,

Thanks for your response.

Sadly, there is no file or directory named os-release inside /etc.

My zshrc file include this line:
source /Users/sauravb1/.kepler/kntools/sdk/0.19.6/environment-setup-sdk.sh

Are you looking for something else?

One information I can share which might be helpful is this kepler version is installed in nodejs 20 version and that might not be my default nodejs version.
I usually change my version using nvm and then use kepler commands.

Let me know if you need any more information.

Thanks
Saurav

Hi Saurav, Just checking if you looked at /etc/os-release on the device? Thanks.
-Srinath

Hello Saurav,

Thank you for reaching out and providing the details. I would like to know about your host machine and device environment. Would you be open to a quick call on this topic?

Thanks,
Pankaj

Hi Pankaj,

Sure we can connect over a call.

This is the output of /cat/os-release

cat /etc/os-release
NAME="OS"
OE_VERSION="4.0.0"
OS_MAJOR_VERSION="1"
OS_MINOR_VERSION="1"
RELEASE_ID="2"
OS_VERSION="1.1"
BRANCH_CODE="VegaMainlineTvIntegration"
BUILD_DESC="OS 1.1 (VegaMainlineTvIntegration/4359)"
BUILD_FINGERPRINT="4.0.108973.0(3072cab629675a74)/4359N:user-external/release-keys"
BUILD_VARIANT="user-external"
BUILD_TAGS="release-keys"
BUILD_DATE="Wed Jun 04 22:45:10 UTC 2025"
BUILD_TIMESTAMP="1749077110"
VERSION_NUMBER="201010435950"

Can we connect today before 3PM IST?

Thanks
Saurav

This is resolved, some version issue.
For some reason, perf doctor was picking older version.
Thanks team.

This topic was automatically closed 14 days after the last reply. New replies are no longer allowed.