datacoral-tracker-py 0.0.12

Datacoral's Python Instrumentation using Snowplow

Datacoral's Python Instrumentation using Snowplow

Prerequisits

This section of the documentation is useful if you have the Datacoral Events Connector already added to your Datacoral Installation.
Contact [e-mail] today, in oredr to set up your new Events Connector.

Overview

Our default Collect Events Slice is compatible with the Snowplow Tracker Protocol.

Snowplow provides tracker or instrumentation libraries in several languages.
We have incorporated those libraries and enhanced them to support:

1. Pointing to your own Events HTTP Endpoint.
2. Generate API Keys
3. Create multiple environments like dev/stage/prod so that events can be segregated based on the environment.
4. A browser js instrumentation, specifying CORS Origins

Contributing quickstart

Assuming Git and Datacoral CLI are installed:

Installing datacoral-tracker-py

pip install datacoral-tracker-py

Publishing (Tracking)

from snowplow_tracker import SelfDescribingJson, Tracker, Emitter

api_endpoint=os.environ['API_GATEWAY_ENDPOINT']
datacoral_env=os.environ['DATACORAL_ENV']
api_key=os.environ['DATACORAL_API_KEY']
namespace=os.environ['NAMESPACE'] or 'mynamespace'
app_id=os.environ['APP_ID'] or 'datacoral-python-tracker'

# Initialize the emitter
emitter = Emitter(api_endpoint, buffer_size=1)

# Initialize the tracker
tracker = Tracker(
    emitter,
    datacoral_env=datacoral_env,
    api_key=api_key,
    namespace=namespace,
    app_id=app_id,
    encode_base64=True
)

# Send a custom event with your own schema and contexts
data = {
    "foo": "bar",
    "metadata": {
        "sub": "data"
    }
}

sjson = SelfDescribingJson(
    schema="test",
    data=data)

tracker.track_unstruct_event(
    event_json=sjson)

Additional Reading

• Events Slice Overview
• Event from Python

Copyright and license

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this software except in compliance with the License.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.