---
title: Client-Connected Log Event JSON Format
canonical: https://openvpn.net/cloud-docs/owner/api---logs/api---logs---log-streaming/log-event-formats/client-connected-log-event-json-format/
product: CloudConnexa Docs
description: This document describes the JSON log event fields of the Log Streaming Client-Connected log event and provides an example.
keywords: Log Streaming Client-Connected
---

# Client-Connected Log Event JSON Format

The `client-connected` log event is generated when an OpenVPN client (including Connectors) connects to CloudConnexa.

The log event JSON contains the Header fields and a `log` JSON object. The fields in the `log` JSON object for when the `eventName` in the Header is set to `client-connected` are described in the table below. For more information on the Header, refer to [Log Event Header Fields](https://openvpn.net/cloud-docs/owner/api---logs/api---logs---log-streaming/log-event-formats/log-event-header-fields.md).

| Field Name | Type | Description |
| --- | --- | --- |
| clientUUID | String | The unique hardware UUID of the connected device. |
| clientSessionId | String | A unique identifier assigned to the connection. Can be used to correlate other session events. |
| clientOsType | String | The client's operating system. |
| clientOsVersion | String | The version of the client's operating system. |
| clientPublicIp | String | The client's public IP address. |
| clientTunnelIpV4 | String | The IPv4 address of the client's OpenVPN tunnel. |
| clientTunnelIpV6 | String | The IPv6 address of the client's OpenVPN tunnel. |
| sessionProtocol | String | The protocol used for the OpenVPN tunnel. |
| sessionTunnelProtocol | String | The type of tunneling protocol used. |
| sessionStartTime | DateTime | The timestamp of when the connection started. |
| gatewayRegionName | String | The name of the CloudConnexa Region that the client connected to. |
| gatewayRegion | String | The identifier of the CloudConnexa Region that the client connected to. |
| gatewayId | String | The identifier of the specific gateway in the Region the client is connected to. |

## Example of a Client-Connected Log Event

```json
{
  "CloudConnexaLogVersion": 1,
  "timestamp": "2024-05-24T08:53:11.000000Z",
  "cloudId": "yuriidoroshkotest",
  "service": "CloudConnexa",
  "traceId": "ba7b71a2-c888-44c0-82d6-366a6f7c3ca1",
  "publicIp": "2a02:2378:11c4:ee42:6092:782:5f1f:997c",
  "initiator": "97bb7a07-7d15-4070-8239-7b610c131127",
  "initiatorType": "Device",
  "initiatorName": "device_1knjnknjk",
  "parentEntity": "long_user-name-1231232432545435665hhh3545435465465656hhhhh@yuriidoroshkotest",
  "parentEntityType": "User",
  "parentEntityName": "long_user-name-1231232432545435665hhh3545435465465656hhhhh",
  "category": "Security.Logins",
  "eventName": "client-connected",
  "log": {
    "clientUUID": "21a84507609d7a76",
    "clientOsType": "Android",
    "clientOsVersion": "14",
    "sessionProtocol": "OpenVPN / UDP",
    "clientPublicIp": "2a02:2378:11c4:ee42:6092:782:5f1f:997c",
    "sessionStartTime": "2024-05-24T08:53:11.000000Z",
    "clientTunnelIpV4": "100.96.1.163",
    "clientTunnelIpV6": "fd:0:0:810a::3",
    "clientSessionId": "6650558f1df239dff4ae2d54",
    "gatewayRegionName": "Chicago (IL)",
    "gatewayRegion": "us-central-1",
    "gatewayId": "us-ord-dc1-g1"
  }
}
```

---

Prev: [Test-Message Log Event JSON Format](https://openvpn.net/cloud-docs/owner/api---logs/api---logs---log-streaming/log-event-formats/test-message-log-event-json-format.md)
Next: [Client-Disconnected Log Event JSON Format](https://openvpn.net/cloud-docs/owner/api---logs/api---logs---log-streaming/log-event-formats/client-disconnected-log-event-json-format.md)
Index: https://openvpn.net/cloud-docs/llms.txt