Back to packageRELEASE DETAILS

0.4.0

PyPI

agentforge-statsd

StatsD metrics emitter hook for AgentForge

Published24 Jun 2026

Direct dependencies2

Transitive dependenciesNot calculated

README

Version 0.4.0 documentation

agentforge-statsd

StatsD metrics emitter for the AgentForge framework.

Implements the StepHook + FinishHook contracts on the existing agentforge.hooks entry-point so installing the package makes name: statsd available in modules.observability config blocks.

Installation

pip install agentforge-statsd[statsd]

The [statsd] extra pulls in the statsd>=4.0 Python client. Without the extra, the package is importable but the production factory raises ModuleError with pip remediation.

Usage

from agentforge import Agent
from agentforge_statsd import StatsdHook

hook = StatsdHook.from_config(
    host="statsd.internal",
    port=8125,
    prefix="agentforge.pr-reviewer",
)

agent = Agent(
    model="bedrock:...",
    on_step=hook,
    on_finish=hook,
)

Metrics emitted

Metric	Type	When
`<prefix>.step.<kind>`	counter +1	every step
`<prefix>.step.duration_ms`	timing	every step with `duration_ms > 0`
`<prefix>.tool.<name>`	counter +1	every step with `tool_call`
`<prefix>.run.finish.<reason>`	counter +1	on run finish
`<prefix>.run.duration_ms`	timing	on run finish
`<prefix>.run.cost_usd`	gauge	on run finish
`<prefix>.run.tokens_in`	gauge	on run finish
`<prefix>.run.tokens_out`	gauge	on run finish

License

Apache-2.0.

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 2

Native requirements

2 direct targetsNot calculated transitive count

Package / target Requirement Relationship

Package / target	Requirement	Relationship
agentforge-core Environment { "extras": "", "marker": null, "requires_python": ">=3.13", "evaluation": "NOT_EVALUATED" }	`agentforge-core~=0.4.0`	runtime
statsd Environment { "extras": "", "marker": "extra == \"statsd\"", "requires_python": ">=3.13", "evaluation": "NOT_EVALUATED" }	`statsd>=4.0; extra == "statsd"`	runtime

agentforge-core

Environment

{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.13",
  "evaluation": "NOT_EVALUATED"
}

agentforge-core~=0.4.0

runtime

statsd

Environment

{
  "extras": "",
  "marker": "extra == \"statsd\"",
  "requires_python": ">=3.13",
  "evaluation": "NOT_EVALUATED"
}

statsd>=4.0; extra == "statsd"

runtime

Distribution files

2 collected

agentforge_statsd-0.4.0-py3-none-any.whl

bdist_wheel · 9.8 KB · Python py3

Source file

agentforge_statsd-0.4.0.tar.gz

sdist · 9.3 KB · Python source

Source file

Repository

PENDING

scaffoldic/agentforge-py

Shared repository data · GitHub

License detected in repository: Not collected

Metadata history

Meaningful changes

Current collected state Current

Observed since 20 Oct, 21:58 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:8b20e2c4047bba2226b581cf514a3588a34ad585e71808e3fbec687404de088d

Other collected versions

View all collected versions →