> ## Documentation Index
> Fetch the complete documentation index at: https://puzzlet-9ba7bb98.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# CrewAI

> Trace CrewAI agents and crews in AgentMark using the OpenInference instrumentor.

export const props_0 = undefined

export const subject_0 = "CrewAI"

The OpenInference `CrewAI` instrumentor instruments [CrewAI](https://github.com/crewAIInc/crewAI) crews, capturing each agent run, task, and crew kickoff as OTLP spans. CrewAI runs the underlying model through [LiteLLM](https://github.com/BerriAI/litellm), so register the `LiteLLM` instrumentor alongside it to capture the model call itself: model name, token counts, and cost. Point the exporter at AgentMark and the traces arrive normalized. CrewAI is a Python framework.

## Setup

<Steps>
  <Step title="Install the instrumentors and the OTLP exporter">
    ```bash theme={null}
    pip install openinference-instrumentation-crewai openinference-instrumentation-litellm \
      opentelemetry-sdk opentelemetry-exporter-otlp-proto-http
    ```
  </Step>

  <Step title="Point the exporter at AgentMark and instrument CrewAI">
    Register both instrumentors against the same tracer provider. Use your AgentMark API key and app id from project settings.

    ```python theme={null}
    from openinference.instrumentation.crewai import CrewAIInstrumentor
    from openinference.instrumentation.litellm import LiteLLMInstrumentor
    from opentelemetry.sdk.trace import TracerProvider
    from opentelemetry.sdk.trace.export import BatchSpanProcessor
    from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter

    provider = TracerProvider()
    provider.add_span_processor(
        BatchSpanProcessor(
            OTLPSpanExporter(
                endpoint="https://api.agentmark.co/v1/traces",
                headers={
                    "Authorization": "<YOUR_API_KEY>",  # raw key, no "Bearer" prefix
                    "X-Agentmark-App-Id": "<YOUR_APP_ID>",
                },
            )
        )
    )

    CrewAIInstrumentor().instrument(tracer_provider=provider)   # agent, task, crew structure
    LiteLLMInstrumentor().instrument(tracer_provider=provider)  # the model call: model, tokens, cost
    ```

    <Note>
      Without the LiteLLM instrumentor you still get the agent and crew spans, but not the model call, so model, token counts, and cost would be missing. Register both.
    </Note>
  </Step>

  <Step title="Run your crew">
    Run your crew as usual. Each agent, task, tool call, and model call arrives in AgentMark as a span, grouped into a trace. See [Traces and logs](/observe/traces-and-logs).
  </Step>
</Steps>

## What AgentMark captures

{props_0.subject_0} spans use the OpenInference attribute conventions: model, token usage, input and output messages, tool calls, settings, and span kind are all mapped onto AgentMark's normalized trace fields, and token counts feed [cost tracking](/observe/cost-and-token-tracking). See [OpenInference](/integrations/tracing/openinference#what-agentmark-captures) for the full attribute mapping.

## Next steps

<CardGroup cols={2}>
  <Card title="OpenInference" icon="diagram-project" href="/integrations/tracing/openinference">
    How AgentMark reads OpenInference attributes
  </Card>

  <Card title="Traces and logs" icon="list-tree" href="/observe/traces-and-logs">
    Explore traces once they arrive
  </Card>
</CardGroup>

<div className="mt-8 rounded-lg bg-blue-50 p-6 dark:bg-blue-900/30">
  <h3 className="font-semibold mb-3">Have questions?</h3>
  <p className="mb-4">Reach out any time:</p>

  <ul>
    <li>
      Email the team at <a href="mailto:hello@agentmark.co" className="text-blue-600 hover:text-blue-800 dark:text-blue-400 dark:hover:text-blue-200">[hello@agentmark.co](mailto:hello@agentmark.co)</a> for support
    </li>

    <li>
      Schedule an <a href="https://cal.com/ryan-randall/enterprise" className="text-blue-600 hover:text-blue-800 dark:text-blue-400 dark:hover:text-blue-200">Enterprise Demo</a> to learn about AgentMark's business solutions
    </li>
  </ul>
</div>