You are viewing a plain text version of this content. The canonical link for it is here.
Posted to kato-commits@incubator.apache.org by sp...@apache.org on 2009/07/24 10:34:44 UTC
svn commit: r797411 -
/incubator/kato/trunk/org.apache.kato/kato.docs/src/docbkx/chapters/Introduction.xml
Author: spoole
Date: Fri Jul 24 10:34:44 2009
New Revision: 797411
URL: http://svn.apache.org/viewvc?rev=797411&view=rev
Log:
updated introduction in spec
Modified:
incubator/kato/trunk/org.apache.kato/kato.docs/src/docbkx/chapters/Introduction.xml
Modified: incubator/kato/trunk/org.apache.kato/kato.docs/src/docbkx/chapters/Introduction.xml
URL: http://svn.apache.org/viewvc/incubator/kato/trunk/org.apache.kato/kato.docs/src/docbkx/chapters/Introduction.xml?rev=797411&r1=797410&r2=797411&view=diff
==============================================================================
--- incubator/kato/trunk/org.apache.kato/kato.docs/src/docbkx/chapters/Introduction.xml (original)
+++ incubator/kato/trunk/org.apache.kato/kato.docs/src/docbkx/chapters/Introduction.xml Fri Jul 24 10:34:44 2009
@@ -11,12 +11,47 @@
<section xml:id="introduction.jsr326">
<title>What is JSR 326?</title>
-
- <para>Places to visit</para>
-
- <para><uri xlink:href="http://cwiki.apache.org/KATO/" xlink:type="simple">Kato Wiki</uri>
+ <para>JSR 326 is intended to be a Java API specification for standardising how and what can be retrieved from the contents of post-mortem artefacts -
+ typically process and JVM dumps.</para><para>Unusually for new APIs, this project will endeavour to encompass the old and the new. A diagnostic solution that only works when users move to the latest release does little to improve diagnosability in the short term. This project will consume existing dump artefacts as well as possible while developing an API that can address the emerging trends in JVM and application directions. The most obvious of these trends are the exploitation of very large heaps, alternative languages and, paradoxically for Java, the increased use of native memory through vehicles such as NIO.</para>
+ </section>
+ <section xml:id="introduction.kato">
+ <title>What is Apache Kato?</title>
+ <para>Project Kato is intended to be the place where the Specification, Reference implementation (RI) and Technology Compatibility Kit (TCK) are openly created. The intention is that the Specification and RI will be developed in tight unison, guided by a user-story-focused approach to ensure that real-world problems drive the project from the beginning.</para>
+ <para>This project is about bringing together people and ideas to create a common, cross industry API, and we can't think of a better place to do that than in Apache.</para>
+ </section>
+
+ <section xml:id="introduction.background">
+ <title>Background</title>
+ <para>Post-mortem versus Live Monitoring: It's worth noting that the term "post mortem" is used loosely. It does not just imply dead Java Virtual Machines and applications; JSR 326 also covers living, breathing applications where the dump artefacts are deliberately produced as part of live monitoring activity. Live monitoring generally means tracing, profiling, debugging, or even bytecode monitoring and diagnosis by agents via the java.lang.instrument API . It can also mean analysis of dumps to look for trends and gather statistics.
+ The live-monitoring diagnostic space is well served except for this last area, which is where JSR 326 can help.
+ IBM developed an API called DTFJ ("Diagnostic Tooling and Framework for Java") as a means of providing its support teams a basis on which to write tools to diagnose Java SDK and Java application faults. It consists of a native JVM-specific component and the DTFJ API, which was written in pure Java.
</para>
+ <para>In 2009 IBM donated the implementation dependent portions of DTFJ to the Apache Kato project</para>
+ </section>
+ <section xml:id="introduction.rationale">
+ <title>Rationale</title>
+ <para>JSR 326 exists because of the widely acknowledged limitations in diagnosing Java application problems after the fact.
+ There are many good ways to understand and diagnose problems while they happen, but few credible or pervasive tools exist for helping resolve problems when all has gone suddenly and horribly wrong.
+ Outside of "live monitoring" there is no standard way to provide diagnostics information, and hence no standard tools.
+ Each tool writer has to figure out how to access the data individually and specifically for each JVM vendor and operating system.
+ This sparsity of tools has meant that users have limited options in diagnosing their own problems, especially unexpected or intermittent failures.
+ Consequently these users turn to the providers of their software to work out what is happening.
+ Application, middleware, and JVM vendors are spending increasing time supporting customers in problem diagnosis. Emerging trends indicate that this is going to get worse.
+ </para><para>
+ Today JVM heap sizes are measured in small numbers of gigabytes, processors on desktops come in twos or fours,
+ and most applications running on a JVM are written in Java. To help analyse problems in these configurations,
+ we use a disparate set of diagnostic tools and artefacts. If the problem can't be reproduced in a debugger,
+ then things quickly get complicated. There are point tools for problems like deadlock analysis or the ubiquitous Java out-of-memory problems,
+ but overall the Java diagnostic tools arena is fragmented and JVM- or OS-specific. Tool writers have to choose their place in this matrix.
+ We want to change that by removing the need for tool writers to make a choice. By enabling tool writers to easily target all the major JVM vendors and operating systems,
+ we expect the number and capability of diagnostic tools to greatly increase.
+ Tomorrow it gets harder; heap sizes hit 100's of gigabytes, processors come packaged in powers of 16, and the JVM commonly executes a wide range of language environments.
+ We can't tackle tomorrow's problems until we have a platform to address today's.
+ </para>
</section>
-
-
+ <section xml:id="introduction.links">
+ <title>Places to visit</title>
+ <para><uri xlink:href="http://cwiki.apache.org/KATO/" xlink:type="simple">Kato Wiki</uri>
+ </para>
+ </section>
</chapter>
\ No newline at end of file