Terraform for Site24x7

Terraform is an Infrastructure as Code tool that helps to create, edit, and manage cloud resources easily and efficiently. You can use Terraform to manage your Site24x7 resources through code by following some simple steps. You can add, update, or delete your resources, and handle administration-related updates in Site24x7 using Terraform.

Table of contents

• Benefits of using Terraform
• Supported resources in Site24x7
• How to add Site24x7 resources using Terraform

Benefits of using Terraform

• Ensure error-free deployments
• Handle heterogeneous cloud deployments for fault tolerance
• Collaborate, obtain specific versions, and create your own environment
• Spawn and remove testing environments easily
• Improve deployment speeds
• Build, version, or change infrastructure safely and efficiently
• Trace and correct configuration-level issues

Supported resources in Site24x7

You can create, edit, or delete the following resources in Site24x7 by using Terraform:

• Website Monitor 
• DNS Server Monitor
• Web Page Speed (Browser) Monitor
• SSL Certificate Expiry Monitor
• Rest API Monitor
• Server Monitor
• Heartbeat Monitor
• URL IT Automation
• Monitor Group
• Threshold Profile
• Location Profile
• Notification Profile
• User Group
• User
• Tags
• Schedule Maintenance

Integrations

Steps to generate Site24x7 OAuth credentials 

Site24x7 REST APIs use OAuth 2.0 protocol to authorize and authenticate calls. To generate Site24x7 OAuth credentials (SITE24X7_OAUTH2_CLIENT_ID, SITE24X7_OAUTH2_CLIENT_SECRET and SITE24X7_OAUTH2_REFRESH_TOKEN), please follow the following steps:

1. Visit https://api-console.zoho.com/
   
2. Choose the self client option.
3. Copy the Client ID and Client Secret, and paste them in the curl command below.
4. Copy the following and paste it in the scope field and click Create.
   
   Site24x7.account.All,Site24x7.admin.All,Site24x7.reports.All,Site24x7.operations.All,Site24x7.msp.All,Site24x7.bu.All .
5. Copy the generated code, paste it in the command below and execute the same.
   
   curl https://accounts.zoho.com/oauth/v2/token
   -X POST
   -d "client_id=<CLIENT_ID>"
   -d "client_secret=<CLIENT_SECRET>"
   -d "code=<GENERATED_CODE>"
   -d "grant_type=authorization_code" --insecure
6. The response for the command given above will be similar to the one given below.
   {"access_token":"1000.dfsewerwe33.rterert23","refresh_token":"1000.abdfdf.32dsfsdf","token_type":"Bearer","expires_in":3600}
7. Copy the CLIENT_ID, CLIENT_SECRET, refresh_token and configure them in your terraform configuration file for the attributes oauth2_client_id, oauth2_client_secret, oauth2_refresh_token respectively.

• United States (US) - https://accounts.zoho.com and https://api-console.zoho.com
• Europe (EU) - https://accounts.zoho.eu and https://api-console.zoho.eu
• China (CN) - https://accounts.zoho.com.cn and https://api-console.zoho.com.cn
• India (IN) - https://accounts.zoho.in and https://api-console.zoho.in
• Australia (AU) - https://accounts.zoho.com.au and https://api-console.zoho.com.au

How to add Site24x7 resources using Terraform

Bootstrap Terraform and the Site24x7 provider

Add the content below to your Terraform configuration file to bootstrap Terraform and the Site24x7 provider.

Set your Site24x7 OAuth credentials in the bash environment

You need to export your Site24x7 OAuth credentials before applying your configuration. To do so, execute the following shell commands:

Configuring the Site24x7 provider in Terraform

You can use the following command to configure Site24x7 as a provider in Terraform:

data_center
Specify the data center for your account accordingly. For example, if your data center is in the United States, then your value will be data_center="US". 

oauth2_client_id
The client ID will be looked up in the SITE24X7_OAUTH2_CLIENT_ID environment variable if the attribute is empty.

oauth2_client_secret
The client secret will be looked up in the SITE24X7_OAUTH2_CLIENT_SECRET environment variable if the attribute is empty.

oauth2_refresh_token
The refresh token will be looked up in the SITE24X7_OAUTH2_REFRESH_TOKEN environment variable if the attribute is empty.

retry_min_wait
Specify the minimum wait time in seconds before retrying the failed Site24x7 API requests.

retry_max_wait
Specify the maximum wait time in seconds before retrying the failed Site24x7 API requests.

max_retries
Specify the maximum number of Site24x7 API request retries to be performed before aborting the action.

Creating a resource

By creating monitors in Site24x7, you can track the performance and metrics of your websites, infrastructure, and network devices.

For instance, to create a website monitor for your environment, you can paste the configuration below into your Terraform file:

• The display name is the name you have to provide for your website monitor.
• The website is the URL that needs to be monitored.
• Check frequency stands for the frequency at which the polling should be conducted.
• The location profile is the location from where you'd like to monitor your resources. You can specify either location_profile_id or location_profile_name. If neither is specified, the first profile returned by the /api/location_profiles endpoint (https://www.site24x7.com/help/api/#list-of-all-location-profiles) will be used.

Applying the configuration in Terraform

You can execute the command terraform init to initialize the provider, and then execute terraform apply to apply the configuration defined in your Terraform file. Terraform will perform the following actions:

Terraform will create the website monitor but change nothing else. Every Terraform apply configuration compares your template to the state of the resources that Terraform has handled previously. If this is the first Terraform configuration you're applying, it won't make any changes to the existing configurations.

View the newly created monitor in Site24x7 by logging in to Site24x7 and navigating to Home > Monitors. Then, choose the monitor of your preference.

To import monitors and generate configurations, navigate to Github.

Please feel free to request support for features of your preference at Github or on the Site24x7 community forum.