Datacoral 的 Python Instrumentation 使用 Snowplow

先决条件

如果您已将Datacoral 事件连接器添加到您的 Datacoral 安装中，则文档的这一部分很有用。
立即联系support@datacoral.co，在 oredr 中设置您的新事件连接器。

概述

我们默认的 Collect Events Slice 与Snowplow Tracker Protocol兼容。

Snowplow 提供多种语言的跟踪器或仪器库。
我们已经合并了这些库并增强了它们以支持：

1. 指向您自己的事件 HTTP 端点。
2. 生成 API 密钥
3. 创建多个环境，例如 dev/stage/prod，以便可以根据环境隔离事件。
4. 浏览器 js 工具，指定CORS 起源

贡献快速入门

假设安装了Git和Datacoral CLI：

安装 datacoral-tracker-py

pip install datacoral-tracker-py

发布（跟踪）

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)

附加阅读

• 事件片概述
• 来自 Python 的事件

版权和许可

根据Apache 许可证 2.0 版（“许可证”）获得许可；除非遵守许可，否则您不得使用此软件。

除非适用法律要求或书面同意，否则根据许可分发的软件将按“原样”分发，没有任何明示或暗示的保证或条件。有关许可下的特定语言管理权限和限制，请参阅许可。