Grok 1.3 â Installation Guide System Requirements Server Installation
Grok 1.3 – Installation Guide This installation guide applies to both ‘Grok – Free Edition’ and ‘Grok – Standard Edition’ products.
System Requirements
Grok AMI is available in the AWS Marketplace and installation requires a dedicated AWS EC2 instance (m1.medium or larger). The number of instances (or custom metrics) that can be monitored depends on the Grok Edition in use and the size of the underlying EC2 Instance. o Grok – Free Edition: Up to 10 instances or custom metrics o Grok – Standard Edition: 30-200 instances or custom metrics, depending on the size of the EC2 Server running Grok per the table below
min
Summary Standard Medium (m1.medium) Standard Large (m1.large) Standard XL (m1.xlarge) M3 Extra Large (m3.xlarge) M3 Double Extra Large (m3.2xlarge)
Max Instances (or Custom Metrics) 30 60 115 115 200
Grok supports a 5 monitoring frequency Cloudwatch custom
for and metrics at this time. Platforms Supported: o Smartphone: Google Android 4.0.3 and higher (Ice Cream Sandwich and Jelly Bean). Support for IOS and Web clients is currently not available but is under evaluation. o Desktop Web Browser: Google Chrome, IE 9.0+, Safari 6.0+, Firefox 23.0+.
Server Installation Once the Grok Instance is launched, go to the URL of the machine (refer to Note on URL, below) in a web browser to configure Instances for Monitoring.
Step 1: Get started and View/Accept Terms
Step 2: Enter your AWS credentials Although you can simply provide Grok your regular AWS credentials, we strongly recommend creating a separate set of read only credentials using the AWS IAM capability. For details, please see: http://bit.ly/1kjW5aH Grok 1.3 Installation Updated: April 20, 2014
Page 1 Email: [email protected]
Step 3: Register with Grok This step allows you to register your product with Grok. We will not SPAM you or sell your email. We may send you new product information and the option to try Beta features. Registration is optional.
Grok 1.3 Installation Updated: April 20, 2014
Page 2 Email: [email protected]
Step 4: Select Instances or Custom Metrics to Monitor
The following methods are available to add Instances for Monitoring by Grok. You can use one or more methods to select Instances – Method A – Select Automatically Method B – Select Manually Method C – Import Previous Selections Method D – Select Autostacks The current and latest selection of Instances is displayed on the right. For details and examples of adding Custom Metrics, please refer to the “Custom Metrics Guide”. Please note that Grok supports monitoring of AWS Auto Scaling Groups (ASG). AWS ASG’s can be added to Grok similar to an AWS Instance using Methods A-C.
Grok 1.3 Installation Updated: April 20, 2014
Page 3 Email: [email protected]
Step 4A). Select Automatically Instances can be selected automatically using AWS Region filters and an additional selection of AWS Name Tags.
Step 4B). Select Manually
Step 4C). Import Previous Selections Any previously saved list of Instances and Metrics can be also be exported and saved, to be brought back at a later time, in Step 4c).
Grok 1.3 Installation Updated: April 20, 2014
Page 4 Email: [email protected]
Step 4D). Select Autostacks Grok has created a new construct called an Autostack for monitoring a dynamic group of logically related EC2 Servers. Autostacks are monitored as a group and viewed as a single "Instance" within Grok. The only requirements are for Instances or ASG’s within an Autostack to be logically doing the same thing, located in the same region and be previously tagged with the same AWS Tag. Autostacks can be created and members selected in 4b). You must give the Autostack a unique name.
Once you click on “Find Members”, you can review members of the Autostack and then create the Autostack. Please note that once created, we do not allow editing the names, region or Tag filters of an Autostack. Should there be a need for change, we recommend creating a new Autostack.
Selecting Metrics Select the the region, individual Grok 1.3 Installation Updated: April 20, 2014
metrics that you’d like to measure by expanding namespace/dimension and then click on an instance or Autostack. This will cause a pop-up Page 5 Email: [email protected]
menu to appear with the metrics available for that instance or Autostack. Some metrics are chosen by default and you can change these selections. Repeat for each of the instances and metrics you’d like to monitor. Don’t worry, you can always come back and add more later. Grok will remember each selection as you click through the page. For Autostacks, in addition to Metric details, you will be able to view details of the Autostack itself including AWS Region, Function and Members.
Grok’s Cortical Learning Algorithm (CLA) will begin building models of the Selected Instances immediately. The Instance will stay in “Training” while the model is still in the Learning-only phase. The state will move to “Active” when the Instance is actively being monitored.
Step 5: Notification Settings The next step involves setting up an Email and AWS Region which will be used to send email via Amazon's push messaging service Simple Email Service (Amazon SES). Should you want email notifications sent to you by Grok this step is required in conjunction with enabling Email Notification on the mobile client. Please note that additional charges may apply for Amazon SES (http://aws.amazon.com/ses/)
Grok 1.3 Installation Updated: April 20, 2014
Page 6 Email: [email protected]
Server Setup Complete The Grok Server Setup is now complete. Please use the URL shown to access the Grok server.
NOTE ON URL Grok recommends setting up a Route53 entry for the server to give it a friendly URL. 1. Copy the EC2 public DNS name of the instance you want to create a human-useful pointer for. 2. Go to the Route53 page 3. Double-click the domain you’d like to use in the list of hosted zones (e.g.: groksolutions.com). You should now see a list of DNS entries for the domain. 4. Search for the name you're going to add to ensure no one else has already used it. 5. Click the "Create Record Set" button 6. Add a CNAME record (e.g.: grokbeta.groksolutions.com), and set it to point to the public DNS name you got in step 1 7. Set the TTL to 60 seconds 8. Save. You should be able to reference the new DNS name almost immediately.
Grok 1.3 Installation Updated: April 20, 2014
Page 7 Email: [email protected]
Mobile App Installation The next step is to install and setup the Grok Android Application on a Mobile Phone. The Server URL and password shown in the screen below will need to be entered into the Mobile Application.
On the Android Phone: 1. Install Grok app via the Play store: a. https://play.google.com/store/apps/details?id=com.groksolutions.grok.mobile b. Click the install button c. Select your mobile device and click Install d. Click the OK button. Grok will now be automatically installed to your mobile device Or, Search for “Grok” in the Play store to install from your device!
2. Configure the Grok app Enter the server details from your instance and password provided at the end of the server installation process. 3. Start using the Grok app!
NOTE The first time you load the app, it will take a few minutes to download all of the data. For details on using the app including reading the charts, please see the Grok User Guide.
Grok 1.3 Installation Updated: April 20, 2014
Page 8 Email: [email protected]
Maintaining and Editing Grok Server Settings The previous steps can be re-visited to view, edit or change anytime from a drop down list on the top right under Setup
Over time, you may want to add additional metrics to monitor. That’s as simple as repeating “Step 2: Enter your AWS credentials Although you can simply provide Grok your regular AWS credentials, we strongly recommend creating a separate set of read only credentials using the AWS IAM capability. For details, please see: http://bit.ly/1kjW5aH
Step 3: Register with Grok This step allows you to register your product with Grok. We will not SPAM you or sell your email. We may send you new product information and the option to try Beta features. Registration is optional.
Grok 1.3 Installation Updated: April 20, 2014
Page 9 Email: [email protected]
Grok 1.3 Installation Updated: April 20, 2014
Page 10 Email: [email protected]
Step 4: Select Instances or Custom Metrics to Monitor
The following methods are available to add Instances for Monitoring by Grok. You can use one or more methods to select Instances – Method A – Select Automatically Method B – Select Manually Method C – Import Previous Selections Method D – Select Autostacks The current and latest selection of Instances is displayed on the right. For details and examples of adding Custom Metrics, please refer to the “Custom Metrics Guide”. Please note that Grok supports monitoring of AWS Auto Scaling Groups (ASG). AWS ASG’s can be added to Grok similar to an AWS Instance using Methods A-C.
Grok 1.3 Installation Updated: April 20, 2014
Page 11 Email: [email protected]
Step 4A). Select Automatically Instances can be selected automatically using AWS Region filters and an additional selection of AWS Name Tags.
Step 4B). Select Manually ”. You can easily get back there by using your web browser to go to your instance (https://). You’ll then have the option to Select New Instances to Monitor: To remove metrics, you’ll just need to browse to your instance (as above) and use the select boxes to choose which instances you’d like to delete from monitoring, then hit the Delete button.
NOTE If one of the instances ends up in an “Error” status, you can simply delete the instance and re-add it.
Updating the Grok Server When updates to the Grok Server are available, they will automatically appear as an option on the top of the screen.
Grok 1.3 Installation Updated: April 20, 2014
Page 12 Email: [email protected]
System Requirements
Grok AMI is available in the AWS Marketplace and installation requires a dedicated AWS EC2 instance (m1.medium or larger). The number of instances (or custom metrics) that can be monitored depends on the Grok Edition in use and the size of the underlying EC2 Instance. o Grok – Free Edition: Up to 10 instances or custom metrics o Grok – Standard Edition: 30-200 instances or custom metrics, depending on the size of the EC2 Server running Grok per the table below
min
Summary Standard Medium (m1.medium) Standard Large (m1.large) Standard XL (m1.xlarge) M3 Extra Large (m3.xlarge) M3 Double Extra Large (m3.2xlarge)
Max Instances (or Custom Metrics) 30 60 115 115 200
Grok supports a 5 monitoring frequency Cloudwatch custom
for and metrics at this time. Platforms Supported: o Smartphone: Google Android 4.0.3 and higher (Ice Cream Sandwich and Jelly Bean). Support for IOS and Web clients is currently not available but is under evaluation. o Desktop Web Browser: Google Chrome, IE 9.0+, Safari 6.0+, Firefox 23.0+.
Server Installation Once the Grok Instance is launched, go to the URL of the machine (refer to Note on URL, below) in a web browser to configure Instances for Monitoring.
Step 1: Get started and View/Accept Terms
Step 2: Enter your AWS credentials Although you can simply provide Grok your regular AWS credentials, we strongly recommend creating a separate set of read only credentials using the AWS IAM capability. For details, please see: http://bit.ly/1kjW5aH Grok 1.3 Installation Updated: April 20, 2014
Page 1 Email: [email protected]
Step 3: Register with Grok This step allows you to register your product with Grok. We will not SPAM you or sell your email. We may send you new product information and the option to try Beta features. Registration is optional.
Grok 1.3 Installation Updated: April 20, 2014
Page 2 Email: [email protected]
Step 4: Select Instances or Custom Metrics to Monitor
The following methods are available to add Instances for Monitoring by Grok. You can use one or more methods to select Instances – Method A – Select Automatically Method B – Select Manually Method C – Import Previous Selections Method D – Select Autostacks The current and latest selection of Instances is displayed on the right. For details and examples of adding Custom Metrics, please refer to the “Custom Metrics Guide”. Please note that Grok supports monitoring of AWS Auto Scaling Groups (ASG). AWS ASG’s can be added to Grok similar to an AWS Instance using Methods A-C.
Grok 1.3 Installation Updated: April 20, 2014
Page 3 Email: [email protected]
Step 4A). Select Automatically Instances can be selected automatically using AWS Region filters and an additional selection of AWS Name Tags.
Step 4B). Select Manually
Step 4C). Import Previous Selections Any previously saved list of Instances and Metrics can be also be exported and saved, to be brought back at a later time, in Step 4c).
Grok 1.3 Installation Updated: April 20, 2014
Page 4 Email: [email protected]
Step 4D). Select Autostacks Grok has created a new construct called an Autostack for monitoring a dynamic group of logically related EC2 Servers. Autostacks are monitored as a group and viewed as a single "Instance" within Grok. The only requirements are for Instances or ASG’s within an Autostack to be logically doing the same thing, located in the same region and be previously tagged with the same AWS Tag. Autostacks can be created and members selected in 4b). You must give the Autostack a unique name.
Once you click on “Find Members”, you can review members of the Autostack and then create the Autostack. Please note that once created, we do not allow editing the names, region or Tag filters of an Autostack. Should there be a need for change, we recommend creating a new Autostack.
Selecting Metrics Select the the region, individual Grok 1.3 Installation Updated: April 20, 2014
metrics that you’d like to measure by expanding namespace/dimension and then click on an instance or Autostack. This will cause a pop-up Page 5 Email: [email protected]
menu to appear with the metrics available for that instance or Autostack. Some metrics are chosen by default and you can change these selections. Repeat for each of the instances and metrics you’d like to monitor. Don’t worry, you can always come back and add more later. Grok will remember each selection as you click through the page. For Autostacks, in addition to Metric details, you will be able to view details of the Autostack itself including AWS Region, Function and Members.
Grok’s Cortical Learning Algorithm (CLA) will begin building models of the Selected Instances immediately. The Instance will stay in “Training” while the model is still in the Learning-only phase. The state will move to “Active” when the Instance is actively being monitored.
Step 5: Notification Settings The next step involves setting up an Email and AWS Region which will be used to send email via Amazon's push messaging service Simple Email Service (Amazon SES). Should you want email notifications sent to you by Grok this step is required in conjunction with enabling Email Notification on the mobile client. Please note that additional charges may apply for Amazon SES (http://aws.amazon.com/ses/)
Grok 1.3 Installation Updated: April 20, 2014
Page 6 Email: [email protected]
Server Setup Complete The Grok Server Setup is now complete. Please use the URL shown to access the Grok server.
NOTE ON URL Grok recommends setting up a Route53 entry for the server to give it a friendly URL. 1. Copy the EC2 public DNS name of the instance you want to create a human-useful pointer for. 2. Go to the Route53 page 3. Double-click the domain you’d like to use in the list of hosted zones (e.g.: groksolutions.com). You should now see a list of DNS entries for the domain. 4. Search for the name you're going to add to ensure no one else has already used it. 5. Click the "Create Record Set" button 6. Add a CNAME record (e.g.: grokbeta.groksolutions.com), and set it to point to the public DNS name you got in step 1 7. Set the TTL to 60 seconds 8. Save. You should be able to reference the new DNS name almost immediately.
Grok 1.3 Installation Updated: April 20, 2014
Page 7 Email: [email protected]
Mobile App Installation The next step is to install and setup the Grok Android Application on a Mobile Phone. The Server URL and password shown in the screen below will need to be entered into the Mobile Application.
On the Android Phone: 1. Install Grok app via the Play store: a. https://play.google.com/store/apps/details?id=com.groksolutions.grok.mobile b. Click the install button c. Select your mobile device and click Install d. Click the OK button. Grok will now be automatically installed to your mobile device Or, Search for “Grok” in the Play store to install from your device!
2. Configure the Grok app Enter the server details from your instance and password provided at the end of the server installation process. 3. Start using the Grok app!
NOTE The first time you load the app, it will take a few minutes to download all of the data. For details on using the app including reading the charts, please see the Grok User Guide.
Grok 1.3 Installation Updated: April 20, 2014
Page 8 Email: [email protected]
Maintaining and Editing Grok Server Settings The previous steps can be re-visited to view, edit or change anytime from a drop down list on the top right under Setup
Over time, you may want to add additional metrics to monitor. That’s as simple as repeating “Step 2: Enter your AWS credentials Although you can simply provide Grok your regular AWS credentials, we strongly recommend creating a separate set of read only credentials using the AWS IAM capability. For details, please see: http://bit.ly/1kjW5aH
Step 3: Register with Grok This step allows you to register your product with Grok. We will not SPAM you or sell your email. We may send you new product information and the option to try Beta features. Registration is optional.
Grok 1.3 Installation Updated: April 20, 2014
Page 9 Email: [email protected]
Grok 1.3 Installation Updated: April 20, 2014
Page 10 Email: [email protected]
Step 4: Select Instances or Custom Metrics to Monitor
The following methods are available to add Instances for Monitoring by Grok. You can use one or more methods to select Instances – Method A – Select Automatically Method B – Select Manually Method C – Import Previous Selections Method D – Select Autostacks The current and latest selection of Instances is displayed on the right. For details and examples of adding Custom Metrics, please refer to the “Custom Metrics Guide”. Please note that Grok supports monitoring of AWS Auto Scaling Groups (ASG). AWS ASG’s can be added to Grok similar to an AWS Instance using Methods A-C.
Grok 1.3 Installation Updated: April 20, 2014
Page 11 Email: [email protected]
Step 4A). Select Automatically Instances can be selected automatically using AWS Region filters and an additional selection of AWS Name Tags.
Step 4B). Select Manually ”. You can easily get back there by using your web browser to go to your instance (https://). You’ll then have the option to Select New Instances to Monitor: To remove metrics, you’ll just need to browse to your instance (as above) and use the select boxes to choose which instances you’d like to delete from monitoring, then hit the Delete button.
NOTE If one of the instances ends up in an “Error” status, you can simply delete the instance and re-add it.
Updating the Grok Server When updates to the Grok Server are available, they will automatically appear as an option on the top of the screen.
Grok 1.3 Installation Updated: April 20, 2014
Page 12 Email: [email protected]
