Method and apparatus for accessing instrumentation data from within a managed code environment

• US 20020108102A1
• Filed: 07/06/2001
• Published: 08/08/2002
• Est. Priority Date: 07/10/2000
• Status: Active Grant

• Current Assignee: Microsoft Technology Licensing LLC (Microsoft Corporation)
• Original Assignee: Microsoft Corporation
• Inventors: Grant, Justin, Muhlestein, Travis J., Feuerstein, Corina E., Boshier, Alan G., Palanca, Radu Rares, Horstmann, Markus
• Granted Patent: US 7,627,865 B2
• Time in Patent Office: Days
• US Class Current: 717/124
• CPC Class Codes: G06F 9/449 Object-oriented method invocation or resolution
• CPC Class Codes: G06F 9/541 via adapters, e.g. between incompatible applications

Abstract

An instrumentation client API is provided within a managed code runtime environment for accessing instrumentation data that resides outside of the managed code runtime environment. The instrumentation client API provides access to instrumentation data in a manner that is consistent with the classes and models provided by the runtime environment, raises exceptions in a manner that is compatible with the runtime environment, and is secure. The instrumentation client API wraps, or translates, calls to and from an instrumentation data source external to the runtime environment. The API interacts with an interface provided by the instrumentation data source to provide functionality and connectivity that is not otherwise provided by the instrumentation data source. The API also provides access to instrumentation data in a manner that is consistent with the models and classes provided by the runtime platform. The classes defined by the API return collections and exceptions in a way that is consistent with the managed code runtime platform.

Claims

1. A method for providing access to instrumentation data from within a runtime computing environment, comprising:

providing an instrumentation data access interface within said runtime environment;

receiving a request at said instrumentation data access interface for instrumentation data available outside said runtime environment;

transmitting a request for said instrumentation data to an instrumentation data source external to said runtime environment;

receiving a response to said request to said instrumentation data source;

converting said response to a format that is compatible with said runtime environment; and

responding to said request for instrumentation data with said converted response.

2. The method of claim 1, wherein said instrumentation data access interface comprises an instrumentation client API exposed within said runtime computing environment.

3. The method of claim 2, wherein converting said response comprises converting a component object model object to a management object that is compatible with said runtime computing environment.

4. The method of claim 3, wherein said management object encapsulates the properties of a management object accessible through said instrumentation data source.

5. The method of claim 1, wherein said response comprises an indication that an operation was unsuccessful and wherein said format comprises a management exception object.

6. The method of claim 5, wherein said indication that an operation was unsuccessful comprises error codes.

7. A computer-readable medium comprising instructions which, when executed by a computer, cause the computer to perform the method of any one of claims 1-6.

8. A computer-controlled apparatus capable of performing the method of any one of claims 1-6.

9. A method for accessing instrumentation data from within a runtime computing environment, comprising:

receiving a request to construct a management object comprising said instrumentation data;

in response to said request, querying an instrumentation data access interface within said runtime environment for said instrumentation data;

determining whether said instrumentation data was successfully returned; and

in response to determining that said instrumentation data was successfully returned, constructing said management object and populating said management object with said instrumentation data.

10. The method of claim 9, wherein said request comprises a request to bind a management class to an instance of a management object accessible through a management instrumentation data source.

11. The method of claim 10, wherein said request further comprises a management scope object identifying a namespace associated with said external management object.

12. The method of claim 11, wherein said request further comprises a management path object identifying a path to said external management object.

13. The method of claim 12, wherein said request further comprises a management options object specifying options to be utilized when connecting to said management object.

14. The method of claim 10, further comprising:

throwing a management exception object in response to determining that said instrumentation data was not successfully returned.

15. The method of claim 14, wherein the properties of said management object may be accessed utilizing an indexer.

16. A computer-readable medium comprising instructions which, when executed by a computer, cause the computer to perform the method of any one of claims 9-15.

17. A computer-controlled apparatus capable of performing the method of any one of claims 9-15.