Controlup
Visualize Hosts, users, and Host Agents in Controlup while monitoring changes through advanced queries and automated alerts.
- Installation
- Data Model
- Types
Installation
Requirements
- User must have the Manage Users role to access User details in ControlUp account.
- User must have permission in JupiterOne to install new integrations.
Configuration in ControlUp
Generate API Key and collect Organization ID from ControlUp
- Log in to your ControlUp account at https://app.controlup.com.
- Click on Profile Icon in the top-right corner.
- Go to API Key Management > Create new
- Provide Name and Duration for the API key and click on Create.
- Copy the API key and store it securely for further use.
- Go to API Key Management or AccountSettings
- Copy the Organization ID.
Configuration in JupiterOne
- From the top navigation of the J1 Search homepage, select Integrations
- Search for the ControlUp and select it.
- Click on the Add Instance button and configure the following settings:
- Enter the ControlUp API Key generated for use by JupiterOne.
- Enter the ControlUp Organization ID generated for use by JupiterOne.
- Enter the Account Name by which you'd like to identify this ControlUp
Cloud instance in JupiterOne. Ingested entities will have this value stored in
tag.AccountName
when Tag with Account Name is checked. - Enter a Description that will further assist your team when identifying the integration instance.
- Select a Polling Interval that you feel is sufficient for your monitoring
needs. You may leave this as
DISABLED
and manually execute the integration.
- Click Create Instance once all values are provided.
Next steps
Now that your integration instance has been configured, it will begin running on the polling interval you provided, populating data within JupiterOne. Continue on to our Instance management guide to learn more about working with and editing integration instances.
Entities
The following entities are created:
Resources | Entity _type | Entity _class |
---|---|---|
Host | controlup_host | Host |
Host Agent | controlup_hostagent | HostAgent |
User | controlup_user | User |
Relationships
The following relationships are created:
Source Entity _type | Relationship _class | Target Entity _type |
---|---|---|
controlup_hostAgent | MONITORS | controlup_host |
Controlup Host
controlup_host
inherits from Host
Property | Type | Description | Specifications |
---|---|---|---|
cpuPCoreCount | number | Count of Physical CPU cores in a processor | |
cpuVCoreCount | number | Count of Virtual CPU cores in a processor | |
displayCount | number | ||
dnsFriendlyName | string | ||
dsGroups | array of string s | ||
firewallStatus | string | ||
gpuMemory | number | Memory of Graphical Processing Unit | |
gpuName | string | Name of Graphical Processing Unit | |
gpuVersion | string | Version of Graphical Processing Unit | |
group | array of string s | ||
interfaceTypes | array of string s | ||
lastCommunicatedOn | number | ||
memory | number | ||
osDiskConfigurationFreespace | number | ||
osDiskConfigurationUsedspace | number | ||
osDomainSite | string | ||
osPatch | string | ||
platformFriendlyName | string | ||
publicIPCity | string | ||
publicIPCountry | string | ||
publicIPState | string | ||
remoteAddress | string | ||
remoteAddressGeo | string | ||
remoteAddressISP | string | ||
serialNumber | string | ||
wifiMACAddresses | array of string s | ||
wifiNames | array of string s |
Controlup Hostagent
controlup_hostagent
inherits from HostAgent
Property | Type | Description | Specifications |
---|---|---|---|
agentVersion | string | ||
autoUpdateMode | string | ||
build | string | ||
configUpdateInterval | number | ||
debugLevel | number | ||
deviceGroup | string | ||
geoLocation | string | ||
isAgentAutoUpdateEnabled | boolean | ||
refreshInterval | number | ||
statusInterval | number | ||
triggerIntervalShort | number |
Controlup User
controlup_user
inherits from User
Property | Type | Description | Specifications |
---|---|---|---|
eulaVersion | string | ||
loginMethods | array of string s | ||
phone | string | ||
region | string | ||
roleNames | array of string s | ||
vdiDaasLdapLogin | boolean |