# Dataset returned by system.eam.queryAgentHistory

**URL:** <https://forum.inductiveautomation.com/t/dataset-returned-by-system-eam-queryagenthistory/101258>\
**Category:** Ignition\
**Created:** [January 22, 2025, 9:03pm UTC](https://forum.inductiveautomation.com/t/dataset-returned-by-system-eam-queryagenthistory/101258 "2025-01-22T21:03:07Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![Ben522326](https://avatars.discourse-cdn.com/v4/letter/b/b4bc9f/32.png) [@Ben522326](https://forum.inductiveautomation.com/u/Ben522326)\
**Post date:** [January 22, 2025, 9:03pm UTC](https://forum.inductiveautomation.com/t/dataset-returned-by-system-eam-queryagenthistory/101258/1 "2025-01-22T21:03:07Z")

</div>

I have some questions regarding the dataset returned from system.eam.queryAgentHistory, and I haven't found any documentation about the possible values returned for each column.

According to the [documentation](https://www.docs.inductiveautomation.com/docs/8.1/appendix/scripting-functions/system-eam/system-eam-queryAgentHistory), this function will return a dataset with columns id, agent\_name, agent\_role, event\_time, event\_category, event\_type, event\_source, event\_level, event\_level\_int, and message, where each row is a new agent event.

When I run this in the controller, every row returned has 'Unspecified' for the agent\_role column, and None for the message column:

```python
agent_role: Unspecified
message: None

```

Where are these values coming from? I haven't found any settings in the controller or agent gateways related to these columns and I'm wondering where/if I can set the agent\_role and understand why nothing gets returned for the message column?

---

<div class="post-metadata">

**Author:** ![paul-griffith](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/paul-griffith/32/37249_2.png) [@paul-griffith](https://forum.inductiveautomation.com/u/paul-griffith)\
**Post date:** [January 28, 2025, 11:53pm UTC](https://forum.inductiveautomation.com/t/dataset-returned-by-system-eam-queryagenthistory/101258/2 "2025-01-28T23:53:35Z")

</div>

'Agent\_Role' will be one of "Unspecified", "Master", or "Backup", depending on the redundancy role of the agent gateway.

I only see one code path (currently) where the message will be populated:  
`"Disconnect requested by agent."`