No Packages, Mate

    @rudderstack/rudder-sdk-node
    TypeScript icon, indicating that this package has built-in type declarations

    1.1.4 • Public • Published

    The Customer Data Platform for Developers

    Website · Documentation · Community Slack


    RudderStack Node.js SDK

    The RudderStack Node.js SDK lets you track your customer event data from your Node.js applications and send it to your specified destinations.

    Refer to the documentation for more details.

    Installing the SDK

    Run the following command to install the Node.js SDK via npm:

    $ npm install @rudderstack/rudder-sdk-node

    Using the SDK

    To create a global RudderStack client object and use it for the subsequent event calls, run the following snippet:

    const Analytics = require("@rudderstack/rudder-sdk-node");
    
    // we need the batch endpoint of the Rudder server you are running
    const client = new Analytics(WRITE_KEY, DATA_PLANE_URL/v1/batch");

    Supported calls

    Refer to the SDK documentation for more information on the supported calls.

    Initializing the SDK for data persistence

    This is a beta feature. Contact us on our Community Slack in case you face any issues.

    RudderStack has a data persistence feature to persist the events in Redis, leading to better event delivery guarantees. Also, the SDK can retry event delivery multiple times as the queue is maintained in a different process space(Redis).

    To use this feature, you will need to host a Redis server and use it as the intermediary data storage queue.

    A sample SDK initialization is shown below:

    const client = new Analytics(
      "write_key",
      "server_url/v1/batch",
      {
        flushAt: <number> = 20,
        flushInterval: <ms> = 20000
        maxInternalQueueSize: <number> = 20000 // the max number of elements that the SDK can hold in memory,
                                                                    // this is different than the Redis list created when persistence is enabled
      }
    );
    client.createPersistenceQueue({ redisOpts: { host: "localhost" } }, err => {})
    

    To initialize the data persistence queue, you need to call the createPersistenceQueue method which takes two parameters as input - queueOpts and a callback. The createPersistenceQueue method will initialize a Redis list by calling Bull's utility methods.

    If you do not call createPersistenceQueue after initializing the SDK, the SDK will not implement data persistence.

    Read the detailed documentation for more information on createPersistenceQueue and the other configurable parameters.

    Event flow

    For more information on how the event flow occurs with data persistence enabled, refer to the documentation.

    Limitations around data persistence

    Contact us

    If you come across any issues while configuring or using the RudderStack Node.js SDK, you can contact us or start a conversation in our Slack community.

    Keywords

    Install

    npm i @rudderstack/rudder-sdk-node

    DownloadsWeekly Downloads

    23,508

    Version

    1.1.4

    License

    none

    Unpacked Size

    62.4 kB

    Total Files

    6

    Last publish

    Collaborators

    • rudderstack