Configure runtime security metrics

task australia Updated Oct 27, 2026 2 min read gov-sec-configure-pi-sensitive-metrics.md
Raw file servicenow.com

Set up a Traceloop connection and API key for prompt injection, offensive content, sensitive data input, and sensitive data anonymized trace data from external AI servers. Review data privacy settings to see which patterns detect sensitive data in LLM input and output.

Before you begin

Role required: admin

Install the open-source Traceloop SDK. In a terminal window, run this command:

pip install traceloop-sdk

After you install Traceloop SDK, you can customize the following code to initialize the Traceloop tracer:

Text
import os from openaiimport OpenAI from traceloop.sdkimport Traceloop from traceloop.sdk.decoratorsimport workflow task
# InitializeTraceloop SDKTraceloop.init(app_name="joke_generation_service", disable_batch=True)client = OpenAI(api_key=os.environ.get("OPENAI_API_KEY"))

For more information, see Traceloop OpenLLMetry for Python.

If you have a domain-separated instance, create an alias with a parent of connection alias sn_ai_security.Traceloop_API. Create one active connection and credential record under this new alias. The domain of each connection record determines the domain of the runtime metrics it pulls.

Procedure

  1. Configure a trace connection for every external AI system for which you want to show runtime metrics.

    For more information, see Configuring trace connections.

  2. Generate an API key to authenticate trace data requests from your external AI system.

    1. Navigate to All > Connections & Credentials > Credentials.

    2. Create credentials of type API Key Credentials.

      Fill out these fields and select Submit.

      Field Description
      Name Traceloop API Key
      Applies to All MID servers
      Active Selected.
      Order 100
      API Key Header Authorization
      API Key Prefix Bearer
      API Key <your Traceloop API key>
      Credential alias Locked.

    For more information, see API key credentials.

  3. Link the API key to your trace connection.

    1. Navigate to All > Connections & Credentials > Connections.

    2. Create an HTTPS connection with the sn_ai_security.Traceloop_API connection alias and a connection URL of https://api.traceloop.com. For more information, see Create an HTTP(s) connection.

    The scheduled job will automatically pull runtime metrics from the linked Traceloop environment.

  4. Configure the Traceloop SDK in your agent code by adding these ServiceNow attributes when initializing Traceloop.

    These are unique user-defined identifiers for tracking.

    Shell
    Traceloop.init(    app_name="your_agent_name",    api_key=traceloop_api_key,    resource_attributes={        "sn.aict.system.id": "your_agent_system_id",        "sn.aict.system.name": "your_agent_name",        "sn.aict.system.version": "1.0.0",        "sn.aict.system.source": "your_source"    })

    For more information about configuring Traceloop in your agent, see Traceloop - Guardrails.

  5. To review data privacy, in AI Control Tower, navigate to Settings > Rules and templates > Security > Data Privacy.

    This section shows the data patterns enabled in Data Privacy to detect and anonymize information in LLM prompts. Use this view as a quick reference when troubleshooting sensitive data charts. This feature requires the Data privacy plugin to be activated. For more information on how the data is sent and stored, see User data usage policy for Now Assist.

  6. Return to the AI Control Tower Security tab and refresh the page.

    Select the Runtime tab and verify that metrics are populated.

Parent Topic:Configuring security metrics in AI Control Tower

Keywords ServiceNow OttoAI Agentsgenerative AIagentic AI
Search documentation
Search document titles and file paths on the australia branch