Longview
This section details Longview-related Linode CLI commands.
list
Aliases: ls
Returns a paginated list of Longview Clients you have access to.
Usage
The format accepted by this command.
linode-cli longview list [-h] [--label label]
[--order-by {label}] [--order {asc,desc}]
Sample
Examples of how this command might be used.
linode-cli longview list
Filterable Attributes
Arguments used to define a filter for response entries.
Name |
Type |
Description |
---|---|---|
--label |
str |
This Client’s unique label. |
Result Attributes
The attributes returned by this command.
Name |
Type |
Example |
Description |
---|---|---|---|
api_key |
str |
BD1B4B54-D752…D8A17F39DB61 |
The API key for this Client, used when configuring the Longview Client application on your Linode. |
created |
str |
2018-01-01T00:01:01 |
When this Longview Client was created. |
id |
int |
789 |
This Client’s unique ID. |
install_code |
str |
BD1B5605-BF5E…AD518BE7F321 |
The install code for this Client, used when configuring the Longview Client application on your Linode. |
label |
str |
client789 |
This Client’s unique label. |
updated |
str |
2018-01-01T00:01:01 |
When this Longview Client was last updated. |
apps
Name |
Type |
Example |
Description |
---|---|---|---|
apps.apache |
bool |
true |
If True, the Apache Longview Client module is monitoring Apache on your server. |
apps.mysql |
bool |
true |
If True, the MySQL Longview Client modules is monitoring MySQL on your server. |
apps.nginx |
bool |
N/A |
If True, the Nginx Longview Client module is monitoring Nginx on your server. |
view
Returns a single Longview Client you can access.
Usage
The format accepted by this command.
linode-cli longview view [-h] [--label label]
[--order-by {label}] [--order {asc,desc}] clientId
Sample
Examples of how this command might be used.
linode-cli longview view 789
Parameters
Positional parameters used to define the resource this command should target.
Name |
Type |
Description |
---|---|---|
clientId |
int |
The Longview Client ID to access. |
Result Attributes
The attributes returned by this command.
Name |
Type |
Example |
Description |
---|---|---|---|
api_key |
str |
BD1B4B54-D752…D8A17F39DB61 |
The API key for this Client, used when configuring the Longview Client application on your Linode. |
created |
str |
2018-01-01T00:01:01 |
When this Longview Client was created. |
id |
int |
789 |
This Client’s unique ID. |
install_code |
str |
BD1B5605-BF5E…AD518BE7F321 |
The install code for this Client, used when configuring the Longview Client application on your Linode. |
label |
str |
client789 |
This Client’s unique label. |
updated |
str |
2018-01-01T00:01:01 |
When this Longview Client was last updated. |
apps
Name |
Type |
Example |
Description |
---|---|---|---|
apps.apache |
bool |
true |
If True, the Apache Longview Client module is monitoring Apache on your server. |
apps.mysql |
bool |
true |
If True, the MySQL Longview Client modules is monitoring MySQL on your server. |
apps.nginx |
bool |
N/A |
If True, the Nginx Longview Client module is monitoring Nginx on your server. |
create
Creates a Longview Client.
Usage
The format accepted by this command.
linode-cli longview create [-h] [--label label]
Sample
Examples of how this command might be used.
linode-cli longview create \
--label client789
Arguments
Additional fields used to execute this request.
Name |
Type |
Example |
Description |
---|---|---|---|
--label |
str |
client789 |
This Client’s unique label. |
Result Attributes
The attributes returned by this command.
Name |
Type |
Example |
Description |
---|---|---|---|
api_key |
str |
BD1B4B54-D752…D8A17F39DB61 |
The API key for this Client, used when configuring the Longview Client application on your Linode. |
created |
str |
2018-01-01T00:01:01 |
When this Longview Client was created. |
id |
int |
789 |
This Client’s unique ID. |
install_code |
str |
BD1B5605-BF5E…AD518BE7F321 |
The install code for this Client, used when configuring the Longview Client application on your Linode. |
label |
str |
client789 |
This Client’s unique label. |
updated |
str |
2018-01-01T00:01:01 |
When this Longview Client was last updated. |
apps
Name |
Type |
Example |
Description |
---|---|---|---|
apps.apache |
bool |
true |
If True, the Apache Longview Client module is monitoring Apache on your server. |
apps.mysql |
bool |
true |
If True, the MySQL Longview Client modules is monitoring MySQL on your server. |
apps.nginx |
bool |
N/A |
If True, the Nginx Longview Client module is monitoring Nginx on your server. |
update
Updates a Longview Client.
Usage
The format accepted by this command.
linode-cli longview update [-h] [--label label] clientId
Sample
Examples of how this command might be used.
linode-cli longview update 789 \
--label client789
Parameters
Positional parameters used to define the resource this command should target.
Name |
Type |
Description |
---|---|---|
clientId |
int |
The Longview Client ID to access. |
Arguments
Additional fields used to execute this request.
Name |
Type |
Example |
Description |
---|---|---|---|
--label |
str |
client789 |
This Client’s unique label. |
Result Attributes
The attributes returned by this command.
Name |
Type |
Example |
Description |
---|---|---|---|
api_key |
str |
BD1B4B54-D752…D8A17F39DB61 |
The API key for this Client, used when configuring the Longview Client application on your Linode. |
created |
str |
2018-01-01T00:01:01 |
When this Longview Client was created. |
id |
int |
789 |
This Client’s unique ID. |
install_code |
str |
BD1B5605-BF5E…AD518BE7F321 |
The install code for this Client, used when configuring the Longview Client application on your Linode. |
label |
str |
client789 |
This Client’s unique label. |
updated |
str |
2018-01-01T00:01:01 |
When this Longview Client was last updated. |
apps
Name |
Type |
Example |
Description |
---|---|---|---|
apps.apache |
bool |
true |
If True, the Apache Longview Client module is monitoring Apache on your server. |
apps.mysql |
bool |
true |
If True, the MySQL Longview Client modules is monitoring MySQL on your server. |
apps.nginx |
bool |
N/A |
If True, the Nginx Longview Client module is monitoring Nginx on your server. |
delete
Aliases: rm
Deletes a Longview Client from your Account.
Usage
The format accepted by this command.
linode-cli longview delete [-h] clientId
Sample
Examples of how this command might be used.
linode-cli longview delete 789
Parameters
Positional parameters used to define the resource this command should target.
Name |
Type |
Description |
---|---|---|
clientId |
int |
The Longview Client ID to access. |
plan-view
Get the details of your current Longview plan.
Usage
The format accepted by this command.
linode-cli longview plan-view [-h] [--order-by {}]
[--order {asc,desc}]
Sample
Examples of how this command might be used.
linode-cli longview plan-view
Result Attributes
The attributes returned by this command.
Name |
Type |
Example |
Description |
---|---|---|---|
clients_included |
int |
10 |
The number of Longview Clients that may be created with this Subscription tier. |
id |
str |
longview-10 |
The unique ID of this Subscription tier. |
label |
str |
Longview Pro 10 pack |
A display name for this Subscription tier. |
price
Name |
Type |
Example |
Description |
---|---|---|---|
price.hourly |
float |
0.06 |
The hourly price, in US dollars, for this Subscription tier. |
price.monthly |
float |
40 |
The maximum monthly price in US Dollars for this Subscription tier. |
plan-update
Update your Longview plan to that of the given subscription ID.
Usage
The format accepted by this command.
linode-cli longview plan-update [-h]
[--longview_subscription longview_subscription]
Sample
Examples of how this command might be used.
linode-cli longview plan-update --longview_subscription longview-10
Arguments
Additional fields used to execute this request.
Name |
Type |
Example |
Description |
---|---|---|---|
--longview_subscription |
str |
longview-10 |
(nullable) The subscription ID for a particular Longview plan. |
Result Attributes
The attributes returned by this command.
Name |
Type |
Example |
Description |
---|---|---|---|
clients_included |
int |
10 |
The number of Longview Clients that may be created with this Subscription tier. |
id |
str |
longview-10 |
The unique ID of this Subscription tier. |
label |
str |
Longview Pro 10 pack |
A display name for this Subscription tier. |
price
Name |
Type |
Example |
Description |
---|---|---|---|
price.hourly |
float |
0.06 |
The hourly price, in US dollars, for this Subscription tier. |
price.monthly |
float |
40 |
The maximum monthly price in US Dollars for this Subscription tier. |
subscription-view
Get the Longview plan details as a single LongviewSubscription
object for the provided subscription ID.
Usage
The format accepted by this command.
linode-cli longview subscription-view [-h] [--order-by {}]
[--order {asc,desc}] subscriptionId
Sample
Examples of how this command might be used.
linode-cli longview subscription-view \
longview-10
Parameters
Positional parameters used to define the resource this command should target.
Name |
Type |
Description |
---|---|---|
subscriptionId |
str |
The Longview Subscription to look up. |
Result Attributes
The attributes returned by this command.
Name |
Type |
Example |
Description |
---|---|---|---|
clients_included |
int |
10 |
The number of Longview Clients that may be created with this Subscription tier. |
id |
str |
longview-10 |
The unique ID of this Subscription tier. |
label |
str |
Longview Pro 10 pack |
A display name for this Subscription tier. |
price
Name |
Type |
Example |
Description |
---|---|---|---|
price.hourly |
float |
0.06 |
The hourly price, in US dollars, for this Subscription tier. |
price.monthly |
float |
40 |
The maximum monthly price in US Dollars for this Subscription tier. |
subscriptions-list
Returns a paginated list of available Longview Subscriptions.
Usage
The format accepted by this command.
linode-cli longview subscriptions-list [-h] [--order-by {}]
[--order {asc,desc}]
Sample
Examples of how this command might be used.
linode-cli longview subscriptions-list
Result Attributes
The attributes returned by this command.
Name |
Type |
Example |
Description |
---|---|---|---|
clients_included |
int |
10 |
The number of Longview Clients that may be created with this Subscription tier. |
id |
str |
longview-10 |
The unique ID of this Subscription tier. |
label |
str |
Longview Pro 10 pack |
A display name for this Subscription tier. |
price
Name |
Type |
Example |
Description |
---|---|---|---|
price.hourly |
float |
0.06 |
The hourly price, in US dollars, for this Subscription tier. |
price.monthly |
float |
40 |
The maximum monthly price in US Dollars for this Subscription tier. |