A Sematext Cloud API client, for interaction with Sematext Cloud solution monitoring, alerting and log shipping.
One of a family of clients in following flavours:
- sematext-api-client-javascript
- sematext-api-client-rust
- sematext-api-client-ruby
- sematext-api-client-python
- sematext-api-client-php
- sematext-api-client-java
- sematext-api-client-go
Refer to below link for deeper information on the API itself.
Contents
-
sematext-api-client-ruby
- Contents
- Installation
- Build a gem
- Install from Git
- Include the Ruby code directly
- Authentication
- Getting Started
- Reference
- Documentation for Models
Installation
Build a gem
To build the Ruby code into a gem:
gem build stcloud.gemspec
Then either install the gem locally:
gem install ./SematextCloud-0.1.3.gem
(for development, run gem install --dev ./SematextCloud-0.1.3.gem
to install the development dependencies)
or publish the gem to a gem hosting service, e.g. RubyGems.
Finally add this to the Gemfile:
gem 'SematextCloud', '~> 0.1.3'
Install from Git
If the Ruby gem is hosted at a git repository: https://github.com/GIT_USER_ID/GIT_REPO_ID, then add the following in the Gemfile:
gem 'SematextCloud', :git => 'https://github.com/sematext/sematext-api-client-ruby.git'
Include the Ruby code directly
Include the Ruby code directly using -I
as follows:
ruby -Ilib script.rb
Authentication
This client code requires a Sematext API Access token to function. You can find this by logging into your Sematext Cloud Account
Getting Started
Please follow the installation procedure and then run the following code:
# Load the gem
require 'SematextCloud'
# Setup authorization
SematextCloud.configure do |config|
# Configure API key authorization: api_key
config.api_key['Authorization'] = 'YOUR API KEY'
# Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
#config.api_key_prefix['Authorization'] = 'Bearer'
end
api_instance = SematextCloud::AlertNotificationsApi.new
app_id = 789 # Integer | appId
time_interval = SematextCloud::AlertNotificationRequest.new # AlertNotificationRequest | Time Interval
begin
#Get alert notifications for an app
result = api_instance.get_alert_notifications_for_app_using_post(app_id, time_interval)
p result
rescue SematextCloud::ApiError => e
puts "Exception when calling AlertNotificationsApi->get_alert_notifications_for_app_using_post: #{e}"
end
Reference
All URIs are relative to https://localhost
Class | Method | HTTP request | Description |
---|---|---|---|
stcloud::AlertNotificationsApi | get_alert_notifications_for_app_using_post | POST /users-web/api/v3/apps/{appId}/notifications/alerts | Get alert notifications for an app |
stcloud::AlertNotificationsApi | get_alert_notifications_for_user_using_post1 | POST /users-web/api/v3/notifications/alerts | Get alert notifications for a user |
stcloud::AlertsApi | create_alert_using_post | POST /users-web/api/v3/alerts | Create alert rule |
stcloud::AlertsApi | delete_alert_rule_using_delete1 | DELETE /users-web/api/v3/alerts/{updateableAlertId} | Delete alert rule |
stcloud::AlertsApi | disable_alert_rule_using_put1 | PUT /users-web/api/v3/alerts/{updateableAlertId}/disable | Disable alert rule |
stcloud::AlertsApi | enable_alert_rule_using_put1 | PUT /users-web/api/v3/alerts/{updateableAlertId}/enable | Enable alert rule |
stcloud::AlertsApi | get_alert_rules_for_app_using_get1 | GET /users-web/api/v3/apps/{appId}/alerts | Get alert rules for an app |
stcloud::AppsApi | delete_using_delete1 | DELETE /users-web/api/v3/apps/{anyStateAppId} | delete |
stcloud::AppsApi | get_app_types_using_get | GET /users-web/api/v3/apps/types | Get all App types supported for the account identified with apiKey |
stcloud::AppsApi | get_using_get1 | GET /users-web/api/v3/apps/{anyStateAppId} | Gets defails for one particular App |
stcloud::AppsApi | invite_app_guests_using_post1 | POST /users-web/api/v3/apps/guests | Invite guests to an app |
stcloud::AppsApi | list_apps_users_using_get1 | GET /users-web/api/v3/apps/users | Get all users of apps accessible to this account |
stcloud::AppsApi | list_using_get | GET /users-web/api/v3/apps | Get all apps accessible by account identified with apiKey |
stcloud::AppsApi | update_description_using_put | PUT /users-web/api/v3/apps/{anyStateAppId}/description | Update description of the app |
stcloud::AppsApi | update_using_put2 | PUT /users-web/api/v3/apps/{anyStateAppId} | Update app |
stcloud::AwsSettingsControllerApi | update_using_put | PUT /users-web/api/v3/apps/{appId}/aws | Update App's AWS CloudWatch settings |
stcloud::BillingApi | get_detailed_invoice_using_get1 | GET /users-web/api/v3/billing/invoice/{service}/{year}/{month} | Get invoice details |
stcloud::BillingApi | list_available_plans_using_get | GET /users-web/api/v3/billing/availablePlans | Get available plans |
stcloud::BillingApi | update_plan_using_put | PUT /users-web/api/v3/billing/info/{appId} | Update plan for an app |
stcloud::LogsAppApi | create_logsene_application | POST /logsene-reports/api/v3/apps | Create Logs App |
stcloud::MonitoringAppApi | create_spm_application1 | POST /spm-reports/api/v3/apps | Create Monitoring App |
stcloud::ResetPasswordApi | reset_password_using_post1 | POST /users-web/api/v3/account/password/reset | Reset Password |
stcloud::SubscriptionsApi | create_for_app_using_post1 | POST /users-web/api/v3/apps/{appId}/subscription | Create App subscription |
stcloud::SubscriptionsApi | create_for_dash_using_post1 | POST /users-web/api/v3/dashboards/{dashId}/subscription | Create dashboard subscription |
stcloud::SubscriptionsApi | delete_using_delete3 | DELETE /users-web/api/v3/subscriptions/{updateableSubscriptionId} | Delete subscription |
stcloud::SubscriptionsApi | list_using_get3 | GET /users-web/api/v3/apps/{appId}/subscriptions | Get subscriptions for an App |
stcloud::SubscriptionsApi | list_using_get4 | GET /users-web/api/v3/subscriptions | Get current account's subscriptions |
stcloud::SubscriptionsApi | send_app_report_using_post1 | POST /users-web/api/v3/apps/{appId}/report/send | Email an App report |
stcloud::SubscriptionsApi | send_dash_report_using_post1 | POST /users-web/api/v3/dashboards/{dashId}/report/send | Email a dashboard report |
stcloud::SubscriptionsApi | toggle_enabled_using_put1 | PUT /users-web/api/v3/subscriptions/{updateableSubscriptionId} | Toggle subscription status |
stcloud::SubscriptionsApi | update_for_app_using_put | PUT /users-web/api/v3/apps/{appId}/subscription | Update App subscription |
stcloud::SubscriptionsApi | update_for_dash_using_put1 | PUT /users-web/api/v3/dashboards/{dashId}/subscription | Update dashboard subscription |
stcloud::TagApiControllerApi | get_tag_names_using_get1 | GET /spm-reports/api/v3/apps/{appIds}/tagNames | Gets tag names for the given application identifiers appearing in the given time frame. |
stcloud::TagApiControllerApi | get_using_get1 | GET /spm-reports/api/v3/apps/{appIds}/tags | Gets values for specified tags for the given application identifiers appearing in the given time frame. |
stcloud::TagApiControllerApi | get_using_get2 | GET /spm-reports/api/v3/apps/{appIds}/metrics/filters | Gets values for specified tags for the given application identifiers appearing in the given time frame. |
stcloud::TokensApiControllerApi | create_app_token1 | POST /users-web/api/v3/apps/{appId}/tokens | Create new app token |
stcloud::TokensApiControllerApi | delete_app_token1 | DELETE /users-web/api/v3/apps/{appId}/tokens/{tokenId} | Delete app token |
stcloud::TokensApiControllerApi | get_app_tokens | GET /users-web/api/v3/apps/{appId}/tokens | Get app available tokens |
stcloud::TokensApiControllerApi | regenerate_app_token1 | POST /users-web/api/v3/apps/{appId}/tokens/{tokenId}/regenerate | Regenerate app token) |
stcloud::TokensApiControllerApi | update_app_token | PUT /users-web/api/v3/apps/{appId}/tokens/{tokenId} | Update app token (enable/disable or name) |
Documentation for Models
- stcloud::AlertNotificationRequest
- stcloud::AlertRule
- stcloud::AlertRuleScheduleTimeRangeDto
- stcloud::AlertRuleScheduleWeekdayDto
- stcloud::App
- stcloud::AppDescription
- stcloud::AppMetadata
- stcloud::BasicAuthMethodDto
- stcloud::BasicOrganizationDto
- stcloud::BillingInfo
- stcloud::CloudWatchSettings
- stcloud::CreateAppInfo
- stcloud::CreateTokenDto
- stcloud::Error
- stcloud::FilterValue
- stcloud::GenericApiResponse
- stcloud::Invitation
- stcloud::NotificationIntegration
- stcloud::Plan
- stcloud::ReportInfo
- stcloud::ServiceIntegration
- stcloud::SubscriptionDashboardDto
- stcloud::SubscriptionDto
- stcloud::UpdateAppInfo
- stcloud::UpdateSubscriptionDto
- stcloud::UpdateTokenDto
- stcloud::UserInfo
- stcloud::UserPermissions
- stcloud::UserRole