prometheusservice function

Amazon Prometheus Service

Amazon Prometheus Service

Amazon Managed Service for Prometheus is a serverless, Prometheus-compatible monitoring service for container metrics that makes it easier to securely monitor container environments at scale. With Amazon Managed Service for Prometheus, you can use the same open-source Prometheus data model and query language that you use today to monitor the performance of your containerized workloads, and also enjoy improved scalability, availability, and security without having to manage the underlying infrastructure.

For more information about Amazon Managed Service for Prometheus, see the Amazon Managed Service for Prometheus

User Guide.

Amazon Managed Service for Prometheus includes two APIs.

  • Use the Amazon Web Services API described in this guide to manage Amazon Managed Service for Prometheus resources, such as workspaces, rule groups, and alert managers.

  • Use the Prometheus-compatible API

    to work within your Prometheus workspace.

prometheusservice( config = list(), credentials = list(), endpoint = NULL, region = NULL )

Arguments

  • config: Optional configuration of credentials, endpoint, and/or region.

    • credentials :

      • creds :

        • access_key_id : AWS access key ID
        • secret_access_key : AWS secret access key
        • session_token : AWS temporary session token
      • profile : The name of a profile to use. If not given, then the default profile is used.

      • anonymous : Set anonymous credentials.

    • endpoint : The complete URL to use for the constructed client.

    • region : The AWS Region used in instantiating the client.

    • close_connection : Immediately close all HTTP connections.

    • timeout : The time in seconds till a timeout exception is thrown when attempting to make a connection. The default is 60 seconds.

    • s3_force_path_style : Set this to true to force the request to use path-style addressing, i.e. http://s3.amazonaws.com/BUCKET/KEY.

    • sts_regional_endpoint : Set sts regional endpoint resolver to regional or legacy https://docs.aws.amazon.com/sdkref/latest/guide/feature-sts-regionalized-endpoints.html

  • credentials: Optional credentials shorthand for the config parameter

    • creds :

      • access_key_id : AWS access key ID
      • secret_access_key : AWS secret access key
      • session_token : AWS temporary session token
    • profile : The name of a profile to use. If not given, then the default profile is used.

    • anonymous : Set anonymous credentials.

  • endpoint: Optional shorthand for complete URL to use for the constructed client.

  • region: Optional shorthand for AWS Region used in instantiating the client.

Returns

A client for the service. You can call the service's operations using syntax like svc$operation(...), where svc is the name you've assigned to the client. The available operations are listed in the Operations section.

Service syntax

svc <- prometheusservice(
  config = list(
    credentials = list(
 creds = list(
   access_key_id = "string",
   secret_access_key = "string",
   session_token = "string"
 ),
 profile = "string",
 anonymous = "logical"
    ),
    endpoint = "string",
    region = "string",
    close_connection = "logical",
    timeout = "numeric",
    s3_force_path_style = "logical",
    sts_regional_endpoint = "string"
  ),
  credentials = list(
    creds = list(
 access_key_id = "string",
 secret_access_key = "string",
 session_token = "string"
    ),
    profile = "string",
    anonymous = "logical"
  ),
  endpoint = "string",
  region = "string"
)

Operations

create_alert_manager_definitionThe CreateAlertManagerDefinition operation creates the alert manager definition in a workspace
create_logging_configurationThe CreateLoggingConfiguration operation creates a logging configuration for the workspace
create_rule_groups_namespaceThe CreateRuleGroupsNamespace operation creates a rule groups namespace within a workspace
create_scraperThe CreateScraper operation creates a scraper to collect metrics
create_workspaceCreates a Prometheus workspace
delete_alert_manager_definitionDeletes the alert manager definition from a workspace
delete_logging_configurationDeletes the logging configuration for a workspace
delete_rule_groups_namespaceDeletes one rule groups namespace and its associated rule groups definition
delete_scraperThe DeleteScraper operation deletes one scraper, and stops any metrics collection that the scraper performs
delete_workspaceDeletes an existing workspace
describe_alert_manager_definitionRetrieves the full information about the alert manager definition for a workspace
describe_logging_configurationReturns complete information about the current logging configuration of the workspace
describe_rule_groups_namespaceReturns complete information about one rule groups namespace
describe_scraperThe DescribeScraper operation displays information about an existing scraper
describe_workspaceReturns information about an existing workspace
get_default_scraper_configurationThe GetDefaultScraperConfiguration operation returns the default scraper configuration used when Amazon EKS creates a scraper for you
list_rule_groups_namespacesReturns a list of rule groups namespaces in a workspace
list_scrapersThe ListScrapers operation lists all of the scrapers in your account
list_tags_for_resourceThe ListTagsForResource operation returns the tags that are associated with an Amazon Managed Service for Prometheus resource
list_workspacesLists all of the Amazon Managed Service for Prometheus workspaces in your account
put_alert_manager_definitionUpdates an existing alert manager definition in a workspace
put_rule_groups_namespaceUpdates an existing rule groups namespace within a workspace
tag_resourceThe TagResource operation associates tags with an Amazon Managed Service for Prometheus resource
untag_resourceRemoves the specified tags from an Amazon Managed Service for Prometheus resource
update_logging_configurationUpdates the log group ARN or the workspace ID of the current logging configuration
update_scraperUpdates an existing scraper
update_workspace_aliasUpdates the alias of an existing workspace

Examples

## Not run: svc <- prometheusservice() svc$create_alert_manager_definition( Foo = 123 ) ## End(Not run)
  • Maintainer: Dyfan Jones
  • License: Apache License (>= 2.0)
  • Last published: 2025-03-17