# Patent

## Title
Software debugging recommendations

## Abstract

Software debugging recommendation technique embodiments are presented that generally entails creating a database of characterized software bug descriptions and providing software debugging recommendations from the database in response to a query. This can employ a two-phased approach in the search for similar software bugs. The first is a search phase that takes a query as input and returns a ranked list of software bug descriptions that match the query. These bug descriptions can contain a mix of structured and unstructured data. The second phase is a related-information phase that uses the output of the first phase to retrieve a set of related recommendations such as for people, source files, functions and binaries.

## Background
BACKGROUND
In software development projects, when programmers are assigned a software bug to fix, they typically spend significant time during diagnosis searching for instances from the past where similar bugs have been debugged, analyzed and resolved. They often search through software bug databases, articles from the on-line developer networks, email threads, logs of debugging sessions, crash logs, event traces or other sources, and/or talk to colleagues to find this information. For example, the same software bug or a very similar bug may have been encountered and fixed in another code branch, and a programmer would greatly benefit from knowing this information.
SUMMARY
The software debugging recommendation technique embodiments described herein facilitate the software debugging procedure by automating the search for similar issues from the past. In general, this entails creating a database of characterized software bug descriptions and providing software debugging recommendations from the database in response to a query.
In one implementation, a software bug description database is created by first inputting a software bug description which provides information about a previously resolved or yet to be resolved software bug occurring in a software program. A group of software-specific feature extractors is then employed. Each extractor recognizes and extracts a different feature from the software bug description whenever the feature exists therein. A typed document is generated from the features extracted by the feature extractors, and then transformed into a bag of words. The bag of words is stored in the software bug database. This procedure is then repeated for additional software bug descriptions associated with previously resolved or yet to be resolved software bugs, or both, that occurred in the software program, and that it is desired to include in the database. Once all the software bug descriptions have been processed, a full-text searchable index of the bags of words representing the software bug descriptions in the database is generated.
As for providing software debugging recommendations, in one implementation, a software bug description query is input which provides information about an unresolved software bug occurring in a software program covered in the previously constructed database. The same group of software-specific feature extractors that were used in constructing the database is then employed. Each extractor recognizes and extracts a different feature from the software bug description query if the feature exists therein. A typed document is generated from the features extracted from the software bug description query by the feature extractors, and then transformed into a bag of words. The aforementioned index associated with the software bug database is searched to identify one or more software bug descriptions deemed to be similar to a prescribed degree to the software bug description query. The result of the search is to produce a list of the identified software bug descriptions in the database that are deemed to be similar to the software bug description query.
The software debugging recommendation technique embodiments described herein can also include a second phase. The second phase uses the results of the above-described search to retrieve related contextually relevant information. For example, this information can include a set of recommendations for people, source files, functions and binaries related to the identified software bug descriptions in the database that are deemed to be similar to the software bug description query.
It should also be noted that the foregoing Summary is provided to introduce a selection of concepts, in a simplified form, that are further described below in the Detailed Description. This Summary is not intended to identify key features or essential features of the claimed subject matter, nor is it intended to be used as an aid in determining the scope of the claimed subject matter.



DESCRIPTION OF THE DRAWINGS
The specific features, aspects, and advantages of the disclosure will become better understood with regard to the following description, appended claims, and accompanying drawings where:
FIG. 1 is a diagram depicting an exemplary architectural used for constructing a software bug description database.
FIG. 2 is a flow diagram that generally outlines one implementation of a computer-implemented process for creating a database of characterized software bug descriptions.
FIG. 3 is a diagram depicting an exemplary architectural used for searching a software bug description database to obtain software debugging recommendations.
FIGS. 4A-B depict a flow diagram that generally outlines one implementation of a computer-implemented process for providing software debugging recommendations.
FIG. 5 is an exemplary representation of a portion of a software bug description having structured and unstructured parts.
FIG. 6 is an exemplary representation of a portion of a software bug description that includes several attribute and value combinations.
FIG. 7 is an exemplary specification of a typed document.
FIG. 8 is an example of the Score function and the transformation T using the small ordered list.
FIG. 9 is a diagram depicting an exemplary architectural used for implementing the second phase of the software debugging recommendation technique embodiments described herein which generally retrieves recommendations about people, source files, binaries, and source functions that are relevant to the current query.
FIGS. 10A-B depict a flow diagram that generally outlines one implementation of a computer-implemented process for retrieving recommendations about people, source files, binaries, and source functions that are relevant to the current query.
FIG. 11 is a diagram depicting a simplified example of a relationship graph.
FIG. 12 is a diagram depicting a general purpose computing device constituting an exemplary system for implementing software debugging recommendation technique embodiments described herein.



DETAILED DESCRIPTION
In the following description of software debugging recommendation technique embodiments reference is made to the accompanying drawings which form a part hereof, and in which are shown, by way of illustration, specific embodiments in which the technique may be practiced. It is understood that other embodiments may be utilized and structural changes may be made without departing from the scope of the technique.
1.0 Software Debugging Recommendation
In general, the software debugging recommendation technique embodiments described herein improve the productivity of a debugging procedure by automating the search for similar issues from the past. Knowledge of how a similar software bug was handled previously can be invaluable to a programmer who is attempting to fix a current bug.
Automating the search for similar software bugs encountered in the past, first involves understanding what constitutes a query. In principle, it is desirable to leverage all of the knowledge the user has on the current bug. This information is referred to as the context of the software bug, and can include natural language text, textual rendering of core dumps, debugger output, and so on. For example, the context may include the state of the machine being debugged, information in the current bug report, and information obtained from the user's interaction with the debugger, among other items.
The software debugging recommendation technique embodiments described herein allow a software programmer to express a portion or the entire context of a software bug as the query, and then search through diverse data repositories to greatly improve the productivity of the debugging process. While satisfactory results can be obtained when a programmer employs short queries, the full advantages of the recommendation technique embodiments described herein are realized when large portions (or all) the context of a bug are used as the query. When large portions (or all) of the context are employed, the query can be referred to as a fat query, which could be kilobytes of structured and unstructured data describing the contextual information for the software bug. The use of a fat query allows a programmer to query the data repositories with a single query rather than having to search through each data repository separately using several short query string queries. In addition, combined search results are automatically produced.
As for the aforementioned variegated data repositories, these can contain a mix of structured and unstructured data and provide a diversity of information sources that contain potentially useful information for the user. Examples of data repositories include past bug reports, logs of interactive debugger sessions, information on related source code changes, and information about people who can be consulted.
The software debugging recommendation technique embodiments described herein generally employ a two-phased approach in the search for similar software bugs. The first is a search phase that takes a query as input and returns a ranked list of software bug descriptions that match the query. These bug descriptions (which will be referred to as documents in FIG. 1) can contain a mix of structured and unstructured data. In general, the software bug descriptions can any useful information associated with a software bug such as developer network data, e-mails, debug logs, any software-related document, Information from logs of debugging sessions of previous bugs, and more. The second phase is a related-information phase that uses the output of the first phase to retrieve a set of related recommendations such as people, source files, functions and binaries. These two phases will be described more fully in the sections to follow.
1.1 The First Phase
The first phase of the software debugging recommendation technique embodiments described herein matches software bug descriptions that at are similar to a query software bug description. It is noted that like the software bug descriptions themselves, the software bug query can be any useful information associated with a software bug. Generally, this is accomplished by uniformly representing both queries and information sources as a collection of features, which are then formalized as categorized software bug descriptions (which will be referred to as typed documents in FIG. 1). Typed documents represent software specific structure in a way that it can be transformed to allow the use of generic index and search infrastructures. In general, a typed document is one that is categorized using a type constructor, where the type constructor defines how two instances of such a document are compared. In one implementation, typed documents have a recursive structure with four type constructors: (1) unordered bag of terms; (2) ordered list of terms; (3) weighted terms; and (4) key-value pairs. For example, in one tested implementation, the following four features were employed: (1) bag of interesting words, such as “impersonating”, “exclusive”, “deadlock”, “hang”, “overflow”, “multicore”, and so on (represented as an unordered bag of terms); (2) debug commands issued with their output results from a debugger (represented as bag of key-value pairs), (3) values of attributes such as CURRENT_IRQL, PROCESS_NAME, MODULE_NAME, BUCKET_ID, and so on (represented as bag of key-value pairs), and (4) stack frame (represented as an ordered list of terms). No weighted terms were employed in this example. Features with arbitrary structure are expressed by combining two or more of the foregoing type constructors. It is noted that additional types and transformations can also be defined as desired.
Representing features as typed documents leads to an advantage as it separates the process of defining and extracting software-specific structure from the process of indexing and searching. The former is accomplished with the aid of an expert in the software being considered, but the latter can be done generically from the type structure. It is noted that the aforementioned expert is sometimes referred to as a domain expert.
1.1.1 Software Bug Description Database Construction
Prior to being able to input a software bug query and produce a ranked list of software bug descriptions that match the query, a database of similarly characterized software bug descriptions is first constructed. Referring to FIG. 1, one implementation of a database construction architecture includes a series of documents 100 representing previously known software bugs (which can be resolved and/or yet to be resolved). Each document 100 is input to and analyzed using a group of feature parsers 102. There is one feature parser 102 for each feature (e.g., a call stack) deemed by a domain expert to be indicative of the software being categorized. It is noted that while three feature parsers 102 are shown in FIG. 1, there can be less or more depending on the software. The output of the group of feature parsers is combined to create the aforementioned typed document 104. The typed document is then processed by a transformer 106, which converts it into a bag of words 108. As will be described in more detail later, the transformer 106 operates in such a way as to encode the semantics of the type structure of the typed document. The bag of words 108 generated for each document is then stored in a database 112 after being indexed by an appropriate search engine 110. For example, a search engine based on TF-IDF (Term Frequency and Inverse Document Frequency) would be an appropriate choice.
The foregoing database construction architecture can be realized in one implementation using the following process, as illustrated in FIG. 2. In this exemplary process, a computer (such as one of the computing devices described in the Computing Environment section provided later in this specification) is employed to perform a series of process actions including inputting a software bug description which provides information about a previously resolved or yet to be resolved software bug occurring in a software program of interest (200). A group of software-specific feature extractors designed for the software program is then employed, where each extractor recognizes and extracts a different feature from the software bug description whenever the feature exists therein (202). A typed document is generated from the features extracted by the feature extractors (204), and then transformed into a bag of words (206). The bag of words is stored in a software bug database (208). It is next determined if all the software bug descriptions associated with previously resolved or yet to be resolved software bugs, or both, that occurred in the software program and that it is desired to include in the database, have been processed (210). If not, then process actions (200) through (210) are repeated for each additional software bug description. Once all the software bug descriptions have been processed, a full-text searchable index of the bags of words representing the first-input and additional software bug descriptions in the database is generated (212).
The software bug description database storing a separate bag of words representation for each of the input software bug descriptions (i.e., documents) serves as the source for finding similar software bug descriptions in a search, as will now be described.
1.1.2 Searching
Referring to FIG. 3, in one implementation of a searching architecture, an input query 300 (e.g., a fat query) is processed in a similar manner as the aforementioned documents in that it is first analyzed using a group of feature parsers 302 that are identical to those used to analyze the documents. The output of the feature parsers 302 is combined to produce a typed document 304, which is then processed using the same transform 306 to produce a bag of words 308. The aforementioned search engine 310 is then used to find documents 314 matching the query 300 in the previously-constructed software bug description database 312.
In one embodiment, the matching documents 314 are then each analyzed by a group of customer rankers 316 that are each designed by a domain expert to rank the documents according to a specific feature deemed important. It is noted that while three rankers 316 are shown in FIG. 3, there can be less or more depending on the software. This produces a set of ranked matching documents 318 from each of the custom rankers 316. These lists of ranked documents 318 are combined using a rank combiner 320 and conventional methods to produce a single set of ranked search results 322 of the documents matching the query.
The foregoing searching architecture can be realized in one implementation using the following process, as illustrated in FIGS. 4A-B. In this exemplary process, a computer (such as one of the computing devices described in the Computing Environment section provided later in this specification) is employed to perform a series of process actions including inputting a software bug description query which provides information about an unresolved software bug occurring in a software program covered in the previously constructed database (400). A group of software-specific feature extractors designed for the software program (and which were used in constructing the database) is then employed, where each extractor recognizes and extracts a different feature from the software bug description query whenever the feature exists therein (402). A typed document is generated from the features extracted from the software bug description query by the feature extractors (404), and then transformed into a bag of words (406). The aforementioned index associated with the software bug database is searched to identify one or more software bug descriptions deemed to be similar to a prescribed degree to the software bug description query (408). As described previously, each software bug description in the database provides information about a previously resolved or yet to be resolved software bug occurring in the software program associated with the software bug description query, and each has been transformed into a bag of words in the same manner as the software bug description query. The result of the search is to produce a list of the identified software bug descriptions in the database that are deemed to be similar to the software bug description query (410).
The search results can then be ranked if desired as shown in the exemplary process of FIG. 4B. More particularly, a group of custom rankers is employed, where each ranker reviews each of the software bug descriptions named in the list of the identified software bug descriptions for instances of a different feature and ranks the descriptions based on the existence of the feature to produce a ranked list of the software bug descriptions (412). The ranked lists of software bug descriptions produced by the group of custom rankers are combined to produce a single ranked list of the descriptions (414). This single ranked list of the software bug descriptions is then output as the results of the search (416).
1.1.3 Features
Consider the exemplary portion of a software bug description illustrated in FIG. 5. This excerpt contains two parts. The first part 500 is natural language text. It mentions that the problem is a “deadlock”, and names an object ObpinitKillMutant, which is a semaphore on which threads are blocked. The second part 502 is an extract from a call stack of one thread. The first part 500 is unstructured and the second part 502 has some structure.
Suppose it is desired to search for similar software bug descriptions in a database. For this purpose, the first and second parts 500, 502 need to be treated differently. The first part 500 can be handled using full text search, since it has no structure. For the second part 502, it is advantageous to match other software bug descriptions whose call stacks are similar to the call stack in FIG. 5. The definition of a “similarity” between stacks is very particular and specific to the software (i.e., domain specific). The actual addresses in the call stack are not important for similarity—thus the first three columns in the stack trace can be ignored. However, two stacks are similar if they have the same functions in the same order. Thus, for the bug description in FIG. 5, the function names such as ObpDecrecmentHandleCount, ZwClose, ObpDestroyHandleProcedure, ExDestroyHandleTable, ObKillProcess, and the order in which they appear, are used for determining similarity with respect to other call stacks.
Sometimes software bug descriptions include several attributes and values, as shown in FIG. 6. In such situations, the association between the attribute and value is useful when determining similarity between two bug reports. For instance, a bug report with an attribute IMAGE_NAME having the value CLASSPNP.SYS is more similar to the bug report in FIG. 6, than another report that has both the terms IMAGE_NAME and CLASSPNP.SYS at different parts of the document, but which are not related together as an attribute-value pair.
Call stacks and image names are just two examples of features in software bug descriptions. There are several other features such as semaphores, mutexes, memory dumps, exceptions, and so on. Each of these has their own software-specific notions of similarity.
1.1.4 Typed Documents and Similarity
An exemplary specification of a typed document is illustrated in FIG. 7. This specification employs a ML-style syntax. A document Doc 700 is one of (1) a null document, (2) base type (integer or string) 702, (3) a bag of named documents (which is an unordered set), or (4) an ordered list of named documents. A named document NamedDoc 704 is either a value of base type or a key-value pair having a key (of base type) and a value (of document type).
It is desired to define and implement a similarity metric between typed documents represented by the type Doc 700. In contrast with typed documents, full-text search can be thought of as implementing a similarity metric between a less expressive type structure, namely a bag of terms. More precisely, a full-text search engine operates over the (impoverished) type structure Doc 706 from FIG. 7. A full-text search engine implements retrieval based on a score function Score:( Doc× Doc)→Int, where Score (Bag(q); Bag(d)) is given by the nested sum ΣtεqΣsεd (if (t=s) then 1 else 0).
Note that the grammar for typed documents forces the occurrence of a key at each level of the recursive type structure. In the description to follow, it is assumed that each key occurs only once in a type definition. Thus, each sub-document of a document can be uniquely scoped using a sequence of keys used to reach the sub-document from the root. A function Score: Doc×Doc→Int is defined that maps a pair of documents to an integer score. Intuitively, Score(q, d) is a measure of the similarity between q and d. The more similar q and d are, the higher the value of Score(q, d). Score is defined inductively over the type structure of its arguments as follows:

Score(Base(q),Base(d))=if(q=d)then 1 else 0  (1)

Score(Bag(q),Bag(d))=ΣsεqΣtεdMatch(s,t)  (2)

Score(Ordered(q),Ordered(d))=Σnε{1,2}ΣtεNGram(q,n)ΣsεNGram(d,n)NGramMatch(s,t,n)  (3)

Thus, if the documents q and d are base type expressions, then Score is defined to be 1 if they are identical and 0 if they are not identical. If the first two arguments to Score are bags of documents, then Score (Bag(q); Bag(d)) is defined to be sum of the scores of matching the elements of q and d. If the first two arguments to Score are ordered lists of documents, then an n-gram of a sequence q is a contiguous sub-sequence of q of length n. NGram(q, n) is set of all n-grams of a sequence q. Accordingly, Score(Ordered(q), Ordered(d)) is the sum of the scores of matching n-grams for q and d. In practice, n-grams are considered for values of n equal to 1 (unigrams) and 2 (bigrams).
An auxiliary function Match: NamedDoc×NamedDoc→Int is defined as follows:

Match(Value(t),Value(t′))=Score(Base(t),Base(t′))  (4)

Match(KeyValuePair(k1,v1),KeyValuePair(k2,v2))=if(k1=k2)then Score(v1,v2)else 0  (5)

NGramMatch(s,t,n)=Πi=1 . . . nMatch(si,ti)  (6)

Thus, Match returns the score of base types if the arguments are values. If the arguments are key-value pairs, Match returns the score between the values of the two documents if the keys are equal, and 0 otherwise.
It is assumed here implicitly that the type structure of the query and document match. For parts of the parse tree that do not match Score is implicitly defined to be 0. For instance, Match(Value(t), KeyValuePair(k, v)) is 0 since it does not match any of the templates given in Eqs. (1)-(6).
In addition to the constructors shown in FIG. 7, queries also allow annotating arbitrary sub-trees with integer weights. That is, queries can contain another constructor WeightedQuery(Int*Doc), and the Score function is extended as:

Score(WeightedQuery(w,q),d)=w×Score(q,d).  (7)

This allows the features to be written in such a way that more weight is given to matching certain parts of the query (such as call stacks).

1.1.5 Transformation

In one implementation of the software debugging recommendation technique embodiments described herein, determining similarity between typed documents is accomplished by leveraging existing search engine technology. In this way, any full-text search engine can be used as a subroutine for indexing and searching typed documents, thereby taking advantage of the enormous amount of progress that has been made in this field over the past decade.
More particularly, a transformation is employed to implement the previously-described score function Score: Doc×Doc→Int using the score function Score:( Doc× Doc)→Int. Given the transformation T: Doc→Doc such that for any two typed documents d1 and d2, Score(T (d1),T (d2)) is equal to Score(d1, d2). Intuitively, T(d) walks the parse tree of the typed document d and transforms every internal node to a bag of words (where each word belongs to the base type). The transformation T is defined as follows:

T(Null)={ }  (8)

T(Base(x))={x}  (9)

T(Bag({v1,v2, . . . , vn}))=®1≦i≦nN(vi)  (10)

(Ordered({v1,v2, . . . , vn}))=®1≦i≦nN(vi)®®1≦i≦(n−1)Join(N(vi),N(v1+1))  (11)

N(Value(x))={x}  (12)

N(KeyValuePair(k,x))=Prefix(k,T(x))  (13)

Prefix(s,X)={s#x|xTMX}  (14)

Join(X,Y)={x#y|xTMX,yTMY}  (15)

x#y=x∘“_$%$_” ∘y, where ∘ denotes string concatenation  (16)

It is noted that even though set notation is used to represent bags of words, these bags differ from sets in that the same element can occur more than once. Thus {a, b, a} is a bag and is identical to {a, a, b}—the ordering of elements is irrelevant. Also note that the symbol ® is used to denote a union operator on bags. Given two bags b1 and b2, b1 ® b2 contains all the elements in b1 together with all the elements in b2. If an element e appears n1 times in b1 and n2 times in b2, then e appears (n1+n2) times in b1 ® b2.
For a document equal to Null, T (Null) is the empty bag denoted by { } as indicated in Eq. (8). For a document of the form Base(x), T (Base(x)) is given by the bag {x}, which contains one element, namely x as indicated in Eq. (9). For a document of the form (Bag({v1, v2, . . . , vn}), T (Bag({v1, v2, . . . , vn})) is given by the union of the bags obtained by transforming each of v1, v2, . . . , vn using N as indicated in Eq. (10). The function N:Name d Doc→ Doc maps named documents to bags of words. If a named document is of the form KeyValuePair(k, x), N(KeyValuePair(k, x)) is obtained by concatenating the prefix k and a character sequence, say “$%$”, to every element in T(x) as indicated in Eq. (13). It is assumed that the special character sequence “$%$” does not appear anywhere in the original typed document. To see the rationale for this prefix operation, recall the definition of Match(KeyValuePair(k1, v1), KeyValuePair(k2, v2), c) from Eq. (5). Match evaluates to 0 if the keys k1 and k2 do not match, and evaluates to Score(v1, v2, c#k1) otherwise. Prefixing k to every element in T(x) has an identical effect during the computation of Score on the transformed document.
For a document of the form (Ordered({v1, v2, . . . , vn})), T (Ordered({v1, v2, . . . , vn})) is given by the union of the bags obtained by transforming each of the unigrams v1, v2, . . . , vn using N, as well as the union of bigrams obtained by joining every successive pair of transformed vi's using the operator Join, as indicated in Eq. (11). The operator Join(X, Y) obtains a cross product of terms in the two bags X and Y, as indicated in Eq. (15). To see the rationale for the join operation recall the definition Score(Ordered(q), Ordered(d), c) from Eq. (3). Note that the definition of Score(Ordered(q), Ordered(d), c) sums up the scores of all matching unigrams and bigrams of q and d.
Score and Score can be related using a inductively provable theorem that for any two typed documents q and d, Score(q, d) is equal to Score(T(q),T(d)). More particularly, this theorem can be established by induction over the type structure of typed documents using the following example. Consider a section of the call stack from FIG. 5. The feature parser for a call stack extracts the ordered list Ordered([ntkrnlmp!KiSwapThread, ntkrnlmp?KeWaitForSingleObject, . . . , ntkrnlmp!TerminateProcess]) as a typed document representing the feature. Note that the feature parser trims memory address values and suffixes such as “+x0x1b1” from each stack frame and retains only the function name.
In this example, the Score function and the transformation T will be illustrated using the smaller ordered list shown in FIG. 8. Suppose, there are typed documents representing a query q 800 and two bug descriptions d1 802 and d2 804, as shown in FIG. 8. Score(q, d1, ∫)=3, since q 800 and d1 802 have two matching unigrams, namely [KiSwapThread] and [KeWaitForSingleObject], as well as one matching bigram, namely [KiSwapThread, KeWaitForSingleObject]. In addition, Score(q, d2, ∫)=2, since q 800 and d2 804 have two matching unigrams—namely [KiSwapThread] and [IopAcquireFileObjectLock]. This matches the intent that q 800 is more similar to d1 802 than to d2 804 since there are two contiguous function names KiSwapThread and KeWaitForSingleObject that match between q and d1. On the other hand, if q, d1 and d2 are instead treated as bags of words, then Score(q, d1, ∫)=Score(q, d2, ∫)=2, and the ordering and sequencing of words will not be taken into account.
FIG. 8 also shows the values of T(q) 806, T(d1) 808 and T(d2) 810. Assuming a constant inverse document frequency (IDF) of 1, Score(T (q),T (d1))=3 since T(q) 806 and T(d1) 808 have three terms in common, namely KiSwapThread, KeWaitForSingleObject, and KiSwapThread_$%$_KeWaitForSingleObject. Additionally, Score(T (q),T (d2))=2 since T(q) 806 and T(d2) 810 have two terms in common, namely KiSwapThread, and IopAcquireFileObjectLock. Recalling the values of Score(q, d1, ∫) and Score(q, d2, ∫) it is noted that Score(q, d1, ∫)= Score(T (q),T (d1))=3, and Score(q, d2, ∫)= Score(T (q),T (d2))=2.
1.1.6 Term Frequency and Inverse Document Frequency
It is noted that in the foregoing description of Score and Score matches among all terms are weighted equally. However, in practice, search engines often weight terms in a manner inversely proportional to the frequency with which they occur in the corpus. This has the effect of weighting matches on infrequently occurring terms higher than matches on frequently occurring terms. More particularly, Score(Bag(q), Bag(d)) is given by the nested sum Σtεq Σsεd (if (t=s) then IDF(t) else 0). Here, note that IDF(t) is equal to




  
    log
    ⁢
    
      N
      
        DF
        ⁡
        
          (
          t
          )
        
      
    
  
  ,




where N is the number of documents in the corpus and DF(t) is the number of times term t appears in the corpus.

1.1.7 Implementation Details

In one implementation of the software debugging recommendation technique embodiments described herein, T is accomplished in the C# programming language using a visitor that walks over the parse tree of features (see the transform elements 106 and 306 of FIGS. 1 and 3). The software bug descriptions (i.e., documents) come from a variety of sources. There are two kinds of documents that are indexed for the first phase—namely: (1) software bug records from the software bug databases, and (2) debug logs produced from actual debugging sessions.
1.2 The Second Phase
The first phase generally involved using typed documents to represent structure in fat queries and documents (bug descriptions and associated data). These typed documents are used to encode software-specific similarity information and are generically transformed into bags of words so that they can be indexed and searched using existing search engines. The result of the first phase is a list of software bug descriptions that match a query software bug description. In the second phase, which will now be described, probabilistic inference is used to generate a ranked list of people, source files, functions and binaries related to the aforementioned query. While the second phase is optional, it is believed that the additional information over and above the similar software bug descriptions found in the first phase will aid the programmer in resolving a current software bug.
The aforementioned second phase of the software debugging recommendation technique embodiments described herein generally retrieves recommendations about people, source files, binaries, and source functions that are relevant to the current query, by analyzing relationships between these entities. For instance, referring the exemplary architecture depicted in FIG. 9, in the case of a previously resolved software bug, in one implementation it is possible to discover the version control revision that was made to fix the bug from a version control database 900. It is also possible to find out which lines of code were changed to fix the bug, which functions and which binaries were changed, and who made the change from a software bug database 902. A relationship graph tool 904 uses this information to produce a relationship graph 906, which relates elements in bug descriptions, source files, functions, binaries and people. Starting with a “seed” set of software bug descriptions 908 from the first phase, a link analyzer 910 is employed and a ranked list 912 of people, files, binaries and functions related to the seed set is retrieved. Probabilistic inference using factor graphs provides a way to do the foregoing link analysis over large relationship graphs and obtain a ranked list of people, bugs, binaries, and functions that are most closely related to the seeds.
The foregoing database construction architecture can be realized in one implementation using the following process, as illustrated in FIGS. 10A-B. In this exemplary process, a computer (such as one of the computing devices described in the Computing Environment section provided later in this specification) is employed to perform a series of process actions including inputting a software bug description which provides information about a previously resolved or yet to be resolved software bug occurring in a software program of interest (1000). A group of software-specific feature extractors designed for the software program is then employed, where each extractor recognizes and extracts a different feature from the software bug description whenever the feature exists in the software bug description (1002). A typed document is generated from the features extracted by the feature extractors (1004), and then transformed into a bag of words (1006). The bag of words is stored in a software bug database (1008). It is next determined if all the software bug descriptions associated with previously resolved or yet to be resolved software bugs, or both, that occurred in the software program and that it is desired to include in the database, have been processed (1010). If not, then process actions (1000) through (1010) are repeated for each additional software bug description. Once all the software bug descriptions have been processed, a full-text searchable index of the bags of words representing the first-input and additional software bug descriptions in the database is generated (1012). In addition, contextually relevant information is input about each of the first-input and additional software bug descriptions (1014). This contextually relevant information is used to build a relationship model, which relates the first-input and additional software bug descriptions to the contextually relevant information (1016). As indicated previously, this contextually relevant information can include at least one of:

    (i) the identity of a version control revision of the software that includes a change which resolved the software bug; or
    (ii) the identity of a line or lines of code of the software program changed to resolve the software bug; or
    (iii) the identity of a function or functions of the software program changed to resolve the software bug; or
    (iv) the identity of a binary or binaries of the software program changed to resolve the software bug; or
    (v) the identity of an entity or entities (e.g. person, company, group and so on) responsible for changing the software program to resolve the software bug associated with the software bug description; or
    (vi) the identity of a document or documents pertaining to a resolution of the software bug associated with the software bug description (such as developer network pages, and so on).


In view of the foregoing, the results from the first phase can be thought as an “expansion” of the original query, and the second phase aims to leverage information from the expanded query to infer related entities. The benefit of this query expansion can be quite significant, because often the raw query (say just a stack trace from a machine being debugged) matches a set of related bugs and these bugs may have a number of explicit links to related entities. In this way, relationships can be found that can be used to resolve the query software bug. For example, consider the relationship graph shown in FIG. 11. In this graph, there are 5 software bug descriptions 1100-1108 (b1, b2, b3, b4 and b5, respectively); and 4 people 1110-1116 (Gopal, Sriram, Vipin and Hongkang, respectively); and 4 binaries 1118-1124 (p1.dll, p2.dll, p3.dll and p 4.dll, respectively). Now, suppose a set of bugs {b2, b5 } is returned from a query in the first phase. In the second phase these bugs are used as “seeds” to find people and binaries related to the bugs. Note that in the example of FIG. 11, the person Vipin 1114 is related to software bug descriptions b2 1102 and b5 1108, and that the binaries {p1.dll, p2.dll, p3.dll} 1118-1122 are related to {b2, b5}. Further, since Hongkang 1116 is related to the binaries {p1.dll, p2.dll, p3.dll} 1118-1122, it is possible to infer that Hongkang is related to the software bugs {b2, b5} 1102 and 1108 as well. Thus, {Vipin, Hongkang} 1114 and 1116 can be inferred to be a set of people related to the bugs {b2, b5} 1102 and 1108.
More particularly, the second phase of the software debugging recommendation technique embodiments described herein involves performing transitive closure on a relationship graph starting with the set of bugs found in the first phase in order to retrieve a ranked list or related entities. In one implementation, the relationship graph is a weighted multi-partite graph G=V,E, where the set V of vertices is partitioned into n mutually disjoint partitions {V1, V2, . . . , Vn}, such that EV×V×Nat (where Nat is a natural number specifying the weight (i.e., strength) of the edge) contains only edges between two vertices in different partitions. That is, if s,t,wεE, and sTM Vi and tTM Vj, then i≠j. The third component of the edge w is a weight, a natural number, which is a measure of the relationship from s to t—the larger the weight, the tighter the relationship.
The vertices of the relationship graph have one partition Vbugs for software bug descriptions (this includes bug reports as well as logs from interactive debugging sessions), one partition for Vfiles, one partition Vfunctions for functions, and one partition Vpeople for people.
Any appropriate relationship graph tool can be employed to build the aforementioned relationship graph. For example, an appropriate tool is the BCT relationship graph tool. This tool is used to build the relationship graph from various data repositories. For every resolved bug in the bug database, BCT looks for check-ins in source code version control that are associated with fixing the bug, and computes functions and source files that were changed to fix the bug, and the people who made those changes. BCT creates relationship links between these entities using such an analysis. The output of the first phase, R1, is a set of software bug descriptions that are highly related to the query. That is R1Vbugs. In the second phase R1 is used as a starting point to perform link analysis on the relationship graph and compute a 4-tuple R2=vbugs, vfiles, vfunctions,vpeople, where vbugsVbugs, vfilesVfiles, vfunctionsVfunctions, vpeopleVpeople.
The second phase attempts to identify vertices R2 in the relationship graph that are most correlated with the vertices R1 that are produced by the first phase. Formally, a relationship graph can be viewed as a Markov chain with |V| vertices, and a |V|×|V| transition probability matrix each of whose entries lies in the interval [0, 1]. The transition probabilities are obtained by normalizing edge weights of the relationship graph such that the sum of the normalized edge weights going out of each vertex is 1. It is desired to compute the steady state probability distribution over the vertices of the Markov chain for a random walk starting at vertices R1, and return the vertices with large steady state probabilities in each of the vertex partitions as the result R2 of the second phase. In one implementation, factor graphs are used to compute these steady state probabilities. To this end, one Bernoulli random variable is associated with each vertex in V. The random variable for each element in R1 is set to an initial distribution where the variable takes a value 1 with probability 0.9 and 0 with probability 0.1. All the other random variables (associated with vertices in V\R1) are set to have an initial distribution where the variable takes a value 1 with probability 0.5 and 0 with a probability 0.5. For every edge e=u,v,w which associates verities u and v with weight w, a factor Fe (a probabilistic constraint) which constrains the joint probability distribution of the random variables Xu and Xv associated with u and v. The constraint Fe states that Xu and Xv take the same value with probability p and different values with probability 1−p. The value of the parameter p depends on the weight w (normalized with the weights of other edges connected to u and v). Factor graph inference is then used to compute the posteriori probabilities of each random variable, and choose the random variables with highest posteriori probabilities for result set R2.
2.0 The Computing Environment
A brief, general description of a suitable computing environment in which portions of the software debugging recommendation technique embodiments described herein may be implemented will now be described. The technique embodiments are operational with numerous general purpose or special purpose computing system environments or configurations. Examples of well known computing systems, environments, and/or configurations that may be suitable include, but are not limited to, personal computers, server computers, hand-held or laptop devices, multiprocessor systems, microprocessor-based systems, set top boxes, programmable consumer electronics, network PCs, minicomputers, mainframe computers, distributed computing environments that include any of the above systems or devices, and the like.
FIG. 12 illustrates an example of a suitable computing system environment. The computing system environment is only one example of a suitable computing environment and is not intended to suggest any limitation as to the scope of use or functionality of software debugging recommendation technique embodiments described herein. Neither should the computing environment be interpreted as having any dependency or requirement relating to any one or combination of components illustrated in the exemplary operating environment. With reference to FIG. 12, an exemplary system for implementing the embodiments described herein includes a computing device, such as computing device 10. In its most basic configuration, computing device 10 typically includes at least one processing unit 12 and memory 14. Depending on the exact configuration and type of computing device, memory 14 may be volatile (such as RAM), non-volatile (such as ROM, flash memory, etc.) or some combination of the two. This most basic configuration is illustrated in FIG. 12 by dashed line 16. Additionally, device 10 may also have additional features/functionality. For example, device 10 may also include additional storage (removable and/or non-removable) including, but not limited to, magnetic or optical disks or tape. Such additional storage is illustrated in FIG. 12 by removable storage 18 and non-removable storage 20. Computer storage media includes volatile and nonvolatile, removable and non-removable media implemented in any method or technology for storage of information such as computer readable instructions, data structures, program modules or other data. Memory 14, removable storage 18 and non-removable storage 20 are all examples of computer storage media. Computer storage media includes, but is not limited to, RAM, ROM, EEPROM, flash memory or other memory technology, CD-ROM, digital versatile disks (DVD) or other optical storage, magnetic cassettes, magnetic tape, magnetic disk storage or other magnetic storage devices, or any other medium which can be used to store the desired information and which can accessed by device 10. Any such computer storage media may be part of device 10.
Device 10 may also contain communications connection(s) 22 that allow the device to communicate with other devices. Device 10 may also have input device(s) 24 such as keyboard, mouse, pen, voice input device, touch input device, camera, etc. Output device(s) 26 such as a display, speakers, printer, etc. may also be included. All these devices are well know in the art and need not be discussed at length here.
The software debugging recommendation technique embodiments described herein may be further described in the general context of computer-executable instructions, such as program modules, being executed by a computing device. Generally, program modules include routines, programs, objects, components, data structures, etc. that perform particular tasks or implement particular abstract data types. The embodiments described herein may also be practiced in distributed computing environments where tasks are performed by remote processing devices that are linked through a communications network. In a distributed computing environment, program modules may be located in both local and remote computer storage media including memory storage devices.
3.0 Other Embodiments
It is noted that any or all of the aforementioned embodiments throughout the description may be used in any combination desired to form additional hybrid embodiments. In addition, although the subject matter has been described in language specific to structural features and/or methodological acts, it is to be understood that the subject matter defined in the appended claims is not necessarily limited to the specific features or acts described above. Rather, the specific features and acts described above are disclosed as example forms of implementing the claims.

## Claims

1. A computer-implemented process for creating a database of characterized software bug descriptions, comprising:
using a computer to perform the following process actions:
(a) inputting a software bug description which provides information about a previously resolved or yet to be resolved software bug occurring in a software program, and which comprises more than the software code associated with a software bug;
(b) employing a group of software-specific feature extractors designed for said software program, wherein each extractor recognizes and extracts a different feature from the software bug description, and wherein said software-specific feature extractors recognize and extract features which comprise more than the software code associated with the software bug;
(c) generating a typed document comprising features extracted from the software bug description;
(d) transforming the typed document into a bag of words, wherein order of the extracted features of the typed document in the bag of words is irrelevant and a bag of words having extracted features exhibiting a first order is equivalent to a bag of words having the same extracted features in a different order;
(e) storing the bag of words in a database;
(f) repeating actions (a)-(e) for a plurality of additional software bug descriptions associated with previously resolved or yet to be resolved software bugs, or both, that occurred in said software program; and
(g) generating a full-text searchable index of the bags of words representing the first-input and additional software bug descriptions in the database.

2. The process of claim 1, wherein the process action of generating a typed document comprises generating a typed document wherein the extracted features are represented by one or more type constructors.

3. The process of claim 2, wherein each type constructor comprises one of an unordered bag of terms, or an ordered list of terms, or weighted terms, or key-value pairs.

4. The process of claim 1, wherein the process action of generating a full-text searchable index of the bags of words representing the first-input and additional software bug descriptions in the database, comprises the action of employing a Term Frequency and Inverse Document Frequency (TF-IDF) search engine to generate the index.

5. The process of claim 1, wherein said software bug descriptions each comprise structured and unstructured data.

6. The process of claim 5, wherein said structured and unstructured data comprises one or more of the following items: natural language text; or textual rendering of core dumps; or debugger output; or a state of the computer on which the software being debugged resides; or information in a current software bug report; or information obtained from a user's interaction with a debugger.

7. A computer-implemented process for providing software debugging recommendations, comprising:
using a computer to perform the following process actions:
inputting a software bug description query which provides information about a unresolved software bug occurring in a software program, and which comprises more than the software code associated with a software bug;
employing a group of software-specific feature extractors designed for said software program, wherein each extractor recognizes and extracts a different feature from the software bug description query , and wherein said software-specific feature extractors recognize and extract features which comprise more than the software code associated with the software bug;
generating a typed document comprising features extracted from the software bug description query;
transforming the typed document into a bag of words, wherein order of the extracted features of the typed document in the bag of words is irrelevant and a bag of words having extracted features exhibiting a first order is equivalent to a bag of words having the same extracted features in a different order;
searching an index associated with a database to identify one or more software bug descriptions deemed to be similar to a prescribed degree to the software bug description query, wherein each software bug description in the database comprises structured and unstructured data which provides information about a previously resolved or yet to be resolved software bug occurring in the software program associated with the software bug description query and which comprises more than the software code associated with a software bug, and each of which has been transformed into a bag of words in the same manner as the software bug description query; and
producing a list of the identified software bug descriptions in the database that are deemed to be similar to the prescribed degree to the software bug description query.

8. The process of claim 7, further comprising the actions of:
employing a group of custom rankers, wherein each ranker reviews each of the software bug descriptions named in the list of the identified software bug descriptions that are deemed to be similar to the prescribed degree to the software bug description query for instances of a different feature and ranking the descriptions based on the existence of said feature to produce a ranked list of said software bug descriptions;
combining the ranked lists of software bug descriptions produced by the group of custom rankers to produce a single ranked list of the software bug descriptions;
outputting the single ranked list of the software bug descriptions.

9. The process of claim 7, wherein the process action of searching an index associated with a database, comprises the action of employing a Term Frequency and Inverse Document Frequency (TF-IDF) search engine to perform the searching.

10. The process of claim 7, wherein said software bug description query comprises structured and unstructured data.

11. The process of claim 10, wherein said structured and unstructured data comprises one or more of the following items: natural language text; or textual rendering of core dumps; or debugger output; or a state of the computer on which the software being debugged resides; or information in a current software bug report; or information obtained from a user's interaction with a debugger.

12. The process of claim 10, wherein said structured and unstructured data associated with said software bug description query represents all the data available to a user concerning a current software bug.

13. A computer-implemented process for creating a database of characterized software bug descriptions and providing software debugging recommendations, comprising:
using a computer to perform the following process actions:
(a) inputting a software bug description comprising structured and unstructured data, which provides information about a previously resolved or yet to be resolved software bug occurring in a software program, and which comprises more than the software code associated with a software bug;
(b) employing a group of software-specific feature extractors designed for said software program, wherein each extractor recognizes and extracts a different feature from the software bug description, and wherein said software-specific feature extractors recognize and extract features which comprise more than the software code associated with the software bug;
(c) generating a typed document comprising features extracted from the software bug description;
(d) transforming the typed document into a bag of words, wherein order of the extracted features of the typed document in the bag of words is irrelevant and a bag of words having extracted features exhibiting a first order is equivalent to a bag of words having the same extracted features in a different order;
(e) storing the bag of words in a database;
(f) repeating actions (a)-(e) for a plurality of additional software bug descriptions associated with previously resolved or yet to be resolved software bugs that occurred in said software program;
(g) generating a full-text searchable index of the bags of words representing the first-input and additional software bug descriptions in the database;
(h) inputting contextually relevant information about each of the first-input and additional software bug descriptions; and
(i) building a relationship model which relates the first-input and additional software bug descriptions to said contextually relevant information.

14. The process of claim 13, wherein the contextually relevant information comprises for each resolved software bug description, at least one of:
an identity of a version control revision of the software that includes a change which resolved the software bug associated with the software bug description; or
an identity of a line or lines of code of the software program changed to resolve the software bug associated with the software bug description; or
an identity of a function or functions of the software program changed to resolve the software bug associated with the software bug description; or
an identity of a binary or binaries of the software program changed to resolve the software bug associated with the software bug description; or
an identity of an entity or entities responsible for changing the software program to resolve the software bug associated with the software bug description; or
an identity of a document or documents pertaining to a resolution of the software bug associated with the software bug description.

15. The process of claim 13, wherein the contextually relevant information comprises for each yet to be resolved software bug description, an identity of an entity or entities tasked to resolve the software bug associated with the software bug description.

16. The process of claim 13, further comprising the actions of:
inputting a software bug description query comprising structured and unstructured data, which provides information about a unresolved software bug occurring in said software program;
employing said group of software-specific feature extractors to recognize and extract features from the software bug description query;
generating a typed document comprising the features extracted from the software bug description query;
transforming the typed document into a bag of words;
searching an index associated with a database to identify one or more software bug descriptions deemed to be similar to a prescribed degree to the software bug description query; and
outputting a list of the identified software bug descriptions in the database that are deemed to be similar to the prescribed degree to the software bug description query.

17. The process of claim 16, further comprising the actions of:
for each of the identified software bug descriptions in the database that are deemed to be similar to the prescribed degree to the software bug description query,
performing a link analysis on the relationship model to identify contextually relevant information associated with the software bug description under consideration, and
outputting the identified contextually relevant information associated with the software bug description under consideration.

18. The process of claim 17, wherein the relationship model is a weighted multipartite relationship graph, and wherein the process action of performing the link analysis on the relationship model, comprises an action of performing a random walk technique to identify associations between ones of items of the contextually relevant information and ones of the software bug descriptions that exceed a prescribed probability level based on the graph weights.

19. The process of claim 18, wherein association probabilities are computed using a factor graph method.

20. The process of claim 19, further comprising an action of ranking the identified associations based on the computed association probabilities.