2.0.0 • Public • Published


    NPM CircleCI Downloads/week License

    A plugin to record command usage and error telemetry for the Salesforce CLI.

    This plugin is bundled with the CLI and will automatically collect usage data on all commands and plugins. To disable data collection, see this help document.

    Note: This plugin should be included at a CLI level ONLY. No CLI plugins should include or depend on this plugin.

    All command usage is recorded by initializing on the init oclif hook, recording all events to a log file, then spawning a process on exit to send the data to appinsights.

    To debug the telemetry spawned process, run a command with the environment variables SFDX_TELEMETRY_DEBUG=true and DEBUG=sfdx:telemetry*.

    SFDX_TELEMETRY_DEBUG=true DEBUG=sfdx:telemetry* ./bin/run telemetry

    Getting Started

    To build the plugin locally, make sure to have yarn installed and run the following commands:

    # Clone the repository
    git clone git@github.com:salesforcecli/plugin-telemetry
    # Install the dependencies and compile
    yarn install
    yarn build

    To use your plugin, run using the local ./bin/run or ./bin/run.cmd file.

    # Run using local run file.
    ./bin/run telemetry

    There should be no differences when running via the Salesforce CLI or using the local run file. However, it can be useful to link the plugin to do some additional testing or run your commands from anywhere on your machine.

    # Link your plugin to the sfdx cli
    sfdx plugins:link .
    # To verify
    sfdx plugins


    sfdx hello:org [-n <string>] [-f] [-v <string>] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]

    print a greeting and your org IDs

      $ sfdx hello:org [-n <string>] [-f] [-v <string>] [-u <string>] [--apiversion <string>] [--json] [--loglevel
      -f, --force                                                                       example boolean flag
      -n, --name=name                                                                   name to print
      -u, --targetusername=targetusername                                               username or alias for the target
                                                                                        org; overrides default target org
      -v, --targetdevhubusername=targetdevhubusername                                   username or alias for the dev hub
                                                                                        org; overrides default dev hub org
      --apiversion=apiversion                                                           override the api version used for
                                                                                        api requests made by this command
      --json                                                                            format output as json
      --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)  [default: warn] logging level for
                                                                                        this command invocation
      $ sfdx hello:org --targetusername myOrg@example.com --targetdevhubusername devhub@org.com
         Hello world! This is org: MyOrg and I will be around until Tue Mar 20 2018!
         My hub org id is: 00Dxx000000001234
      $ sfdx hello:org --name myname --targetusername myOrg@example.com
         Hello myname! This is org: MyOrg and I will be around until Tue Mar 20 2018!


    npm i @salesforce/plugin-telemetry

    DownloadsWeekly Downloads






    Unpacked Size

    76 kB

    Total Files


    Last publish


    • jye-sf
    • adirasanam
    • hkii
    • mcasado
    • iamaziz
    • dlouvton
    • jc-sf
    • pvandyk-sf
    • dbreese-salesforce
    • ashokrudraraju
    • dhersam
    • demianbrecht
    • mbettio
    • damilareolowoniyi
    • mmadialagan
    • spoorti.nidagundi
    • rodesp
    • mjrust
    • salesforce-releases
    • conal
    • vazexqi
    • joshwlewis
    • mpsenn
    • sfdc_iamigo
    • kevinv11n
    • tbliss
    • byao
    • pmdartus
    • futuremint_sf
    • interactivellama
    • ekashida
    • gr8gatsby
    • ravi.jayaramappa
    • apapko
    • krisgraysfdc
    • jleen-sfdc
    • jqian
    • cwallsf
    • dhagberg-sf
    • michaelhoefer
    • tlohr
    • khawkins
    • amphro
    • tconn
    • dehru
    • abdulsattar
    • jodarove
    • rxu-sfdc
    • amcconnell-sf
    • nolanlawson
    • sfdctaka
    • fernomac
    • cafreeman
    • jimjag
    • ivarley
    • jbartolotta-sfdc