---
title: record_ml_event (Python agent API)
source: https://docs.newrelic.com/docs/apm/agents/python-agent/python-agent-api/recordmlevent-python-agent-api
---

## Syntax

```py
newrelic.agent.record_ml_event(event_type, params, application=None)
```

Records a machine learning event for use in querying

## Requirements

Python agent version 9.1.0 or higher.

## Description

This records a machine learning [event](https://docs.newrelic.com/docs/data-apis/understand-data/new-relic-data-types/#event-data) that can be viewed and queried in the New Relic UI. If you want to use this outside of the context of a monitored transaction, use the application parameter.

> #### ⚠️ IMPORTANT
>
> For limits and restrictions on `event_type` and `params`, see [Limits and restricted characters](https://docs.newrelic.com/docs/data-apis/custom-data/custom-events/apm-report-custom-events-attributes/#limits) and [Reserved words](https://docs.newrelic.com/docs/data-apis/custom-data/custom-events/data-requirements-limits-custom-event-data/#reserved-words).

> #### ⚠️ IMPORTANT
>
> This setting is disabled when [high security mode](https://docs.newrelic.com/docs/apm/agents/python-agent/getting-started/apm-agent-security-python/#restricted) is enabled.

## Parameters

| Parameter              | Description                                                                                                                                                                                                                                                                                                                                                    |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `event_type` _string_  | Required. The `event_type` defines the name (or type) of the machine learning event, and must be a string. No additional attributes recorded for the transaction are added to machine learning events.                                                                                                                                                         |
| `params` _dict_        | Required. Attaches machine learning attributes to the event. Only attributes passed in as `params` are added. No additional attributes recorded for the transaction are added to machine learning events.                                                                                                                                                      |
| `application` _object_ | Optional. If you want to record an event outside of the context of a monitored transaction, use this to associate the call with a specific application object. An application object can be obtained using the [`newrelic.agent.application`](https://docs.newrelic.com/docs/apm/agents/python-agent/python-agent-api/application-python-agent-api/) function. |

## Return values

None.

## Examples

### Record machine learning event in background task [#bg-task-event]

Here's an example of recording a machine learning event associated with a background task:

```py
@newrelic.agent.background_task() 
def bg_task(): 
    # do some type of work in this background task...
    application = newrelic.agent.application()
    newrelic.agent.record_ml_event('your_event_type', {'param1':'value1'}, application)
```