Apigee Edge is a platform for developing and managing APIs. By fronting services with a proxy layer, Edge provides an abstraction or facade for your backend service APIs and provides security, rate limiting, quotas, analytics, and more.
Organization
A container for all the objects in an Apigee Edge account, including API proxies, API products, API packages, apps, and developers. A user account is required for each organization for which you are a member (most users will have an account in only one organization).
Environment
A runtime execution context for API proxies. An API proxy must be deployed to an environment before the API it exposes is accessible over the network. By default, organizations are provisioned with two environments; test and prod.
- The test environment is typically used for deploying API proxies during development.
- The prod environment is typically used for promoting API proxies from the test environment after they have been fully developed and tested.
Api Proxy
A facade on Edge for one or more APIs, generic HTTP services, or applications (such as Node.js).
An API proxy is implemented as a set of configuration files, policies, and code that rely on a set of resources provided by Apigee Edge. API proxies can be generated and configured using the Apigee Edge management UI, or they can be implemented locally in a text editor or IDE.
The facade provided by an API proxy decouples the developer-facing API from backend services, shielding developers from code changes and enabling innovation at the edge without impacting your internal development teams. As development teams make backend changes, developers continue to call the same interface uninterrupted. Apigee enables you to expose multiple interfaces to the same API, freeing you to customize the signature of an API to meet the needs of various developer niches simultaneously.
Supported Metrics
Click here to view the supported metrics
Resource | Metric Name | Metric Display Name | Units | Description | |
---|---|---|---|---|---|
Environment | apigee_environment_ax_cache_executed | Response Cache Executed | count | The total number of times a Response Cache policy is executed over the given time period. | |
apigee_environment_ax_cache_l1_count | L1 Cache Elements Count | count | Returns the number of elements in L1 (in-memory) cache per transaction over a given time period. | ||
apigee_environment_cache_hit | Cache Hit | count | The number of successful API requests that use the Response Cache instead of the response from the target service. | ||
apigee_environment_is_error | Proxy Errors | count | The total number of times API proxies failed over the specified time period. | ||
apigee_environment_message_count | Traffic | count | The total number of API calls processed by Edge in the specified time period. | ||
apigee_environment_policy_error | Policy Errors | count | The total number of policy errors over the specified time period. | ||
apigee_environment_request_processing_latency | Request Processing Latency | milliseconds | The amount of time (average, minimum, or maximum), in milliseconds, that it takes Edge to process incoming requests. | ||
apigee_environment_request_size | Request Size | bytes | The size of the request payload received by Edge, in bytes. | ||
apigee_environment_response_processing_latency | Response Processing Latency | milliseconds | The amount of time (average, minimum, or maximum), in milliseconds, that it takes Edge to process API responses. | ||
apigee_environment_response_size | Response Size | bytes | The size of the response payload returned to the client, in bytes. | ||
apigee_environment_target_error | Target Errors | count | The total number of 5xx responses from the target service. These are target service errors not caused by Apigee. | ||
apigee_environment_target_latency | Target Latency | count | Target Latency. | ||
apigee_environment_target_response_time | Target Response Time | milliseconds | The amount of time (sum, average, minimum, or maximum), in milliseconds, for the target server to respond to a call. | ||
apigee_environment_total_latency | Total Latency | count | Total Latency. | ||
apigee_environment_total_response_time | Total Response Time | milliseconds | The amount of time (sum, average, minimum, or maximum), in milliseconds, from when Edge receives a request from a client to when Edge sends the response back to the client. | ||
apigee_environment_tps | Average Transactions per Second | count | The average number of transactions, meaning API proxy requests, per second. | ||
API Proxy | apigee_apiproxy_ax_cache_executed | Response Cache Executed | count | The total number of times a Response Cache policy was executed over the given time period. | |
apigee_apiproxy_ax_cache_l1_count | L1 Cache Elements Count | count | Returns the number of elements in L1 (in-memory) cache per transaction over a given time period. | ||
apigee_apiproxy_cache_hit | Cache Hit | count | The number of successful API requests that use the Response Cache instead of the response from the target service. | ||
apigee_apiproxy_is_error | Proxy Errors | count | The total number of times API proxies failed over the specified time period. | ||
apigee_apiproxy_message_count | Traffic | count | The total number of API calls processed by Edge in the specified time period. | ||
apigee_apiproxy_policy_error | Policy Errors | count | The total number of policy errors over the specified time period. | ||
apigee_apiproxy_request_processing_latency | Request Processing Latency | milliseconds | The amount of time (average, minimum, or maximum), in milliseconds, that it takes Edge to process incoming requests. | ||
apigee_apiproxy_request_size | Request Size | bytes | The size of the request payload received by Edge, in bytes. | ||
apigee_apiproxy_response_processing_latency | Response Processing Latency | milliseconds | The amount of time (average, minimum, or maximum), in milliseconds, that it takes Edge to process API responses. | ||
apigee_apiproxy_response_size | Response Size | bytes | The size of the response payload returned to the client, in bytes. | ||
apigee_apiproxy_target_error | Target Errors | count | The total number of 5xx responses from the target service. These are target service errors not caused by Apigee. | ||
apigee_apiproxy_target_latency | Target Latency | count | Target Latency. | ||
apigee_apiproxy_target_response_time | Target Response Time | milliseconds | The amount of time (sum, average, minimum, or maximum), in milliseconds, for the target server to respond to a call. | ||
apigee_apiproxy_total_latency | Total Latency | count | Total Latency. | ||
apigee_apiproxy_total_response_time | Total Response Time | milliseconds | The amount of time (sum, average, minimum, or maximum), in milliseconds, from when Edge receives a request from a client to when Edge sends the response back to the client. | ||
apigee_apiproxy_tps | Average Transactions per Second | count | The average number of transactions, meaning API proxy requests, per second. |
Configure the Integration
From All Clients, select a client.
Go to Setup > Account.
Select the Integrations and Apps tab.
The Installed Integrations page, where all the installed applications are displayed.
Note: If there are no installed applications, it will navigate to the ADD APP page.Click + ADD on the Installed Integrations page. The Available Integrations and Apps page displays all the available applications along with the newly created application with the version.
Note: You can even search for the application using the search option available. Also you can use the All Categories option to search.Click ADD under Apigee Edge:
In the Add Apigee Edge page, enter your account information:
Property Description Name (required) User-defined, descriptive integration name. User Name (required) Enter user name. Password (required) Enter password. Confirm Password Key (required) Re-enter the password. Account Number (required) Unique number for a tenant. Auth End Point (required) Enter host name for authentication. Single Organization Select this checkbox to discover and monitor against a single organization. Organization Enter required organization name. Click Next.
In the RESOURCE TYPE section, select:
- ALL: All the existing and future resources will be discovered.
- SELECT: You can select one or multiple resources to be discovered.
In the DISCOVERY SCHEDULE section, select Recurrence Pattern to add one of the following patterns:
- Minutes
- Hourly
- Daily
- Weekly
- Monthly
Click Finish.The application is now installed and displayed on the Installed Integration page. Use the search field to find the installed application.
After configuring the integration, the Apigee Edge metrics can be viewed from the Infrastructure page.
Discovery and Monitoring
After configuring the integration, Apigee Edge discovery and monitoring is enabled. The discovered services and metrics can be viewed from the Infrastructure page.
No templates need to be applied on discovered devices. The alerts can be enabled using alert policies.
Once discovery is completed, Apigee Edge Organization, Apigee Edge Environment, Apigee Edge Api Proxy are discovered.