Payload format description for communication between the Agent and the Datadog backend.

This repository includes the protocol-buffer IDL used by the agent6 and agent7 to communicate with the Datadog backend. Those payloads are only supported by the V2 API endpoints. The generated Go, Python and Java implementations are checked into this repository and can be used directly.

You will need

• Ruby (any version will do)
• Go (at least the version in go.mod)
• A checkout of this repository within a GOPATH (so, at $GOPATH/src/github.com/DataDog/agent-payload)

The logs payload is defined in proto/logs/agent_logs_payload.proto. The following implementations are available:

• Go (gogofast): github.com/DataDog/agent-payload/pb
• Java: java/com/dd/agent/pb/Log.java

The metrics payload is defined in proto/metrics/agent_payload.proto. The following implementations are available:

• Go (gogofast): github.com/DataDog/agent-payload/gogen
• Python: python/agent_payload_pb2.py

The process payload is defined in proto/process/agent.proto. The following implementations are available:

• Go (gogofast): github.com/DataDog/agent-payload/process (note that this go package contains additional functionality beyond the generated PB implementation).

The CWS security dumps payload is defined in proto/cws/dumpsv1/activity_dump.proto. The following implementations are available:

• Go (vtproto): github.com/DataDog/agent-payload/v5/cws/dumpsv1
• Java: java/com/dd/cws/adv1/pb/SecDumpProto.java

After updating the IDL you must:

• Regenerate the code: rake codegen, rake will use gimme to run the rake command with the current defined go version
• Create a new tag with the updated version of the payload