> For the complete documentation index, see [llms.txt](https://docs.docontrol.io/docontrol-user-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.docontrol.io/docontrol-user-guide/saas-data-monitoring/inventory/inventory-users/github-users.md).

# GitHub users

You can view personal details and event data for all your internal and external GitHub users:

* [Internal users](#github-internal-users) - Users who belong to your organization's GitHub platform and operate within the organization domains or subdomains.&#x20;
* [External users](#github-external-users) - Users who are outside your organization, but have access to your GitHub files.&#x20;

## Locate a GitHub user

To view personal details and event data for a specific internal or external user in GitHub:

1. From the DoControl side menu, click **Inventory** > **Users**.
2. Select **GitHub**.<br>

   <div align="left"><figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2F1oHEySlvelVwbRmJAkw9%2Fselect%20GitHub.png?alt=media&amp;token=6eddd586-6e7e-48f6-90a8-d8b4aa00247b" alt="" width="238"><figcaption></figcaption></figure></div>
3. Select **Internal** or **External**.<br>

   <figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2F9QApYjzwy34JRjjETxSE%2FGitHub%20user%20list.png?alt=media&amp;token=d2db7dbf-6c29-4c7c-b821-19b62615633e" alt=""><figcaption></figcaption></figure>
4. Filter for a specific user.
5. Click the user name to open the user details.

## GitHub internal users

All internal users in your GitHub platform are displayed with these parameters:

<table><thead><tr><th width="223.87890625">Internal user parameter</th><th>Description</th></tr></thead><tbody><tr><td>User</td><td>Internal user name. Click the user name to open the internal user details with <a href="#events">event</a> data. </td></tr><tr><td>First name</td><td>Internal user's given name</td></tr><tr><td>Last name</td><td>Internal user's surname</td></tr><tr><td>Role</td><td>Indication if the user is a GutHub admin or member</td></tr><tr><td>Created on</td><td>Date when the user was created in GitHub</td></tr><tr><td>Last active</td><td>Date when the user was updated in GitHub</td></tr></tbody></table>

{% hint style="success" %}
Click **Export to CSV** <img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FPWdaV30qx1aefHNdGX9C%2Fdownload%20icon.png?alt=media&amp;token=16257bf4-2b68-4417-91e6-78c5db741fdc" alt="" data-size="line"> to download a consolidated report of internal GitHub users in CSV format.
{% endhint %}

## GitHub external users

All external users in your GitHub platform are displayed with these parameters:

<table><thead><tr><th width="223.87890625">External user parameter</th><th>Description</th></tr></thead><tbody><tr><td>User</td><td>External user name. Click the user name to open the external user details with <a href="#events">event</a> data. </td></tr><tr><td>First name</td><td>External user's given name</td></tr><tr><td>Last name</td><td>External user's surname</td></tr><tr><td>Role</td><td>Indication if the user is a GutHub admin or member</td></tr><tr><td>Created on</td><td>Date when the user was created in GitHub</td></tr><tr><td>Last active</td><td>Date when the user was updated in GitHub</td></tr></tbody></table>

{% hint style="success" %}
Click **Export to CSV** <img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FPWdaV30qx1aefHNdGX9C%2Fdownload%20icon.png?alt=media&amp;token=16257bf4-2b68-4417-91e6-78c5db741fdc" alt="" data-size="line"> to download a consolidated report of external GitHub users in CSV format.
{% endhint %}

## Events

DoControl monitors real-time events of user activities in GitHub for internal and external users. If no date range is selected, events are displayed from the last 30 days.

#### To view events for a specific internal or external user:

1. From the DoControl side menu, click **Inventory** > **Users**.
2. Select **GitHub**.
3. Select **Internal** or **External**.
4. Filter for a specific user.
5. Click the user name to open the internal user details.
6. Scroll down to view metadata for the user's events in GitHub.

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FK81OI61GfiGWF7VPmx6b%2FGitHub%20events.png?alt=media&amp;token=b00ab467-3d44-4c91-9313-e10d772c1ca6" alt=""><figcaption></figcaption></figure>

The metadata displayed for a user's events in GitHub includes these parameters:

<table><thead><tr><th width="271">Event parameter</th><th>Description</th></tr></thead><tbody><tr><td>Date and time</td><td>When the event occurred</td></tr><tr><td>Actor </td><td>The user who triggered the event</td></tr><tr><td>Target</td><td>The user whom the actor shared data with</td></tr><tr><td>App</td><td>App involved in the event: GitHub</td></tr><tr><td>Asset</td><td>Branch name in GitHub</td></tr><tr><td>Event type</td><td>Type of event as defined in GitHub (Push, etc)</td></tr><tr><td>Triggered</td><td>Number of workflows or alerts that were triggered by this event</td></tr><tr><td>Event ID</td><td>Unique identifier for the event</td></tr><tr><td>Event JSON</td><td>Click to open the JSON file with raw details about the event</td></tr></tbody></table>

{% hint style="success" %}
Click **Export to CSV** <img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FPWdaV30qx1aefHNdGX9C%2Fdownload%20icon.png?alt=media&amp;token=16257bf4-2b68-4417-91e6-78c5db741fdc" alt="" data-size="line"> to download a consolidated report of event metadata for a specific GitHub user.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.docontrol.io/docontrol-user-guide/saas-data-monitoring/inventory/inventory-users/github-users.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
