This page serves as a high level reference guide to what .decimal logs for user interactions with our software. There are 3 different sections detailed here for the use cases of user logging:
Note: This section is applicable to Auth0 user logins only.
Auth0 user logins use the user's email as the user name. If your username is not an email you have a legacy login and this section is not applicable.
.decimal uses Auth0 as its user authentication service. Auth0 logs user actions including:
Note: These logs are not directly accessible by end users, but may be provided by .decimal staff upon request.
See below for example logs for common Auth0 events:
{
"date": "2022-05-11T12:13:02.783Z",
"type": "Success Exchange",
"client_id": "<REDACTED>",
"client_name": "decimal Launcher",
"ip": "<REDACTED>",
"user_agent": "Electron 5.0.13 / Windows 10.0.0",
"hostname": "dotdecimal.us.auth0.com",
"user_id": "<REDACTED>",
"user_name": "<REDACTED>",
"isMobile": false,
}
{
"date": "2022-05-11T13:24:10.066Z",
"description": "Wrong email or password.",
"connection": "decimal",
"client_name": "decimal Launcher",
"ip": "<REDACTED>",
"user_agent": "Electron 5.0.13 / Windows 10.0.0",
"details": {
"error": {
"message": "Wrong email or password."
}
},
"user_id": "<REDACTED>",
"user_name": "<REDACTED>",
"isMobile": false
}
{
"date": "2022-05-11T13:54:35.190Z",
"description": "User (<REDACTED>) attempted 10 consecutive logins unsuccessfully. Brute force protection is enabled for this connection, further attempts are blocked from this IP address for this user.",
"connection": "decimal",
"connection_id": "<REDACTED>",
"client_id": "<REDACTED>",
"ip": "<REDACTED>",
"user_agent": "Electron 5.0.13 / Windows 10.0.0",
"hostname": "dotdecimal.us.auth0.com",
"user_id": "",
"user_name": "<REDACTED>",
"isMobile": false
}
Customer Applications include .decimal developed applications used by end clinical users that are downloaded and installed on the customer's local computers. These may include, but are not limited to: p.d, decimal3D, decimal Launcher, and decimal eRT. See each application below for an example activity log.
p.d logs the local user activity and records the following information to its local application database:
| Log Item | Description |
|---|---|
| username | The username/email of the user performing the action |
| patientName | An encrypted string for the patient the log entry applies to |
| medicalRecordNumber | An encrypted string for the patient's MRN the log entry applies to |
| uniquePlanName | An encrypted string for the plan the log entry applies to |
| planName | An encrypted string for the plan the log entry applies to |
| logDate | The local date time of the log entry |
| logEvent | The event that the log entry is for. logEvents include, but are not limited to: -User log in -User log out -Plan Open -Plan Save -Plan Close -Order placed to decimal Direct -Local and DICOM AE file export (e.g.: DICOM) -Patient deletion |
decimal3D logs the local user activity and records the following information to its local application database. This information is exportable from the Advanced menu option within the application.
| Log Item | Description |
|---|---|
| User ID | The username/email of the user performing the action |
| Action | The action the user performed (see below for an itemized list) |
| Date/Time | The local date time the action was performed. Actions include, but are not limited to: -User log in attempts -User log in success/fail -User log out -View patients list -View patient info (including patient MRN) -Create new scans/contours -Orders placed to decimal Direct (including beam name) -Local and AE file exports (e.g.: DICOM) -Patient deletion |
decimal eRT logs the local user activity and records the following information to its local patient database. This information is exportable from the Organization Configuration → Export Logs block within the application.
| Log Item | Description |
|---|---|
| Hardware ID | Local Windows computer name |
| ID | The ID of the corresponding Data Type of the log entry |
| Date | The date time of the log entry |
| Log Event | The event that was logged. Log Event's include, but are not limited to: -Import Patients -View Patients -Open Patients -Import Courses -Update Course -Create Plans -Update Plans -Clone Plans -Open Plans -Update Organization -Export DICOM files locally -Export DICOM files to AE service -Approve Plans -Order files to decimal Direct -Export Reports |
| Data Type | What data caused to the log entry. Data Type's include, but are not limited to: -Application (root level interactions without a specific data to link to) -Organization -Patient -Course -Plan -Export -Order |
| Username | The users first and last name that caused the log entry |
Users will interact with the decimal Direct website to perform certain tasks. For each logged interaction in Direct the following is recorded:
| Log Item | Description |
|---|---|
| UserID | Internal .decimal user ID that links to a user |
| Log Route | The API route (i.e.: action taken) for the log |
| Parameters | The parameters of the action |
| TimeStamp | The data time (as Eastern Time) of the action |
See below for the outline of what user interactions are recorded.
A normal user interaction includes any non-elevated user tasks that are performed. Normal user interactions that are logged include:
| Log Category | Log Event |
|---|---|
| Login (legacy non-Auth0 users only) | Login attempt |
| Login success/fail | |
| Ordering | Order File Upload |
| Order Placed | |
| User Preferences | Email Notifications Changed |
| Password changed (legacy non-Auth0 users only) |
A manager user interaction includes any elevated user tasks that are performed by the site manager within the Management pages. Manager user interactions that are logged include:
| Log Event | Captured Data |
|---|---|
| Site Management | Site Info (address) Update |
| Application Management | Version Change |
| User Management | User Add |
| User Remove | |
| User Info Edit | |
| User Permissions Edit |
Other .decimal applications that connect to decimal Direct and .decimal logs some integration connections for diagnostic trouble shooting. These interactions include and capture:
| Log Event | Captured Data |
|---|---|
| Application Login | User |
| Date Time | |
| Site ID | |
| Application | |
| Website Legacy User Login | User |
| Date Time | |
| Website Auth0 User Login | User |
| Date Time |